# General Translation Knowledge Base: Cursor や Claude Code でアプリを国際化するには？
URL: https://generaltranslation.com/ja/kb/ai-agent-i18n-setup.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Cursor または Claude Code で General Translation の Setup for Agents プロンプトを使い、機能と対象言語を選んで、エージェントに実装と検証を任せます。ブラウザでのサインイン、機械可読なドキュメント、MCP ツールにより、セットアップから翻訳、レビューまでがシームレスにつながります。継続的なローカライゼーションは、Locadex を使ってプルリクエスト経由で自動化できます。
Category: 国際化
Last updated: 2026-10-21
Authors: Kevin Liu, Kevin Wu
Published: 2026-10-21
「アプリをスペイン語に翻訳して」と指示するだけでは、決めるべきことがいくつも残ります。エージェントは既存のライブラリをそのまま使うべきか。スペイン語には専用の URL が必要か。このセッションが終わった後、新しく追加された文言は誰が翻訳するのか。アプリケーションの編集を依頼する前に、こうした方針を決めておきましょう。
General Translation では、プロジェクトの調査からインテグレーション、翻訳、検証までをコーディングエージェントに順を追って進めさせるセットアッププロンプトを提供しており、継続的にメンテナンスしています。まずは 1 つの機能を動作させ、検証済みのパターンをコードベース全体に展開してください。
## Video
The video is narrated in English, with English captions.
[Can an AI coding agent set up i18n for me?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-ai-agent-i18n-setup.mp4) (46 秒)
General Translation lets your agent set up i18n with the prompt from Setup for Agents. The prompt has the agent run `gt login`, which you approve in your browser, and run `gt init` with a flag for every question, so the command asks nothing. Then it wraps your page in the `T` component, adds a `LocaleSelector`, runs `gt translate`, builds the app and reports what it actually verified.
## Setup for Agents から始める
generaltranslation.com の **Setup for Agents** を使うか、Cursor や Claude Code に[公式のエージェントプロンプト](https://generaltranslation.com/agent-prompt.md)を渡してください。このプロンプトは、エージェントにプロジェクトを調査させ、最新のフレームワーク向け手順に従うよう指示します。サポート対象のプロジェクトでは、[`gt init`](/docs/cli/reference/commands/init) で実験的なフレームワークのセットアップを利用できます。エージェントは生成されたインテグレーションを確認し、コンテンツをマークし、翻訳を生成したうえで、アプリの動作を検証します。
ローカルからサービスにアクセスする場合は、[`gt login`](/docs/cli/reference/commands/login) を使えば、チャットに APIキーを貼り付けなくてもブラウザでサインインを承認できます。ただし、CLI 側で対象のプロジェクトを選択または設定しておく必要があります。セットアップ用のフラグを使うと、対話型ターミナルがなくてもウィザードの質問に回答できますが、初回のサインインには引き続きユーザーの承認が必要です。無人ビルドでは、CI のシークレットストアに保存したスコープ付きの認証情報を使用してください。
エージェントは、[`llms.txt`](https://generaltranslation.com/llms.txt) からドキュメントを見つけたり、ドキュメントの URL の末尾に `.mdx` を付けてクリーンなソースを取得したり、[OpenAPI 仕様](https://generaltranslation.com/openapi.yaml)を参照したりできます。[コーディングエージェントガイド](/docs/overview/for-coding-agents)には、再利用できるプロジェクト向けの指示がまとめられています。これらのリソースは継続的にメンテナンスされているため、セットアップの内容を常に最新の製品 API に合わせられます。こうした検出用のユーザー接点の仕組みについては、[ドキュメント設計に関する記事](/blog/rewriting-our-docs)で解説しています。
## エージェントには範囲を限定したタスクを与える
フレームワーク、インストール済みのバージョン、レンダリングモデル、ルート、既存のi18n設定、ビルドスクリプトを調査するようエージェントに指示します。アプリですでにi18nライブラリを使用している場合は、移行がタスクに含まれていない限り、そのライブラリを引き続き使用します。GTのCLIでは、next-intlやreact-i18nextなど、[サポート対象の既存カタログを翻訳](/docs/cli/guides/generating-translations)できます。
ソース言語、ターゲットロケール、変更対象の機能を指定します。バリデーションメッセージ、プレースホルダー、アクセシビリティ用のラベル、メタデータも対象に含めてください。ローカル配信とCDN配信のどちらを使うかを決め、[ダッシュボードの翻訳エディター](/docs/platform/dashboard/guides/reviewing-translations)で結果をレビューする担当者を指名します。
## General Translation の MCP サーバーに接続する
General Translation がホストする [Model Context Protocol (MCP) サーバー](/docs/overview/for-coding-agents#mcp) を使うと、コーディングエージェントがプロジェクトの最新の設定を確認し、翻訳の文脈を管理できるようになります。エージェントはプロジェクトのロケールを調べたり、共有された用語を参照したり、タスクに応じて用語集の用語やカスタムプロンプトを更新したりできます。これにより、コードの変更を、チームが General Translation で管理している翻訳ルールと連携させることができます。
この接続では、次の操作を行うツールを通じて、翻訳ワークフロー全体をエンドツーエンドでサポートします。
* コンテンツの翻訳、原文ファイルのアップロード、翻訳ジョブのキュー登録、ステータスの確認、結果のダウンロード。
* CDN 上の翻訳の公開および公開の取り消し。
* プロジェクトの検索と作成、および権限がある場合のスコープ付きプロジェクト API キーの作成。
* コンテキストグループ、用語集の用語、カスタムプロンプトの管理。
エージェントには、実行させたいワークフローに必要な権限を付与してください。生成されたキーは保護されたシークレットストアに保管し、チャットやブラウザ側のコードには絶対に含めないでください。翻訳の生成にはこのサービスを使用するため、従量課金の対象となります。アプリのローカルでの抽出から翻訳までの一連の処理は、以下の CLI が担います。
**Cursor** では、既存のエントリを残したまま、プロジェクトの `.cursor/mcp.json` に次のサーバーエントリを追加します。設定や認証のオプションについては、[Cursor の MCP セットアップ](https://cursor.com/docs/mcp)を参照してください。
```json title=".cursor/mcp.json"
{
"mcpServers": {
"generaltranslation": {
"url": "https://api.gtx.dev/mcp"
}
}
}
```
**Claude Code** では、[HTTP トランスポート](https://code.claude.com/docs/en/mcp)を使用して同じサーバーを登録します。
```bash
claude mcp add --transport http generaltranslation https://api.gtx.dev/mcp
```
クライアントの OAuth サインインフローを完了するか、[MCP 認証ガイド](/docs/overview/for-coding-agents#mcp)の説明に従って、クライアントのシークレットヘッダー設定で APIキーを構成してください。Context Management を使用するには、OAuth 経由での Organization Context へのアクセス権、または該当する Context 権限を持つ組織キーが必要です。プロジェクトキーではこれらのツールにアクセスできません。
まずは具体的なリクエストから始めましょう。たとえば「generaltranslation MCP サーバーを使って、私のプロジェクト一覧を表示し、ローカライズ中のプロジェクトのロケール設定を見せて」と依頼します。次に、プロジェクトに割り当てられたコンテキストグループをエージェントに確認させます。コンテキストグループには、共有の用語集の用語とカスタムプロンプトが格納されています。エージェントは機能を準備する際にこれらの用語や指示を活用できるほか、用語やスタイルの変更を依頼した場合にはそれらを更新することもできます。
コードのインテグレーションにはフレームワークのドキュメントを、以下の抽出・翻訳の手順には CLI を使用してください。MCP 接続によってエージェントは稼働中のプロジェクトとその文脈にアクセスできるようになりますが、アプリ側では引き続き SDK のセットアップ、翻訳済みコンテンツ、そして動作確認が必要です。
## 受け入れ基準を含む機能ブリーフを追加する
このブリーフを公式のセットアッププロンプトに追加してください。機能とロケールは、ご自身の要件に合わせて置き換えてください。以下の例では、英語、スペイン語、フランス語を使用しています。
```text
このアプリケーションのプロジェクト一覧機能を国際化してください。
ソース言語は英語、対象言語はスペイン語とフランス語とします。
見出し、オーナー名、プロジェクト数、検索入力欄、表示ラベル、
プレースホルダー、言語セレクターを対象に含めてください。ローカルにバンドルされた翻訳を使用し、
既存のルートとプロバイダーは維持してください。許可されている場合は、接続済みの GT MCP サーバーを使用して
プロジェクト設定と割り当てられた用語を読み取ってください。接続や権限の不足があれば
報告してください。このタスク以外の共有コンテキストは変更しないでください。
件数 0、1、2、句読点を含む名前、入力ラベルと
プレースホルダー、言語の切り替え、再読み込み後の保持、本番環境のビルドを検証してください。
このアプリが SSR を使用している場合は、サーバーでレンダリングされたコンテンツも確認してください。実際に実行したコマンドと
その結果、翻訳レビューのステータス、未テストの項目を報告してください。ソーステンプレートは
完了した翻訳ではありません。変更はこの機能とそのセットアップに限定してください。
デプロイやマージは行わないでください。
```
プロジェクトのルールは、エージェントが読み込む指示の仕組みに記述してください。Cursor については [project rules and AGENTS.md](https://cursor.com/docs/rules)、Claude Code については [CLAUDE.md and other project instructions](https://code.claude.com/docs/en/memory) のドキュメントを参照してください。選択したライブラリ、ソースロケール、翻訳コマンド、必須のチェック項目を既存の指示に追加します。内容に食い違いが生じる恐れがあるため、同じ内容のコピーを複数管理するのは避けてください。
## 代表的な実装を確認する
ブラウザのみで動作する React アプリの場合、[React SPA クイックスタート](/docs/react/react-spa-quickstart)の手順で、レンダリング前に `gt-react` を設定します。この例では、そのセットアップが完了済みで、ローカル出力先が `src/_gt/[locale].json` であることを前提としています。使用するバージョンは `gt-react@11.4.12` と `gt@2.26.5` CLI です。
以下のコンポーネントでは、静的なテキスト、動的な値、複数形、入力テキストを扱います。アプリケーション側からプロジェクト数とオーナー名を渡してレンダリングしてください。
```tsx title="src/ProjectSummary.tsx"
import { Num, Plural, T, Var, useGT } from 'gt-react';
export default function ProjectSummary({
count,
ownerName,
}: {
count: number;
ownerName: string;
}) {
const gt = useGT();
return (
Projects for {ownerName}
You have {count} project.}
other={<>You have {count} projects.}
/>