ドキュメント エージェント統合

エージェント統合

ローカライゼーションを自動処理するAIコーディングエージェント(Cursor、Claude Code、Windsurf、GitHub Copilot、Codex)を設定し、ネイティブMCP統合を含めます。

概要

i1nは、エージェント時代のために構築された初のローカライゼーションツールです。AIコーディングエージェントとは、エージェントにプロジェクトのi18n規約を教えるコンテキストルールと、エージェントがi1nコマンドを直接実行できるネイティブMCPサーバーの2つのレベルで統合されます。

設定が完了すると、エージェントはハードコーディングされた文字列の代わりに自動的に翻訳キーを使用し、キーを正しい名前空間ファイルに配置し、補間変数を保持し、IDEを離れることなくプッシュ、翻訳、プルできるようになります。

コンテキストルール(setup-ai)

i1nは、Cursor(.cursor/rules/i1n.mdc)、Claude Code(CLAUDE.md)、Windsurf(.windsurfrules)、GitHub Copilot(.github/copilot-instructions.md)、Codex(AGENTS.md)、Antigravity(.antigravity/rules.md)のコンテキストルールを生成します。

各ルールファイルは、エージェント固有の形式と機能に合わせて調整されます。i1n setup-ai を実行して、すべてのファイルを一度に生成してください。

MCPサーバー

i1nには、AIコーディングアシスタントに7つのツールを提供するネイティブのModel Context Protocol (MCP)サーバーが含まれています。`i1n mcp`で起動し、エディタを接続するように設定してください。Claude Codeの場合: `claude mcp add i1n -- npx i1n mcp`。Cursorの場合: `.cursor/mcp.json`に追加します。

利用可能なMCPツール:i1n_status(プロジェクトのステータスと制限)、i1n_push(ローカルファイルのプッシュ)、i1n_pull(翻訳のプルと型の生成)、i1n_translate(指定言語へのAI翻訳)、i1n_add_language(新しい言語の追加)、i1n_extract_and_translate(文字列の抽出、プッシュ、翻訳、型の生成を1ステップで実行)、i1n_search(既存の翻訳キーの検索)。

究極のワークフロー:数秒で国際化

際立った機能はi1n_extract_and_translateです。エージェントに「このコンポーネントを国際化してください」と指示してください。エージェントはファイルを読み込み、ハードコードされた文字列を特定し、抽出されたキーと値のペアでMCPツールを呼び出します。i1nがすべてを処理します:キーのプッシュ、すべてのアクティブな言語への翻訳、TypeScript定義の再生成。その後、エージェントはコードをt()呼び出しで書き換えます。

文字列の抽出、JSONエントリの作成、翻訳、型の更新といった、従来60分かかっていたタスクが30秒で完了します。このワークフローは、Cursor、Claude Code、Windsurf、およびMCP互換のアシスタントで動作します。

エージェントベースのワークフロー

エージェントに「通知設定を含む設定ページを追加します。スペイン語と日本語に翻訳してください。」のようなタスクを与えます。エージェントは適切な翻訳キーを持つコンポーネントを作成し、MCPツールを使用するか、i1n push --translate es,ja を実行します。

キー作成からAI翻訳まで、ローカライズプロセス全体が手動介入なしで実行されます。このワークフローは、コンテキストルールとMCP統合の両方を通じて、すべての主要なAIコーディングエージェントによってサポートされています。

terminal
i1n setup-ai
# Generates:
# .cursor/rules/i1n.mdc
# CLAUDE.md
# .windsurfrules
# .github/copilot-instructions.md
# AGENTS.md
.mcp.json
{
  "mcpServers": {
    "i1n": {
      "command": "npx",
      "args": ["i1n", "mcp"]
    }
  }
}

関連