MCP 経由で Postman を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Postman をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Postman + Cursor

AI エージェントから Postman を操作：ワークスペース、コレクション、フォルダー、リクエスト、環境、Spec Hub の仕様と API、呼び出しログ付きのモックサーバー、モニター、チームのユーザーを参照し、横断検索し、確認のうえでコレクション、リクエスト、環境、モック、モニター、スペックを作成または変更できます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

POSTMAN_API_URL, POSTMAN_API_KEY

ステップ 1 — 認証情報を取得

設定は約 2 分です。ワークスペースにアクセスできる Postman アカウントが必要です。

1. Postman でアバター、Settings、API keys（https://go.postman.co/settings/me/api-keys）を開き、**Generate API Key** をクリックします。名前を付けてキーをコピーします。キーは PMAK- で始まります。
2. それを POSTMAN_API_KEY に貼り付けます。X-Api-Key ヘッダーで送信され、あなたの Postman ユーザーとして動作します。AI はあなたがすべてのワークスペースで見られるものを見られます。
3. POSTMAN_API_URL を https://api.postman.com に設定します。チームが Postman の EU データリージョンの Enterprise プランを使っている場合は https://api.eu.postman.com にします。
4. コネクタをインストールし、postman_get_me を実行します。ユーザー ID、チーム、月間の API 使用量が表示され、キーを確認できます。

id と uid: ほとんどのオブジェクトには id と uid（<owner user id>-<id>）があります。モック、モニター、postman_update_collection はコレクションの uid を、postman_create_collection_request、postman_update_collection_request、postman_create_collection_folder は単純な id を受け取ります。ほかの読み取りツールはどちらでも受け付けます。

読み取れるもの:

• 自分とチーム: postman_get_me、postman_list_workspaces（「自分のワークスペース」なら createdBy に自分のユーザー ID を指定）、postman_get_workspace（含まれるコレクション、環境、モック、モニター、API）、postman_list_team_users、そしてリクエスト、コレクション、ワークスペース、環境、ドキュメント、フロー、スペックをテキストで探す postman_search（既定では自分のチームのみ、ownership で公開リソースも）。
• Postman Collection Format v2.1 のコレクション: postman_list_collections、postman_get_collection（大きなものはまず model=minimal）、postman_get_collection_folder、メソッド、URL、ヘッダー、ボディ、認証、スクリプトを含む postman_get_collection_request。
• 環境: 各変数のキー、値、型、有効フラグを含む postman_list_environments と postman_get_environment。
• API 設計: Spec Hub の postman_list_specs、postman_get_spec、postman_list_spec_files、postman_get_spec_file、postman_get_spec_definition（解決済みの OpenAPI または AsyncAPI 定義全体）。旧 API Builder の API は postman_list_apis と postman_get_api。
• モック: postman_list_mocks、postman_get_mock、そしてクライアントがモックに送った内容とモックの応答を返す postman_get_mock_call_logs（1 回あたり最大 100 件または 6.5 MB。ヘッダーとボディは include 指定時のみ）。
• モニター: postman_list_monitors と postman_get_monitor。lastRun に直近の状態、時刻、成功と失敗したアサーションの数が出ます。

確認のうえで書き込めるもの: postman_create_collection、postman_update_collection（名前、説明、変数、認証。フォルダーとリクエストはそのまま）、postman_create_collection_folder、postman_create_collection_request、postman_update_collection_request（渡したフィールドが古い値を置き換えます）、postman_create_environment、postman_update_environment、postman_create_mock、postman_create_monitor、postman_run_monitor、postman_create_spec（OpenAPI、AsyncAPI、protobuf、GraphQL、Smithy）、postman_update_spec_file。AI はどのワークスペースで何を作成または変更するかを伝え、あなたの了承を得てから呼び出します。書き込んだ内容はワークスペースのメンバー全員に見えます。注意点:

• postman_run_monitor はコレクションの実際のリクエストを各 API に送り、プランのモニタリング実行を 1 回消費します。postman_create_monitor はその後もスケジュールに従って実行を続けます。
• 新しいモックは、private を true にしない限り公開されます。
• postman_update_environment は 1 回の呼び出しで 1 種類の JSON Patch 操作だけを受け付けます。AI は先に環境を読んで変数の位置を確認します（values[0] は /values/0）。
• Postman API ではコレクションを直接実行できません。モニターを使うか、自分の CI で Postman CLI を使ってください。

インストール後は 35 個のツールがすべて有効で、無効化されているものはありません。ワークスペース、コレクション、リクエスト、環境、モック、モニター、スペックを削除するツールはありません。

シークレット: secret 型の環境変数は、共有されていれば値付きで返ります。コレクション変数やリクエストの認証にもトークンが含まれることがあります。AI は頼まれない限り、こうした値を繰り返し表示しません。

データ形式: コレクションとリクエストは Postman Collection Format v2.1 です（item にフォルダーとリクエストが入ります）。日付は UTC の ISO 8601 です。

ページング: postman_list_workspaces、postman_list_apis、postman_list_specs、postman_list_monitors、postman_get_mock_call_logs、postman_search は meta.nextCursor を返し、AI はそれが空になるまで cursor を付けて呼び出します。postman_list_collections は limit と offset でページングし、name フィルターは名前の完全一致で、それらと併用できません。

制限: Postman はユーザーあたり毎分 300 リクエストまで、postman_list_collections、postman_list_workspaces、postman_get_workspace とモニターのエンドポイントは 10 秒間に 10 回までです。プランごとに月間の API 呼び出し枠もあり、postman_get_me の operations で確認できます。rateLimited 付きの 429 は待つ必要があることを意味し（Retry-After に秒数）、serviceLimitExhausted はプランの枠を使い切ったため、チームの管理者の対応が必要なことを意味します。

よくあるエラー: 401 はキーの誤り、期限切れ、失効、または別のデータリージョンのキーであることを意味します（POSTMAN_API_URL を確認）。403 はそのワークスペースでのあなたのロールではその呼び出しが許可されていないことを意味します。404 は ID が存在しないか、あなたから見えないことを意味します。400 は誤ったフィールドを示します。たとえば uid が必要な場所にコレクション ID を渡した場合です。

このコネクタは何も削除せず、フォークとプルリクエスト、コメント、タグ、ガバナンス、API カタログ、プライベート API ネットワーク、SCIM、監査ログ、請求、旧 API Builder への書き込みには対応していません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Postman のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「『Payments』ワークスペースにはどのコレクションがあり、Checkout コレクションにはどんなリクエストが入っていますか？」
• 「注文 API の夜間モニターは直近の実行に成功しましたか？ 失敗したアサーションはいくつですか？」
• 「チェックアウト用モックサーバーへの呼び出しのうち、404 になった直近 20 件を見せてください。」
• 「Payments コレクションに、orderId と amount の JSON ボディを持つ POST リクエスト『Create refund』を追加してください。」
• 「Orders スペックの解決済み OpenAPI 定義を取得し、エンドポイントを一覧にしてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続