Model Context Protocol

AIネイティブ翻訳ワークフロー

AIコーディングエージェント（Cursor、Claude Desktop、Copilot、またはKiro）に、エディターを離れることなく翻訳の同期、キーの検索、ローカライゼーションワークフローの管理への直接アクセスを提供しましょう。

CursorClaude DesktopGitHub CopilotKiroClineWindsurf

MCPとは何ですか？

モデルコンテキストプロトコル（MCP）は、AIアシスタントが外部のツールやサービスと連携できるオープンスタンダードです。コマンドをコピー＆ペーストする代わりに、AIエージェントがLocalingosのツールを直接呼び出します：会話の流れの中で翻訳を同期し、キーを検索し、更新をプッシュします。

Core tools (local + remote)

Tool	Description
`localingos_sync`	ソース文字列をプッシュして翻訳を取得します。変更されたコンテンツのみが転送されます — コンテンツハッシュを使用して変更のない項目をスキップし、クライアントが必要とする翻訳のみを返します。
`localingos_push`	翻訳を取得せずにソース文字列をLocalingosにプッシュします。
`localingos_pull`	最新の翻訳を取得して、ロケールファイルをプロジェクトに書き込みます。
`localingos_status`	プロジェクトのステータスを表示：プロジェクト、ロケール、ソースキー数、翻訳ファイル。
`localingos_search`	ソース文字列全体で翻訳キーまたはテキストを検索します。
`localingos_extract`	.messages.ts ファイルから JSON を再構築するために i18n 抽出スクリプトを実行します。

Additional tools (remote + CLI mcp-serve)

Tool	Description
`localingos_get_translatables`	Get all source strings for a project.
`localingos_get_translations`	Get all translations for a project.
`localingos_get_translation`	Get translations for a specific key.
`localingos_translation_jobs`	List translation jobs for a project.
`localingos_retry_job`	Retry a single failed translation job.
`localingos_retry_all_jobs`	Retry all failed and blocked jobs.
`localingos_project_members`	List members of a project.
`localingos_add_member`	Add a member to a project.
`localingos_remove_member`	Remove a member from a project.
`localingos_billing_status`	Show billing status, plan, and usage.
`localingos_attach_billing`	Attach your billing account to a project.
`localingos_detach_billing`	Detach billing from a project.

MCPサーバーをインストールし、AIエージェントがローカルで起動するように設定します。プロジェクトの設定を読み込みます。サーバーコストは不要です。

MCPサーバーをインストールする

npm install -g localingos

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"]
    }
  }
}

Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "localingos": {
      "command": "localingos", "args": ["mcp-serve"]
    }
  }
}

Cline

In VS Code, open Cline → MCP Servers → Add Local Server:

Command: localingos
Arguments: mcp-serve

インストール不要。エージェントをホスト型MCPサーバーに向けてください。各ツール呼び出し時にAPIキーとプロジェクトIDを渡してください。

Claude Desktop

{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}

Cursor

{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}

Kiro

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "localingos": {
      "type": "streamable-http",
      "url": "https://mcp.localingos.com"
    }
  }
}

Cline

In VS Code, open Cline → MCP Servers → Add Remote Server:

Server URL: https://mcp.localingos.com
Server Name: localingos

When using the remote server, your AI agent passes your API key and family ID with each tool call — no local config files needed.

"翻訳を同期する"

→ エージェントが localingos_sync を呼び出す → 770 個の文字列をプッシュし、8 つのロケールをプルして、ファイルを書き込む

「請求ページの翻訳はありますか？」

→ エージェントが "billing" で localingos_search を呼び出す → 一致するキーとテキストを返す

「i18n の抽出を実行して孤立した項目を確認する」

→ エージェントはcheck=trueでlocalingos_extractを呼び出し → キーの数と孤立したメッセージを報告します