AIでAPIスキーマとコレクションを効率的に探索する方法

エージェントがPostmanを使用してワークスペースを閲覧し、保存されているすべてのAPIとコレクションをリストアップします。これにより、AIがサービス構造を理解するために必要なコンテキストが得られ、API全体の構成を明確に把握できるようになります。

1. 01

   ワークスペースの特定

   まず、エージェントがアクセス可能なすべてのPostmanワークスペースを特定し、調査範囲を確定します。

   list_workspaces
2. 02

   内容の確認

   ワークスペースが選択されると、エージェントはその内部に含まれるコンテンツを確認します。

   get_workspace_details
3. 03

   APIの抽出

   対象のワークスペース内にあるすべてのAPI定義をリストアップします。

   list_apis
4. 04

   コレクションのカタログ化

   最後に、すべてのコレクションをリスト化し、エンドポイントの漏れがないことを確認します。

   list_collections

Postman Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_0K4qtkIFA5sn8n9HRmta4uR6Lfy8jZ7oHngivRhy/mcpコピー

Claude Desktop

以下の手順で数秒で接続できます。

1. 1In Claude Desktop, open Settings → Connectors.
2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3. 3Click Add and start a new chat — Postman capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "postman-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_0K4qtkIFA5sn8n9HRmta4uR6Lfy8jZ7oHngivRhy/mcp"
    }
  }
}

• Claude
• ChatGPT
• Cursor
• VS Code
• Windsurf
• Claude Code
• JetBrains
• Cline

アカウントを一度連携するだけです。認証情報は暗号化されて保持されるため、すぐにエージェントへAPI構造について質問を開始できます。

• 01

  AIはPostmanのコレクションを編集できますか？

  いいえ。エージェントはワークスペース、API、コレクションの読み取りとリストアップのみを行います。変更を加える場合は、Postman上で手動で行う必要があります。

• 02

  AIはAPI定義を削除できますか？

  いいえ。このMCPは読み取り専用です。Postmanアカウント内のデータを削除したり、変更したりすることはできません。

• 03

  AIはAPIキーを見ることができますか？

  いいえ。エージェントがアクセスするのは、APIやコレクションの構造的な定義とリストのみです。

• 04

  AIはどのワークスペースを確認すべきか、どうやって判断しますか？

  ユーザーが指示します。最初にすべてのワークスペースをリストアップするよう頼むか、プロンプト内で特定のワークスペース名を指定してください。

• 05

  どのAIクライアントでも使用できますか？

  はい。Claude、Cursor、Windsurfなど、MCPに対応しているクライアントであれば使用可能です。

• Postmanに関するその他の質問 Postman Connectorの全機能を見る