AIローカリゼーションエージェント

AIエージェントをai-l10n MCPサーバーに接続すると、プロフェッショナルなローカリゼーションツールに変わります。i18nファイルの生のコンテンツをコンテキストに貼り付ける代わりに、エージェントが専用の翻訳エンジンとしてl10n.devを呼び出します。これにより、フォーマットの保証、永続的な用語集、カスタムスタイル指示、トークン効率的な出力が可能になります。

なぜAIエージェントをローカリゼーションMCPに接続するのか？

i18nファイルをチャットに貼り付けるという単純なアプローチでは、すぐに限界が来ます。エージェントがプロフェッショナルなローカリゼーションエンジンを使用すると、何が変わるのでしょうか：

• 大容量ファイルはサーバー側で処理されるため、エージェントが生のファイルコンテンツをコンテキストウィンドウに読み込む必要はありません。
• フォーマット保持が保証され、プレースホルダー、キー、構造は翻訳後もそのまま維持され、呼び出しごとに検証されます。
• 永続的な用語集により、すべてのファイル、すべてのチャンク、そして将来のすべてのセッションを通じて、用語が一貫して保たれます。
• トークン効率的で、エージェントはファイルパスのみを送信し、メタデータのみが返されます。
• 増分更新により、新規または変更された文字列のみが翻訳され、既存の翻訳が保護されます。
• プロダクション対応の出力で、事後編集は不要です。

AIエージェントのためのプロフェッショナルなローカリゼーション機能

ai-l10n MCPサーバーは、AIエージェント単体では再現できない機能を追加します：

📖 AI用語集を生成

翻訳前に、ソースコンテンツから用語集を生成するようエージェントに依頼してください。用語集はl10n.devアカウントに保存され、その後のすべてのファイルとチャンクに自動的に適用されるため、アプリケーション全体で用語の一貫性が無期限に保たれます。

✏️ カスタムスタイル＆トーンルール

言語ペアごとに言語的な指示を作成します。例えば、「ラテンアメリカスペイン語をターゲットにしたカジュアルなトーンを使用」や「ブランド用語は常に英語のままにする」などです。指示はアカウントに永続的に保存され、セッションごとに繰り返す必要なく、翻訳呼び出しのたびに自動的に適用されます。

💾 トークン効率的な翻訳

MCPがない場合、大きなi18nファイルを翻訳するにはファイル全体をエージェントのコンテキストウィンドウに読み込む必要があり、コストがかかり、切り捨てられることもよくあります。MCPを使用すると、エージェントはファイルパスのみを送信し、メタデータのみを受け取ります。翻訳全体がサーバー側で処理されるため、コンテキストウィンドウを空けておくことができます。

🛡️ フォーマット保持が保証

サーバーは、翻訳のたびに出力フォーマットがソースと一致することを検証します。JSON構造、Flutter ARBメタデータ、YAMLキー、POカタログ、XLIFFセグメント、およびすべてのプレースホルダー構文を保持します。検証は結果が返される前にサーバー側で行われます。

⚡ 増分更新

ハッシュベースの変更検出を有効にして、すでに翻訳済みの文字列をスキップします。新規または変更された文字列のみが翻訳のために送信されるため、無料文字数を節約し、既存の翻訳が上書きされるのを防ぎます。

はじめに

APIキーを取得

無料アカウントを作成し、APIキーを以下から取得してください：l10n.dev/ws/api-keys。キーをエージェント設定の環境変数として設定する（以下を参照）か、l10n_set_api_keyツールを使用して一度だけ保存するようエージェントに依頼してください。これにより、~/.ai-l10n/config.jsonに保存され、自動的に使用されます。

AIエージェントの構成

以下からエージェントを選択し、MCPサーバー構成を追加してください。すべてのエージェントが同じnpmパッケージを使用しますが、構成フォーマットのみが異なります。

Claude Desktop

設定（Settings）→ 開発者（Developer）→ 設定を編集（Edit Config）を開きます。Claude Desktopがインストール環境に適したMCP設定ファイルを開きます。l10nサーバーブロックを追加してください：

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Cursorの「カスタマイズ（Customize）」からMCPサーバーを管理するか、手動で設定を追加してください。ユーザー全体の設定には~/.cursor/mcp.jsonを、プロジェクト固有の設定にはプロジェクト内の.cursor/mcp.jsonを使用します：

{
  "mcpServers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

CascadeのMCPパネルを開くか、Devin設定（Devin Settings）→ Cascade → MCPサーバー（MCP Servers）に移動してください。手動設定の場合は、~/.codeium/windsurf/mcp_config.jsonを編集してください：

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

GitHub Copilot (VS Code)

コマンドパレットを開き、MCP: ユーザー設定を開く（MCP: Open User Configuration）を選択するか、ワークスペースに.vscode/mcp.jsonファイルを作成してください：

{
  "servers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenAI Codex

ユーザー全体の設定には~/.codex/config.tomlに、信頼されたプロジェクトには.codex/config.tomlに追加してください：

[mcp_servers.l10n]
command = "npx"
args = ["-y", "ai-l10n-mcp"]

[mcp_servers.l10n.env]
L10N_API_KEY = "your-api-key-here"

またはターミナルから直接追加してください：

codex mcp add l10n --env L10N_API_KEY=your-api-key-here -- npx -y ai-l10n-mcp

Claude Code

ターミナルからサーバーを追加してください。これはCLIとVS Code拡張機能の両方で機能します：

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

例：AIエージェントによるアプリの翻訳

MCPが接続されると、エージェントは翻訳前に指示と用語集を事前に確認します。「アプリをスペイン語とフランス語に翻訳して」と言ったときの典型的なセッションは以下のようになります：

プロジェクトセットアッププロンプト

MCPには、最適な翻訳品質のために言語的な指示と用語集の確認・構成をエージェントに案内する組み込みのl10n_project_setupプロンプトが含まれています。新しいプロジェクトの開始時や、ローカリゼーション設定を見直すときに実行してください。

"l10n_project_setupプロンプトを実行して" または "このプロジェクト用にl10n.devをセットアップして"

自動化セットアッププロンプト

MCPには、i18nファイルの自動翻訳を構成するようエージェントを案内する組み込みのl10n_automation_setupプロンプトが含まれています。一度実行して今後のすべてのコミットに対する自動翻訳を設定すれば、手動で翻訳をトリガーする必要がなくなります。

"l10n_automation_setupプロンプトを実行して" または "このプロジェクトの自動ローカリゼーションをセットアップして"

ベストプラクティス

• 用語集を使用する： 用語集の生成を有効にするか、既存の用語集を使用してください。AIに既存の用語集をプロジェクトに追加するよう依頼します。これにより、最初の翻訳から用語の一貫性が確保されます。
• 言語ごとにトーンの指示を設定する： 市場によって期待されるトーンは異なります。言語ペアごとに指示を設定してください（ドイツのビジネスソフトウェアにはフォーマルなトーン、スペインの消費者向けアプリにはカジュアルなトーンなど）。
• 更新には増分モードを使用する： ターゲットファイルがすでに存在する場合は、常に増分翻訳を有効にしてください。これにより、現在の翻訳が保護され、無料文字数が節約されます。
• APIキーを安全に保管する： 共有環境やCI/CDセットアップには、エージェントのMCP構成内の環境変数を使用してください。個人的な使用には、l10n_set_api_keyを使用して一度だけ保存するようエージェントに依頼してください。
• プロジェクトセットアッププロンプトを使用する： 各新規プロジェクトの開始時にl10n_project_setupを実行し、翻訳前に指示と用語集が構成されていることを確認してください。
• 自動化セットアッププロンプトを使用する： 手動作業を減らし、リリースをスピードアップします。ai-l10n CLIまたはVS Code拡張機能を使用してi18nファイルの翻訳を自動化してください。これにより、手動で翻訳をトリガーする必要がなくなり、すべてのファイルで一貫したフォーマット、用語集の適用、スタイル指示が保証されます。

AIエージェントにプロフェッショナルなローカリゼーション機能を追加する準備はできましたか？