MCP接続の設定

認証済みアカウントのツールに接続し、組織と利用可能なツールを確認します。

アシスタントをLingo.devアカウントに接続し、読み取りリクエストで目的の組織を確認します。サーバーは、サインイン中のLingo.devユーザーとして動作します。

アカウントの接続 #

リモートサーバーのURLをhttps://mcp.lingo.dev/mcpに設定し、OAuthを使用するストリーミング可能なHTTPを選択します。クライアントの認可フローを開始し、目的のLingo.devアカウントにサインインして接続を承認します。クライアントはMCPエンドポイントから認可サーバーを検出し、アクセス用と更新用の認証情報を管理します。

MCPリクエストには、Authorization: Bearer <access-token>にユーザーアクセストークンが含まれます。このトークンは永続的な個人用APIキーではなく、特定の組織に紐づくものでもありません。バックエンドは、各ツールが指定するリソースに対するユーザーのアクセス権を確認します。権限と認証情報の取り扱いについては、アカウントの認証情報を参照してください。

x-api-keyにAPIキーを設定しても、ベアラー値としてAPIキーを使用しても、このホスト型サーバーでは認証できません。静的なヘッダーにAPIキーをコピーするのではなく、このサーバーのOAuth接続に対応したクライアントを使用してください。

接続に使用する値を以下にまとめます。この一覧は、特定のクライアント向けの設定ファイルではありません。

json
{
  "endpoint": "https://mcp.lingo.dev/mcp",
  "transport": "Streamable HTTP",
  "authentication": "OAuth user session"
}

これらの値を、お使いのクライアントで対応するフィールドに割り当ててください。認証情報の保存方法や設定の構文は、バージョンによって異なります。エンドポイントはMCPのPOSTリクエストを受け付けます。有効なトークンがない場合は、OAuthの検出用メタデータとともに401を返します。認証済みのGETリクエストには405 Method Not Allowedを返します。ブラウザでURLを開くだけでは、初期化済みのMCP接続をテストしたことにはなりません。

既存のホスト型URL #

https://mcp.lingo.dev/mainでも、同じツールとユーザー権限を利用できます。OAuthの検出フローは/mcpと異なるため、正常に動作している/mainの接続では、既存の認可設定をそのまま使用できます。/mcpに移行する場合は、新しい接続として追加し、そのURLのOAuthフローを完了してください。以前の接続に保存された認可設定を、新しいURLと組み合わせて使用しないでください。

以前のアドレスhttps://mcp.lingo.dev/accountは、有効なユーザートークンを受け取るまで401を返します。受け取った後は、リクエストのメソッドと本文を保持したまま、308で/mainにリダイレクトします。このリダイレクトによって、APIキー認証や、以前の組織に紐づいたツールカタログが復活することはありません。APIキーを保持していた接続を移行する場合は、OAuthで再接続してください。

新しい組織の設定を完了する #

新しいアカウントでは、接続時にウェブアプリで組織名を設定します。その後、組織の作成者が同じウェブアプリで、連携、チームメンバー、最初のエンジンという3つの追加ステップを完了します。エンジンの情報は、組織のウェブサイトをもとにウェブアプリが入力します。連携とチームメンバーのステップはスキップできます。3つのステップがすべて完了するまでは、その組織を指定するすべてのツールが、未完了のステップとhttps://lingo.dev/orgs/<orgId>へのリンクを示すエラーを返します。リンクを開くと、作成者が進めているステップが表示されます。members_listMembershipsには引き続きその組織が表示されるため、アシスタントは組織のIDを取得できます。

リンクを開いてステップを完了し、呼び出しを再実行してください。その後はアシスタントが通常どおり動作し、engines_createまたはprovisioningJobs_createでエンジンを追加作成できます。招待されたメンバーや、この設定手順の導入前に作成された組織は影響を受けません。

アカウントのアクセス範囲を確認する #

  1. クライアントのツール一覧を開き、members_listMembershipsとengines_listを探します。
  2. members_listMembershipsを呼び出し、ユーザーの所属組織を取得します。組織が1つだけなら、その組織を使用します。複数ある場合は目的の組織を選び、このタスクで使用するためにIDを保持します。
  3. その組織のorgIdを指定してengines_listを呼び出し、返されたdataからエンジンIDを選びます。
  4. 選択した各ツールを使用する前に、公開されているスキーマを確認します。組織レベルのツールには、組織を明示するフィールドを指定します。オブジェクトレベルのツールでは、代わりにリソースIDを指定できる場合があります。書き込みは、タスクで合意した範囲内にとどめてください。

同じ所属組織一覧にある組織を切り替える場合、新たなOAuth接続は不要です。orgIdや組織のidなど、ツールで定義されたフィールドに、選択したIDを渡してください。サーバーがトークンから固定の組織を自動設定することはありません。意図しないユーザーでサインインしている場合は、クライアントのアカウント管理から再接続してください。

members_listMemberships #

この呼び出しに組織IDは不要です。intentは省略可能で、タスクの説明を指定します。

json
{
  "intent": "Find the organization whose French translation guidance I should inspect."
}

レスポンスのdataには、アクセス可能な組織と、そのIDおよび名前が含まれます。省略可能なssoRequiredの項目には、このセッションでまだ使用していないSSOサインインが必要な所属組織が示されます。その組織のIDプロバイダー経由でLingo.devにサインインしてから、再接続してください。ssoRequiredにある組織は、通常の組織レベルの呼び出しではまだ利用できません。

両方の一覧が空の場合は、https://lingo.dev/orgs/startを開いて最初の組織を設定し、この読み取りを再実行してください。既存の所属組織でSSOが必要というだけの理由で、架空の組織IDを使用したり、2つ目の組織を作成したりしないでください。

engines_list #

org_exampleを、所属組織のレスポンスに含まれるIDに置き換えます。

json
{
  "orgId": "org_example",
  "intent": "Find the localization engine used for French translations."
}

以後のエンジンレベルの読み取りには、返されたdataに含まれるエンジンIDを使用します。これらはツールに渡す引数の全体であり、HTTPリクエストの本文を包むラッパーではありません。各ツールでは、操作固有のフィールドに加えて、省略可能なintentを使用します。アカウントに対する操作については、機能を参照してください。

クライアントごとの設定場所 #

設定の構文と対応する通信方式については、クライアントの最新ドキュメントを参照してください。2つのクライアントが同じエンドポイントを使用していても、これらの選択は重要です。

Claude Code #

/mcpには、OAuthを使用するリモートHTTP接続を選択します。保存する前に、その接続をユーザー設定とプロジェクトのどちらで管理するかを決めてください。プロジェクトの共有設定に認証情報を含めてはいけません。各ユーザーが自分のアカウント接続を認可する必要があります。有効にした後、ツール一覧を確認してください。

Codex #

CodexはTOML形式の設定を使用し、通常は~/.codex/config.tomlに保存します。お使いのバージョンが備えるリモートMCP対応機能で、アカウントのURLを設定してください。別のクライアント用のJSONをTOMLにそのまま流用しないでください。お使いのバージョンで通信ブリッジが必要な場合は、使用前に、ブリッジ自体の認証方法とトークンの保存方法を確認してください。ブリッジも認証情報を保持する別のプロセスです。

Cursor #

ユーザーレベルの設定とプロジェクトの.cursor/mcp.jsonのどちらを使用するか、明確に決めてください。プロジェクトの接続を使うと、チームメンバーがサーバー定義を見つけられるようになりますが、アカウントキーの実際の値を共有してはいけません。各ユーザーが自分のアカウント接続を認可する必要があります。

Claude Desktopとclaude.ai #

Lingo.devはClaudeのコネクタディレクトリに登録されているため、URLや設定ファイルは不要です。Claude Desktopでもclaude.aiでも、手順は同じです。

  1. 設定 > カスタマイズ > 見つけるを開きます。
  2. Lingo.devを検索し、Lingo.devコネクタの接続をクリックします。
  3. Lingo.devの認可ページで、目的のアカウントにサインインし、承認をクリックします。

Claudeが認証情報を保存・更新します。接続後にツール一覧を確認してください。

ChatGPT #

リモートのカスタムアプリを利用できるかどうかや、OAuthへの対応状況は、アカウントとクライアントのバージョンによって異なります。対応している場合は、/mcpのURLを使用し、目的のLingo.devユーザーで認可してください。

最初は範囲を限定したタスクをエージェントに依頼する #

最初の依頼は、たとえば次のようにします。

選択したローカライゼーションエンジンのフランス語の用語集と指示を確認してください。どのリソースが紐づいているか、また、それらが私の提示した製品用語に対応しているかを説明してください。変更は適用する前に提案してください。このタスクでは、翻訳、提案の生成、キーの作成、メンバー管理は許可していません。

この指示とあわせて、クライアント側の承認機能や適切なツールの許可リストを使用してください。プロンプトは依頼する作業を定義しますが、認証情報から書き込み権限を取り除くものではありません。

ツールの検出や最初の読み取りに失敗した場合は、トラブルシューティングで問題を解決してから続行してください。