Postman MCPサーバーの使い方 — Connector・Plugin・手動接続の違い
PostmanをClaudeにつなぐ3つの経路(公式Connector・Claude Code用Plugin・claude mcp addでの手動接続)の違いと、ツール構成の選び方を扱います。
Postman MCPサーバーは、ワークスペース・コレクション・仕様・モック・モニターといったPostmanのリソースを、AIエージェントへの自然言語の指示で操作できるようにする公式サーバーです。ClaudeからPostmanにつなぐ経路は1つではなく、Connector・Claude Code用Plugin・claude mcp addでの手動接続の3つがあり、どれを選ぶかで使える範囲と設定の手間が変わります。
Claude CodeでのMCPサーバー追加構文とスコープの基礎はClaude Code MCP設定ガイド、MCPプロトコル自体の仕組みはMCPとはが扱っています。
Postman MCPサーバーとは
Postman MCPサーバーとは、Postman APIをMCPのツール群としてラップし、AIエージェントが自然言語でコレクションの実行やワークスペースの管理を行えるようにする公式サーバーです。Postman公式リポジトリpostmanlabs/postman-mcp-serverで公開されており、リモート(ホスト型)とローカル(自前起動)の2方式で提供されます。
対応するAIエージェントはClaude・Cursor・VS Code(GitHub Copilot)など複数あります。
3つの接続経路とどれを選ぶか
PostmanをClaudeにつなぐ方法は、使う場所によって3通りに分かれます。
| 経路 | 使う場所 | 設定の単位 | 向くケース |
|---|---|---|---|
| Connector | 使う場所Claude | 設定の単位アカウント単位 | 向くケースGUIで完結させたい、複数端末で同じ設定を使いたい |
| Plugin for Claude Code | 使う場所Claude Code | 設定の単位プロジェクト単位 | 向くケーススラッシュコマンドやAPI Readiness Analyzerまで含めて導入したい |
claude mcp addでの手動接続 | 使う場所Claude Code | 設定の単位プロジェクト/ユーザー/ローカルスコープを自分で選べる | 向くケースツール構成(Minimal/Code/Full/Learn)を細かく選びたい |
Connectorは公式のPostmanコネクタページから追加する形で、権限は「Read & write」です。手続きが最も少ない一方、ツール構成を選ぶオプションはありません。
Claude Codeにコマンドで接続する
claude mcp addでリモートサーバーに直接つなぐと、4種類のツール構成をエンドポイント単位で選べます。
claude mcp add --transport http postman https://mcp.postman.com/minimalUSリモートサーバーはOAuthに対応しており、鍵の管理なしで認証できます。APIキー認証を使う場合は--headerフラグで渡します。
claude mcp add --transport http postman https://mcp.postman.com/mcp \
--header "Authorization: Bearer <POSTMAN_API_KEY>"EUリージョンはOAuthに対応せず、APIキー認証のみです。エンドポイントもmcp.eu.postman.comに変わります。
| 構成 | 収録ツール | 向くケース |
|---|---|---|
| Minimal(既定) | 収録ツール基本操作のみ | 向くケース動作を速くしたい、基本機能だけで足りる |
| Code | 収録ツールクライアントコード生成系 | 向くケースAPIを消費する側、コンテキスト取得が主目的 |
| Full | 収録ツール100以上の全ツール | 向くケースPostman Enterpriseの高度な連携まで使う |
| Learn | 収録ツールPostman Docsの検索 | 向くケース使い方そのものをAIに調べさせたい |
Minimal・Code・Learnは構成名どおりのパスですが、Fullだけ/fullではなく/mcpという別名になります。EU向けはmcp.postman.comをmcp.eu.postman.comに置き換えた形です。
Plugin for Claude Codeでプロジェクト単位に導入する
Postman公式のPostman-Devrel/postman-claude-code-pluginは、MCPサーバーの接続設定に加えて、Postman向けのスラッシュコマンド一式をまとめて導入します。
/plugin install postman@claude-plugins-official導入後は/postman:setupでOAuthかAPIキーを選んで認証し、以降は次のようなコマンドが使えます。
| コマンド | できること |
|---|---|
/postman:sync | できることOpenAPI仕様からコレクションを作成・更新 |
/postman:test | できることコレクションのテストを実行し失敗原因を診断 |
/postman:mock | できることフロントエンド開発用のモックサーバーを作成 |
/postman:security | できることOWASP API Top 10に沿ったセキュリティ監査 |
/postman:context | できること実際のAPI定義を取得し型付きクライアントコードを生成・保守 |
このPluginにはAPI Readiness Analyzerも同梱されています。メタデータ・エラー設計・命名規則など8つの観点でAPIをAIエージェント対応度としてスコアリングし、70%以上かつ致命的な失敗が無ければ「Agent-Ready」と判定します。単にMCPサーバーをつなぐだけでなく、自分のAPI設計そのものをAIエージェント向けに見直したいときに向きます。
Pluginは既定でFullサーバー(100以上のツール)に接続します。最近のClaude CodeはMCPのツールスキーマをオンデマンドで読み込むため、Full接続によるコンテキストの増加は小さいとされています。古いクライアントを使っている場合や軽いセッションにしたい場合は、POSTMAN_MCP_MODE環境変数でMinimal・Codeへ絞り込めます。Claude Code v1.0.33以上が必要です。
Postman MCPサーバーでできることの具体例
Postman公式が挙げる主なユースケースは次の4つです。
- コード同期 — コレクションや仕様と実装コードを同期させる
- コレクション管理 — コレクションの作成・タグ付け、リクエストのドキュメント更新、コメント追加を、エディタから離れずに行う
- ワークスペースと環境の管理 — ワークスペースや環境の作成、環境変数の管理
- 仕様の自動生成 — コードからPostman仕様を作成し、そこからコレクションを生成する
Tipsページでは、Django REST FrameworkのAPIをPostmanと同期させる例が紹介されています。プロンプトは「このリポジトリのDjango REST Framework APIについて、CustomerリソースのCRUD APIからOpenAPI定義を推測し、既存のワークスペース"Customers"のIDを取得して、そこにPostman仕様とコレクションを作成して」という形で、エージェントがワークスペースIDの取得からコレクション作成まで一連の操作をこなします。コレクションのドキュメントを更新する用途では、「"Customer API Collection"の説明を"認証と権限が必要な顧客テーブルへのCRUD操作"に更新して」のように、変更内容を直接指示する書き方が推奨されています。
ローカルサーバーという選択肢
リモートサーバー以外に、エージェントを動かすマシン上でSTDIO経由のローカルサーバーを立てる方法もあります。ソースコードを自分で取得して実行するか、Dockerイメージを起動するかのどちらかです。npmパッケージ@postman/postman-mcp-serverとしても配布されています。
claude mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server@latestローカルサーバーが向くのは、ローカルでのAPIテスト、社内APIへの接続、独自のセキュリティ・ネットワーク要件がある場合、あるいはソースからビルドしたい場合です。ツール構成はコマンドの末尾に--code・--full・--learnのいずれかを付けて切り替えます。ローカルサーバーはAPIキー認証のみに対応し、OAuthは使えません。リモートサーバーと違って認証方式を選べない点は導入前に押さえておく必要があります。テレメトリーの既定値もリモートとは逆で、ローカルサーバーは既定で収集せず、共有するには明示的なオプトインが必要です。
セキュリティと運用で気をつける点
Postman公式のベストプラクティスとして、次の3点が挙げられています。
- どのMCPサーバーを使うか明示する — LLMがcurlやPostman CLIで直接操作しようとすることがあるため、プロンプトの冒頭で「Postman MCPサーバーを使うこと」と明記する
- 変更・削除操作は必ず確認してから承認する — 更新や削除のような破壊的な操作は、エージェントが返した内容を検証してから受け入れる
- リソースIDを渡してAPI呼び出しを減らす — ワークスペース名だけを伝えると、エージェントが一覧取得→絞り込みの複数回リクエストを行う。IDを直接渡せば1回で済む
APIキーはシークレットとして扱い、環境変数かホストのシークレットストアに保存します。リモートサーバーは既定でテレメトリーを匿名収集しますが、ローカルサーバーは既定でオフで、共有するにはオプトインが必要です。
よくあるつまずき
OAuthが使えるのにAPIキーを設定してしまう
USリモートサーバーはOAuthが既定の推奨経路で、APIキーの管理が要りません。--headerでAPIキーを渡す設定は、EUリージョンを使う場合や、OAuthフローを避けたい事情がある場合に限定するのが妥当です。
Connector・Plugin・手動接続を同時に設定してしまう
同じPostman MCPサーバーを複数の経路で重複して追加すると、Claude Code側で名前が衝突したり、意図しないツール構成が優先されたりします。Claude Codeでの開発作業ならPluginか手動接続のどちらか一方、GUIで完結させたいならConnectorという形で経路を絞るのが安全です。
接続したはずなのにツールが見当たらない
設定を追加しただけではホスト側に反映されないことがあります。Claude Codeを再起動するかセッションを開き直し、/mcpでPostmanサーバーとそのツール一覧が表示されるか確認します。次に「自分のPostmanワークスペースを一覧表示して」のような読み取り専用の指示を出し、実際にワークスペースが返ってくれば接続は成立しています。
よくある質問
Full構成のツールはすべて無料で使えますか
Full構成の説明には「高度なコラボレーションとPostman Enterprise機能に最適」という注記があります。一般的なコレクション操作やコード生成はMinimal・Codeの範囲で足りますが、Enterprise向け機能を含む一部のツールは契約プランに依存する可能性があります。
まとめ
PostmanをClaudeにつなぐ経路は、使う場所で選ぶのが基本です。GUIで手早く済ませたいならConnector、Claude CodeでのAPI開発をスラッシュコマンドごと整えたいならPlugin、ツール構成を細かく制御したいならclaude mcp addでの手動接続が向きます。認証はUSリモートサーバーならOAuthが最も手間が少なく、EUリージョンやAPIキー運用が必要な場合だけ--headerでの指定に切り替えます。既存のPostmanコレクションを持っているチームほど、まず/postman:setupかMinimal構成から試して、必要に応じてFullへ広げる順序が扱いやすいはずです。