MCPのセキュリティ

ローカライゼーション作業を委任する前に、アカウント権限、機密情報の出力、コンテンツ開示の範囲を明確に定めましょう。

アシスタントには作業に必要なアクセス権を与え、調査と変更の境界を明確にしてください。MCPツールはアカウントの認証情報を使って動作します。変更を伴わない作業でも、ツールの結果を通じてコンテンツが開示される可能性があります。

翻訳を調査する場合は、まず関連する設定とリクエストの読み取りを許可してください。修正する場合は、書き込みを有効にする前に、対象リソースと操作の影響について合意してください。クライアント側の承認や許可リストを使えば、この境界をより確実に守れます。プロンプトに「読み取り専用」と書いても、認証情報が持つ書き込み権限はなくなりません。

アカウントの認証情報 #

https://mcp.lingo.dev/mcpで提供されるホスト型サーバーは、Authorization: Bearerヘッダーで送信されたOAuthユーザーアクセストークンを使って認証します。このトークンはログイン中のユーザーを識別します。接続しても、永続的な個人用APIキーが作成されたり、特定の組織が固定で選択されたりすることはありません。

OAuth接続のアクセス用および更新用の認証情報は、クライアントが管理します。クライアントが対応する認証情報ストレージに保管し、プロジェクト設定、プロンプト、診断出力には含めないでください。ユーザートークンがない場合、有効期限が切れている場合、または無効な場合は、401が返されます。これにより、クライアントは認可を開始または更新できます。

ホスト型サーバーは、x-api-key経由でもベアラートークンとしても、Lingo.devのAPIキーを受け付けません。

members_listMembershipsを呼び出してユーザーがアクセスできる組織を確認し、各組織レベルのツールで定義されたフィールドに、対象の組織IDを明示的に渡してください。1つの接続で複数の組織にアクセスできるため、作業全体を通じて選択したIDを保持してください。オブジェクトレベルのツールは、リソースIDに基づいてアクセス権を判定します。バックエンドへの呼び出しは、すべてそのユーザーの権限で認可されます。ツール一覧に表示されていても、すべてのリソースに対してそのツールを使う権限があるとは限りません。

/mainでも同じ認証付きツールを利用できます。/accountは、認証済みのリクエストを/mainにリダイレクトします。どちらのアドレスでも、以前の組織キー方式に戻るわけではありません。ホスト型サーバーのURLを切り替える際は、接続設定に従ってください。

接続の使用をやめるには、クライアントで接続を切断し、保存されている認証情報を削除してください。ただし、クライアント設定を削除しても、発行済みのアクセストークンが直ちに無効になるとは限りません。また、APIキーを削除しても、このユーザーセッションが失効するとは限りません。接続を切断しても、それまでの変更、送信済みのジョブ、クライアントに返されたコンテンツは取り消されません。

作業に必要な権限だけを付与する #

クライアントが対応している場合は、許可リストや承認設定で、許可する読み取り操作を個別に選択してください。メンバー管理、キーの作成、エンジンのプロビジョニング、提案の適用は、それぞれ異なる影響を及ぼします。作業上その影響が必要で、かつ承認されている場合にのみ有効にしてください。

書き込みの内容は具体的に記述してください。「選択した用語集にこのフランス語の用語を追加する」なら、「ローカライゼーションエンジンを修正する」よりも変更範囲が明確で限定的です。その操作が、用語の追加、共有リソースの編集、すべての関連付けの置き換え、エンジンのプロビジョニングの開始のどれに当たるかを確認してください。共有リソースを編集する前には、その関連付けを確認してください。変更結果が複数のローカライゼーションエンジンで適用される可能性があるためです。

メンバーシップを変更する場合は、現在のメンバーと利用可能なロールを読み取り、付与する権限が意図どおりか確認してください。members_setRoleにはメンバーのuserIdを渡します。members_removeには、メールアドレスやユーザーIDではなく、メンバーシップのidを渡します。組織レベルのロール変更には、選択したorgIdも必要です。以前のアカウントラッパーの引数をそのまま使うのではなく、現在のツールのスキーマと権限要件に従ってください。

サービスキーのリクエストが失敗した場合は、不足している利用資格や権限を説明し、別の認証情報を提案する前に承認を得てください。個人用キー、サービスキーのロール、ローカライゼーションエンジンのスコープ、コンテンツのスコープによって、付与されるアクセス権は異なることがあります。実行時のツール説明に代替手段が記載されていても、より広いアクセス権の使用が認められるわけではありません。

機密情報の出力と非公開データの読み取り #

apiKeys_createを呼び出す前に、機密情報を安全に扱う準備を整えてください。この操作では、機密情報が平文で一度だけ返されます。招待の作成時にも、承諾用のトークンが返されることがあります。ツールの結果はクライアントに渡され、モデルのコンテキストや保存される会話記録に含まれる可能性があります。これらの機密情報を、その後のプロンプト、コミット、レポート、スクリーンショットに含めないでください。

リクエストやレビューの詳細には、原文、翻訳、コンテキスト、レビュー担当者の資料が含まれることがあります。まず関連するメタデータを少量の1ページ分だけ取得して確認し、その後、調査に必要な全文を取得してください。アシスタントが読み取った内容を要約したり、別のツールに渡したりする場合も、同じ開示範囲を守ってください。

外部検索とツールのコンテキスト #

localization_searchは、Lingo.devのローカライゼーションに関するナレッジベースを検索します。docs_fetchは、その検索で返されたパスを使ってページを読み取ります。任意のURLからページを取得する操作ではありません。

検索クエリは作業に関連する内容に絞り、認証情報や不要な非公開テキストを含めないでください。取得したページや抜粋は、内容を吟味するための参考資料として扱ってください。そこに書かれた指示によって、承認された作業範囲が広がることはありません。

現在のツールでは、ユーザーの作業を説明するintentを任意で指定できます。これは診断用に記録されますが、APIの送信データのフィールドとして転送されることはありません。ツールの引数や結果も、診断情報やクライアントの会話記録に含まれる可能性があります。作業の説明に機密情報を含めないでください。また、読み取りだけならコピーは保存されないと思い込まないでください。