エージェント統合
ローカライゼーションを自動処理する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コーディングエージェントによってサポートされています。
i1n setup-ai
# Generates:
# .cursor/rules/i1n.mdc
# CLAUDE.md
# .windsurfrules
# .github/copilot-instructions.md
# AGENTS.md {
"mcpServers": {
"i1n": {
"command": "npx",
"args": ["i1n", "mcp"]
}
}
}