ローカライゼーション用MCPでエンジンをセットアップ
Lingo.devのMCP serverを通じて、AIコーディングアシスタントでローカライゼーションエンジンを設定。ブランドボイス、用語集、ルール、モデルルーティングまで、ひとつの会話で設定できます。
Lingo.devのMCP serverを使えば、AIコーディングアシスタントからローカライゼーションエンジンの設定に直接アクセスできます。このガイドでは、エンジンを一からセットアップする手順を紹介します。インストールから、ロケールごとのブランドボイス、用語集の用語、言語ルール、モデルルーティングまで、必要な設定をひととおり行います。
設定する内容 #
| レイヤー | 役割 | 例 |
|---|---|---|
| ブランドボイス | ロケールごとの口調とフォーマル度 | ドイツ語の開発者向けには親しみのある「ドゥ」、日本語には丁寧でフォーマルな表現 |
| 用語集 | 指定の訳語と翻訳しない用語 | 「デプロイ」はドイツ語で「ベライトシュテレン」に訳し、「オーオース」はどの言語でもそのまま使う |
| ルール | ロケール固有の言語上の慣習 | フランス語では句読点の前に改行を防ぐスペースを入れ、日本語では全角文字を使う |
| モデルルーティング | ロケールごとのモデル選択と代替モデルの指定 | ヨーロッパ言語間の翻訳にはクロード・ソネット、日本語の代替モデルにはジーピーティー・フォーオーを使用 |
最初の三つは、個々のエンジンではなく組織に属します。用語集、ルールセット、ブランドボイスはエンジンに関連付けて適用するため、別のエンジンでもコピーを作らずに同じ設定を使えます。一方、モデルルーティングはエンジンごとに管理します。
こうして、設定を保持する翻訳APIができあがります。コードからはローカライゼーションAPI、コマンドラインからはCLIで呼び出せるほか、継続的インテグレーション/継続的デリバリーを通じてプルリクエストごとに自動実行することもできます。すべてのリクエストに、各レイヤーの設定が自動で適用されます。
設定時の課題 #
ローカライゼーションエンジンには、ロケールごとのブランドボイス、用語集の用語、言語ルール、モデルルーティングの設定が必要です。ダッシュボードですべて設定するには時間がかかり、同じような作業を繰り返すことになります。各レイヤーの役割や相互関係を学びながら進める初回は、特に手間がかかります。
Lingo.devのMCP serverを使えば、ひとつの会話でAIコーディングアシスタントに初期設定を任せられます。製品のコンテンツを指定すると、エンジンの作成、ブランドボイスの文章作成、用語集に登録する用語の抽出、ロケール固有のルールの追加、モデルルーティングの設定まで、一度に行います。あとは、生成された内容をレビューし、調整していきます。
ステップ1:MCPをインストールする #
コーディングエージェントの設定にMCP serverを追加します。以下の手順でLingo.devにサインインし、接続を承認してください。ほかのクライアントについては、セットアップを参照してください。
ユーザー単位で設定する場合は~/.claude.json内のmcpServersに、プロジェクト単位で設定する場合はプロジェクトのルートにある.mcp.jsonにサーバーを追加します。既存のサーバー設定がある場合は、そこに追記してください。
{
"mcpServers": {
"lingo": {
"type": "http",
"url": "https://mcp.lingo.dev/mcp"
}
}
}組織の適用範囲
この接続では、所属するすべての組織で、あなたに代わって操作が行われます。複数の組織に所属している場合は、どの組織で作業するかをアシスタントが一度確認します。
エージェントを再起動し、既存のローカライゼーションエンジンの一覧を表示するよう依頼して、接続を確認します。MCPが有効なら結果が返り、新しい組織の場合は空の一覧が返ります。
ステップ2:エンジンを設定する #
以下のプロンプトをコピーして、AIコーディングアシスタントに貼り付けます。末尾のリンクは、製品のウェブサイト、ドキュメント、またはリードミーファイルへのリンクに置き換えてください。エージェントが語り口、用語、対象読者を推測できるよう、製品の特徴がよく伝わるコンテンツを指定します。
Create a localization engine called 'My Product' for localizing into
German, French, Japanese, and Spanish. Study the content at the URL
below to understand our tone, terminology, and audience. Then configure
everything in one pass: brand voice texts for each locale (and English),
glossary terms that need consistent translations or should stay
untranslated, and locale-specific linguistic rules.
https://docs.yourproduct.comリンクの置き換えを忘れずに
プロンプトの末尾には仮のリンクが入っています。ドキュメント、リードミーファイル、初回利用時の案内、マーケティングサイトなど、製品本来の語り口が伝わるコンテンツへのリンクに置き換えてください。指定しないと、エージェントは汎用的な設定を生成します。
エージェントはコンテンツを読み取り、エンジンの作成からすべてのレイヤーの設定まで一度に行います。次のステップでは、生成された内容をレビューし、調整します。
ステップ3:ブランドボイスを調整する #
エージェントが作成したブランドボイスをレビューします。ブランドボイスにはロケールごとにひとつの文章を設定し、その言語での製品の語り口を、口調、フォーマル度、文体の面から定義します。エージェントはコンテンツからこれらを推測しますが、文化的なニュアンスは確認しておきましょう。
確認するポイント:
| ロケール | 主な調整ポイント |
|---|---|
| ドイツ語 | 「ドゥ」(くだけた呼びかけ)と「ズィー」(改まった呼びかけ)の使い分け。対象読者に応じて選びます |
| フランス語 | 「テュ」(くだけた呼びかけ)と「ヴ」(改まった呼びかけ)の使い分け。一般消費者向けか企業向けかで判断します |
| 日本語 | 丁寧さの度合い。多くの製品では、丁寧でフォーマルな「です・ます」調が無難です |
| 英語 | 原文言語の文章は抜けがちです。一貫性を保つために追加してください |
適切に設定されたドイツ語のブランドボイスの文章例です。
Use informal "du" address. Keep a direct, technical tone.
Prefer short sentences. Use active voice. When a German equivalent
exists for a technical term, use it (e.g., "Bereitstellung" for
deployment), but keep widely-adopted English terms as-is
(e.g., API, CLI, Token).言葉遣いが合っていない場合は、アシスタントに直接伝えます。
The German brand voice is too informal for our enterprise docs.
Switch it to formal "Sie" register.ステップ4:用語集を調整する #
エージェントが作成した用語集の用語をレビューします。用語集は、優先する訳語や、そのまま残す名称をモデルに伝えるものです。エージェントはコンテンツから用語を抽出しますが、製品固有の用語を見落としたり、不適切な訳語を選んだりすることがあります。
初回設定後の一般的な用語集の例:
| 原文 | 訳文 | 原文のロケール | 翻訳先のロケール | 種類 |
|---|---|---|---|---|
| デプロイ | デプロイ | en | de | 指定訳 |
| ワークスペース | ワークスペース | en | fr | 指定訳 |
| Lingo.dev | Lingo.dev | * | * | 翻訳しない用語 |
| オーオース | オーオース | * | * | 翻訳しない用語 |
確認するポイント:
- 用語の登録漏れ — 製品の機能名や、エージェントが読み取ったコンテンツにはなかった社内用語
- 不適切な訳語 — エージェントが、従来の用語の使い方に合わない類義語を選んでいる場合があります
- 翻訳しない用語の登録漏れ — そのまま残すべきブランド名、プロトコル名、略語
用語は意味の類似性に基づいて照合されます。「デプロイ」を登録しておけば、個別に項目を追加しなくても、「デプロイ中」「デプロイメント」「アプリケーションをデプロイする」にも一致します。すべてのロケールに適用する用語には、ワイルドカードの*を使います。
Add a glossary term: 'checkout' should stay as 'Checkout' in
German - it's our product feature name, not the shopping action.ステップ5:ルールを調整する #
エージェントが作成したルールをレビューします。ルールは、特定のロケールに適用する、個別に検証可能な決まりです。ルールセットにまとめてエンジンで適用します。全体の口調を定めるブランドボイスとは異なり、句読点、略語、文字幅、数値の表記形式など、汎用モデルが見落としがちな事項を明文化します。
初回設定後の一般的なルールの例:
| ロケール | 名前 | ルール |
|---|---|---|
| fr | フランス語の句読点前のスペース | :、;、!、?の前には、必ず改行を防ぐスペースを入れる |
| de | ドイツ語の住所表記の略語 | 「シュトラーセ」は「シュトル」、「ヌマー」は「エヌアール」と略記する |
| ja | 日本語の文字幅 | 半角括弧 () ではなく全角括弧()を使う |
各ルールはひとつの事項だけを扱うため、個別に検証できます。ドイツ語の略語に問題があれば、ほかの設定に触れずに、そのルールだけを更新できます。
確認するポイント:
- ルールの設定漏れ — 対象ロケールの数値や日付の表記形式、通貨表記の慣習
- 原文言語のルール — 英語のオックスフォードコンマ、タイトルの大文字表記、数値の表記形式に関するルールは抜けがちです
In French, there should always be a non-breaking space before
colons and semicolons. Add that as a rule for fr.ステップ6:モデルルーティングを設定する(任意) #
新しいエンジンには、広く使われる言語から学習データの少ない言語まで、翻訳品質を重視して最適化されたモデル設定があらかじめ用意されています。ほとんどのチームでは、そのまま使えます。
特定の分野に強いモデルを使いたい、予算に制約がある、法令遵守の要件を満たす必要があるなど、具体的な要件がある場合は、既定の設定を上書きします。
Set Claude Sonnet as the primary model for European language pairs,
with GPT-4o as fallback for Japanese.各モデル設定では、優先順位を付けて代替モデルを指定できます。主に使うモデルが障害、リクエスト数の制限、廃止などで使えなくなると、エンジンは自動で次のモデルを試します。