Lokalise MCPをGemini CLIで使う

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Lokalise をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Lokalise + Gemini

API v2 による Lokalise の翻訳管理：言語ごとの進捗付きのプロジェクト、レビューフラグ付きのキーと翻訳、言語、コントリビューター、翻訳とレビューのタスク、バックグラウンド処理によるファイルのエクスポート、コメント、スクリーンショットのメタデータ、ブランチ、カスタム翻訳ステータス、用語集を扱えます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

LOKALISE_API_TOKEN

ステップ 1 — 認証情報を取得

設定は約 2 分です。プロジェクトにアクセスできる Lokalise アカウントが必要です。

1. Lokalise でプロフィール画像をクリックし、Profile settings > API tokens を開いてトークンを生成します。読み取り用ツールには読み取り専用トークンで十分ですが、変更には読み書き可能なトークンが必要です。
2. それを LOKALISE_API_TOKEN に貼り付けます。X-Api-Token ヘッダーで送信され、各プロジェクトであなたの権限で動作します。
3. コネクタをインストールし、lokalise_list_projects を実行してトークンを確認します。

Lokalise 公式の MCP サーバー: Lokalise はベータ版の MCP サーバー（https://mcp.lokalise.com/mcp/project-management と /mcp/software-development、OAuth または apikey ヘッダー）も提供しています。このコネクタは API v2 とあなたのトークンで動作します。

読み取る内容:

• タイプ、基本言語、チーム付きのプロジェクト。include_statistics: 1 で言語ごとの進捗、キー数、単語数、QA の問題も取得します。プロジェクトの言語、Lokalise が対応する全言語の ISO コードと複数形、カスタム翻訳ステータス。
• プラットフォームごとの名前、説明、タグ、ファイル名、コンテキスト、文字数制限付きのキー。include_translations: 1 でテキストも取得します。キー名、タグ、ファイル名、プラットフォーム、未翻訳、QA の問題、アーカイブ済みで絞り込めます。
• キーと言語ごとに 1 行の翻訳。言語、レビュー済み、未確認、未翻訳、QA の問題、進行中のタスクで絞り込めます。
• 権限と言語付きのコントリビューター。lokalise_get_my_contributor はトークンの所有者を返し、書き込みはこの人の名前で記録されます。
• タイプ、ステータス、期限、言語、担当者、進捗付きのタスク。キー数と最終インポート日付きのファイル。プロジェクトごと、キーごとのコメント。紐づいたキー付きのスクリーンショットのメタデータ。ブランチ。翻訳、タグ、フラグ付きの用語集の用語。

書き込む内容:

• lokalise_create_keys はプラットフォームと原文付きで新しい文字列を追加します。lokalise_update_key と lokalise_bulk_update_keys は名前、説明、タグ（merge_tags で置き換えずに追加）、プラットフォーム、ファイル名、コンテキスト、文字数制限、翻訳を変更します。
• lokalise_update_translation は 1 つのテキストと、レビュー済み、未確認、カスタムステータスのフラグを変更します。複数形のキーは各形（one、other など）を含む JSON 文字列を受け取ります。
• ISO コードで追加する lokalise_add_languages。招待メールを送る lokalise_add_contributors。一部のキーと言語に対して translation、review、automatic_translation のタスクを作成し、ユーザーやグループに期限付きで割り当てる lokalise_create_task。{"close_task": true} でタスクを閉じる lokalise_update_task。
• lokalise_add_key_comments（翻訳者への質問や文字列のコンテキスト）、lokalise_create_branch、lokalise_create_glossary_terms（翻訳してはいけないブランド名や使用禁止の語など）、lokalise_update_glossary_terms。

ファイルのエクスポート: lokalise_download_files は json、xliff、strings、xml、po、yaml などの形式でエクスポートを開始し、process_id を返します。AI は status が finished になるまで lokalise_get_process を呼び出し、details.download_url の zip リンクを渡します。このリンクはしばらくすると失効します。エクスポートは POST ですが、プロジェクトは変更しません。

インストール時は無効: lokalise_delete_key。キーをすべての翻訳ごと削除し、元に戻せません。チームに必要なときにワークスペース管理者が有効にします。

ID と形式: プロジェクト ID は 767946315e9866d013c1d0.08299127 のような形式で、ブランチで作業するには <project id>:<branch name> を渡します。キー、翻訳、タスク、言語、ユーザーの ID は数値です。言語は en、de、pt_BR などの ISO コードです。リストの応答は項目を包んで返します（projects、keys、translations など）。日時は YYYY-MM-DD HH:MM:SS (Etc/UTC) と Unix の ..._timestamp で届きます。フィルターのフラグは 0 か 1 です。

ページング: limit と page を使います。合計は x-pagination-total-count と x-pagination-page-count ヘッダーで届き、_headers の下に表示されます。キーと翻訳は pagination: cursor にも対応し、AI は x-pagination-next-cursor の値がなくなるまで、それを cursor として渡します。用語集の用語は cursor でのみページングします。

制限: トークンごと、IP アドレスごとに毎秒 6 リクエスト、プロジェクトごとの同時リクエストは最大 10 件です。429 は速度を落とす合図です。

よくあるエラー: 401 はトークンの誤りです。403 は読み取り専用トークンでの書き込み、またはプロジェクトでの権限不足です。404 は存在しないプロジェクトや項目です。400 はフィールド名を示す検証エラーで、X-Api-Token の値がスペースや引用符を含むなど有効なトークンでない場合にも返ります。

このコネクタは翻訳ファイル（base64 のコンテンツが必要）やスクリーンショットのアップロード、プロジェクト、言語、タスク、用語集の用語の削除は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Lokalise のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「モバイルアプリのプロジェクトの翻訳進捗を言語ごとに教えて。」
• 「checkout タグの付いたキーのうち、ドイツ語とフランス語でまだ未翻訳のものはどれ？」
• 「Web プロジェクトを de と it の JSON ファイルでエクスポートして、ダウンロードリンクをちょうだい。」
• 「オンボーディングのキーのスペイン語訳について、来週金曜締め切りのレビュータスクを作成して。」
• 「「AnythingMCP」を翻訳してはいけないブランド名として用語集に追加して。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続