ドキュメント / ガイド
機械翻訳されたページ
MCP クライアントを接続する
verbatra の stdio MCP サーバーをコーディングエージェントなどの MCP クライアントに組み込みます。プロバイダーの API キーはコミットするファイルに書きません。
コーディングエージェントが、verbatra の stdio MCP サーバー経由で翻訳状況を読み取り、値を修正できるようにします。登録はクライアントごとに 1 回だけです。エントリを 2 つ登録すると、サーバーも 2 つ起動します。必要なものは、verbatra の設定ファイルがあるプロジェクト(npx @verbatra/cli init)と、Node.js ^22.22.0 || >=24 です。
起動コマンドを選ぶ
| コマンド | 必要なもの | .env ファイルを読むか |
|---|---|---|
npx -y @verbatra/mcp | インストール不要 | いいえ |
npx @verbatra/cli mcp | @verbatra/cli と @verbatra/mcp を開発依存関係として導入 | はい:.env.local、次に .env |
npx -y @verbatra/cli mcp は避けてください。CLI は @verbatra/mcp をインストールしないため、終了コード 2 で終了します。サーバーが設定ファイルをどこで探すかは、プロジェクトディレクトリを参照してください。
MCP Registry
公式の MCP Registry にも、io.github.verbatra/verbatra として登録されています。
エージェントに課金を許可するか決める
サーバーは、読み取りとローカルの編集ツールだけで起動します。課金ツールは非表示のままで、API キーを読み取るツールはありません。
まず見積もる
課金の前には、エージェントに translation.estimate を実行し、承認を待つよう、サーバーが引き続き指示します。
Claude Code
init に書き込ませる
プロジェクトルートで、次のコマンドを実行することをおすすめします。
npx @verbatra/cli init --agentinit --agent は、エージェントの指示ファイルを書き込みます。Claude Code が見つかった場合(CLAUDE.md、.claude/、.mcp.json)、またはクライアントがまったく見つからない場合は、課金をオフにした次のエントリも、コミットする .mcp.json に書き込みます。--client claude を指定すると強制できます。
{
"mcpServers": {
"verbatra": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@verbatra/mcp"]
}
}
}Claude Code を再起動し、verbatra サーバーを承認します。サーバーには CLAUDE_ と環境変数が渡されます。1 回のセッションだけ課金を許可するには、API キーを export して次のように実行します。
VERBATRA_MCP_ALLOW_SPEND=1 claude接続は claude mcp list で確認できます。詳しくは Claude Code の MCP ドキュメントを参照してください。
その他の方法
CLI を使わない場合
claude mcp add --transport stdio --scope project verbatra -- npx -y @verbatra/mcpこれで同じエントリが書き込まれます。ここで --env KEY=value を付けないでください。値が .mcp.json に書き込まれてしまいます。
verbatra プラグイン
.mcp.json の代わりに、プラグインを使えます。プラグインには、verbatra のスキル、このサーバー、Claude がロケールファイルを編集した後にそのファイルをチェックするフックがまとめて含まれています。
警告
verbatra プラグインと、.mcp.json の verbatra エントリを併用しないでください。プラグインが 2 つ目のサーバーを持ち込みます。.claude/settings.json または .claude/settings.local.json でプラグインが有効な場合、init --agent はこのエントリを書き込みません。
claude plugin marketplace add verbatra/skills
claude plugin install verbatra@verbatra --scope project- サーバー:バージョンを固定した
@verbatra/mcpで、--cwdに開いているプロジェクトが設定されます。 - 課金:プラグインの
allowSpendオプションをオンにするまでオフです(--config allowSpend=true、または/config)。コミットするファイルでオンにすることはできません。 - API キー:
claudeを起動した環境から読み込まれます。 - フック:プロジェクトの
verbatra check --file <path>を実行し(CLI 0.12.0 以上)、壊れたプレースホルダー、マークアップ、ICU を報告します。プロバイダーは呼び出しません。
詳しくは Claude Code のプラグインリファレンスを参照してください。
Codex
次のコマンドをおすすめします。npx @verbatra/cli init --agent --client codex(.codex/ がある場合は init --agent だけで構いません)を実行すると、課金をオフにした次のテーブルが .codex/config.toml に追記されます。
[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp"]
startup_timeout_sec = 60Codex がこれを読み込むのは、Trust this folder?(このフォルダーを信頼しますか)に答えた後だけです。これにはリポジトリのルートが含まれます。サブフォルダーから起動した場合、サーバーは見つかった設定ファイルの場所をルートにします。詳しくは Codex の MCP ドキュメントを参照してください。
Codex のユーザー設定
課金を許可する場合は、代わりに ~/.codex/config.toml を使います。env_ は変数を名前で渡します。env テーブルや codex mcp add --env は値そのものを保存します。
[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp", "--allow-spend"]
cwd = "/path/to/your/project"
env_vars = ["ANTHROPIC_API_KEY"]Gemini CLI
次のコマンドをおすすめします。npx @verbatra/cli init --agent --client gemini(.gemini/ または GEMINI.md がある場合は init --agent だけで構いません)を実行すると、課金をオフにした次のエントリが .gemini/settings.json に追加されます。
{
"mcpServers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp"]
}
}
}Gemini CLI がこれを読むのは、起動したフォルダーからだけです。プロジェクトルートで gemini を起動し、ダイアログまたは /permissions trust でそのフォルダーを信頼します。trust は未設定のままにしてください。ツールは /mcp で一覧できます。Gemini CLI が読むのは AGENTS.md ではなく GEMINI.md です。設定に "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } を追加するか、GEMINI.md に @AGENTS.md を追加します。詳しくは Gemini CLI の MCP ドキュメントを参照してください。
Gemini CLI のユーザー設定
課金を許可する場合は、ユーザー設定に絶対パスの cwd を指定して使います。
{
"mcpServers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--allow-spend"],
"cwd": "/path/to/your/project",
"env": {
"ANTHROPIC_API_KEY": "$ANTHROPIC_API_KEY"
}
}
}
}Gemini CLI はサーバーに対して API キーの変数を隠すため、API キーは env で渡します。
Cursor
init --agent は、.cursor/ または .cursorrules が見つかった場合や --client cursor を指定した場合に、Cursor の .cursor/mcp.json を書き込みます。
{
"mcpServers": {
"verbatra": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--cwd", "${workspaceFolder}"]
}
}
}課金を許可するには、args に "--allow-spend" を追加し、"env": { "ANTHROPIC_ を加えます。詳しくは Cursor の MCP ドキュメントを参照してください。
VS Code
VS Code(GitHub Copilot のエージェントモード)は、servers をキーとする .vscode/mcp.json を読み込みます。init --agent --client vscode がこれを書き込みます。--client を付けない init --agent は、このファイルがすでにある場合だけ設定を書き込み、.vscode/ フォルダーだけがある場合はコマンドを表示します。--cwd は不要です。
{
"servers": {
"verbatra": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@verbatra/mcp"]
}
}
}課金を許可するには、API キーを入力項目として宣言します。VS Code はこの値をファイルの外に保存します。
{
"inputs": [
{
"type": "promptString",
"id": "anthropic-key",
"description": "Anthropic API key",
"password": true
}
],
"servers": {
"verbatra": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--allow-spend"],
"env": {
"ANTHROPIC_API_KEY": "${input:anthropic-key}"
}
}
}
}ファイルの代わりに、ボタンまたは次のコマンドでユーザープロファイルに追加できます。この場合、課金はオフです。方法は 1 つだけ選び、2 つを併用しないでください。
code --add-mcp '{"name":"verbatra","command":"npx","args":["-y","@verbatra/mcp"]}'詳しくは VS Code の MCP 設定リファレンスを参照してください。
GitHub Copilot
Copilot クラウドエージェント
リポジトリの管理者が、Settings(設定)、Copilot、MCP servers(MCP サーバー)の順に開き、サーバーを追加します。クラウドエージェントは確認なしでツールを呼び出します。そのため、書き込みもプロバイダーの呼び出しもしないツールだけを列挙します。
{
"mcpServers": {
"verbatra": {
"type": "local",
"command": "npx",
"args": ["-y", "@verbatra/mcp"],
"tools": [
"project.snapshot",
"project.doctor",
"status.check",
"status.diff",
"glossary.get",
"lock.state",
"history.list",
"history.keyRevisions",
"key.integrity",
"locale.integrity",
"key.value",
"key.context",
"locale.values",
"translation.estimate",
"review.queue",
"report.provenance",
"usage.summary",
"usage.history"
]
}
}
}translation.editEntry と glossary.write を追加するのは、エージェントに pull request の中で書き込ませたい場合だけにします。review.approve と review.reject は含めないでください。レビューの判断には人が必要です。確認するには、View session(セッションを表示)を開き、Start MCP Servers(MCP サーバーを起動)を展開します。詳しくは Extending the cloud agent with MCP を参照してください。
Copilot CLI
copilot mcp add verbatra -- npx -y @verbatra/mcp --cwd /path/to/your/projectこれで ~/.copilot/mcp-config.json が書き込まれます。Copilot CLI はサーバーに PATH だけを渡します。そのため、API キーはこのエントリの env に書き、プロジェクトのファイルには書きません。詳しくは Adding MCP servers to Copilot CLI を参照してください。
Windsurf
Windsurf は、すべてのプロジェクトで 1 つの mcp_ を読み込みます。そのため、--cwd は絶対パスにします。
{
"mcpServers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
}
}
}課金を許可するには、"--allow-spend" を追加し、"env": { "ANTHROPIC_ を加えます。詳しくは Cascade の MCP ドキュメントを参照してください。
Zed
Zed は設定の context_ を読み込みます。Settings、AI、MCP Servers(MCP サーバー)、Add Server(サーバーを追加)の順に開くと、エントリが書き込まれます。
{
"context_servers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"],
"env": {}
}
}
}env に書いた API キーはそのままの値として保存されます。そのため、API キーと --allow-spend はユーザー設定にだけ追加し、.zed/settings.json には追加しないでください。詳しくは Zed の MCP ドキュメントを参照してください。
JetBrains AI Assistant
Settings、Tools(ツール)、AI Assistant、Model Context Protocol (MCP) の順に開き、サーバーを追加して次の内容を貼り付けます。
{
"mcpServers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp"]
}
}
}Working directory(作業ディレクトリ)にプロジェクトルートを設定し、このエントリは課金なしのままにします。詳しくは AI Assistant の MCP ドキュメントを参照してください。
Claude Desktop
Settings、Developer(開発者)、Edit Config(設定を編集)の順に開くと、claude_ が開きます。プロジェクトという単位がないため、--cwd は絶対パスにします。
{
"mcpServers": {
"verbatra": {
"command": "npx",
"args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
}
}
}課金を許可するには、"--allow-spend" を追加し、"env": { "ANTHROPIC_ を加えてから、Claude Desktop を再起動します。詳しくは Connect to local MCP servers を参照してください。
その他の stdio クライアント
クライアントに、コマンド npx -y @verbatra/mcp を指定します。クライアントがプロジェクトの内側でサーバーを起動しない場合は --cwd /path/to/your/project を、設定ファイルが別の場所にある場合は --config <path> も加えます。--allow-spend と API キーは、クライアントのシークレットの仕組みを通してだけ渡してください。
接続を確認する
エージェントに project.snapshot を呼び出してもらいます。ロケール、フォーマット、プロバイダーが返りますが、プロバイダーは呼び出されません。
configured: false:使用できる設定ファイルが見つかっていません。project.doctorを依頼してから、npx @verbatra/cli initを実行するか、--cwdを修正します。詳しくは設定がない場合を参照してください。- 課金ツールがない:課金の許可スイッチと、プロバイダーが
noneではないかを確認します。 - 設定を編集した場合:再起動は不要です。設定の変更後を参照してください。
関連項目
verbatra mcp:オプションとすべてのツール- JSON で verbatra をスクリプト化する:
verbatra-mcp-toolsスキル