統合の役割を理解する
MCPの公式アーキテクチャでは、アプリケーションを実行するホスト、ホスト側のクライアント、ツールやリソースを公開するサーバーを区別します。MCPが定めるのはコンテキストのやり取りの方法です。業務フローと認可ルールはアプリケーション側で決めます。
許可されたドキュメントの読み取りや特定の集計のクエリなど、公開する特定のタスクをリストします。汎用接続へのアクセスによって、すべてのデータセットおよびアクションに対する権限が付与されるわけではありません。
ツールインベントリを作成する
| ツール属性 | 何を文書化するか |
|---|---|
| 目的 | ツールが提供するビジネスタスクとそれをいつ使用するか |
| 入力 | 構造、制約、デフォルト、機密フィールド |
| アイデンティティ | 実行されるユーザーまたはサービスの ID |
| 操作の種類 | 読み取り専用、書き込み、または外部効果のあるその他のアクション |
| 出力 | 結果、ソース、障害状態、およびサイズ制限 |
| 監査 | 操作を特定のリクエストに関連付ける方法 |
最初に読み取り専用ツールを検証する
- 導入環境とクライアントでサポートされているプロトコルのバージョン、トランスポート、および認証構成を確認します。
- 実際に公開されているツールを確認し、タスクに必要なツールのみを有効にします。
- 合成入力を使用して、成功、不十分な権限、タイムアウト、結果なしを個別にテストします。
- 出力内のソースとファイルへのアクセスを再確認し、取り消し後の動作を確認します。
ツールの説明と実行権限を区別する
ツールによって返されるテキスト、ドキュメント、および Web ページには、サードパーティの指示が含まれる場合があります。ユーザーの既存の権限内のビジネスコンテンツとして扱います。書き込み、外部送信、その他のビジネスアクションについては、アプリケーションの確認および監査ルールに従ってください。
互換性は、MCP クライアントおよび製品リリースによって異なります。公開されているツール定義、ID マッピング、提供している統合の互換性に関する注意事項を検証します。
さらに読む
このガイドは役に立ちましたか?
