Postman MCP Server

Postman MCP Server

Postman MCP Server は、Model Context Protocol（MCP）を実装し、Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI、Gemini CLI などの AI エージェントやコーディングアシスタントを、Postman のワークスペース、コレクション、仕様、環境に直接接続します。

Postman はサーバーを npm パッケージとしても提供しています。

エージェントごとの設定を含む完全なインストールガイドについては、Postman のMCP Server 製品ページをご覧ください。

---

Postman MCP Server コレクション

Postman MCP Server コレクションは、Postman MCP Server をすばやく確認、テスト、接続するための最適な方法です。以下の用途に利用できます。

• すべての設定で利用できるツールの一覧を確認します。
• リモートサーバーに接続してテストします — Full および Minimal。
• ローカルサーバーに接続してテストします。

---

ツールの設定

• Minimal —（デフォルト）基本的な Postman 操作に必要な必須ツールのみを含みます。コレクション、ワークスペース、環境など、単一の Postman 要素を変更したいユーザーに最適です。
• Code — パブリックおよび社内の API 定義から、高品質で整理されたクライアントコードを生成するツールを含みます。API を利用したり、エージェントに API のコンテキストを提供したりする必要があるユーザーに最適です。
• Full — 利用可能なすべての Postman API ツール（100 以上）を含みます。高度なコラボレーションや Postman の Enterprise 機能を利用するユーザーに最適です。
• Learn — Postman Docsを検索して、ガイド、チュートリアル、リファレンスコンテンツを見つけます。Postman の機能を探したり、API の概念を調べたり、学習リソースを見つけたりする必要があるエージェントに最適です。

---

認証

開発者にとって最適な環境を実現し、設定を最速で完了するには、リモートサーバー（https://mcp.postman.com）で OAuth を使用してください。OAuth は MCP Authorization 仕様に完全に準拠しており、API キーを手動で設定する必要はありません。

EU リモートサーバーとローカルサーバーでは、Postman API キー認証のみをサポートしています。

---

クイックスタート

リモート（OAuth 対応の MCP ホスト）：

この URL を MCP ホストの設定に追加します。

https://mcp.postman.com/minimal

Code モードまたは Full モードを使用するには、/minimal を /code または /mcp に変更します。EU または API キー認証の場合は、ヘッダーとして Authorization: Bearer <POSTMAN_API_KEY> を渡してください。

ローカル：

npx @postman/postman-mcp-server

Code モードまたは Full モードを使用するには、--code または --full を追加します。環境変数として POSTMAN_API_KEY を設定してください。

IDE ごとの設定手順については、以下の表をご覧ください。詳細は、Postman MCP Server のドキュメントをご覧ください。

---

対応するエージェントと IDE

エージェント／IDE	リモート	ローカル
Claude Code	ドキュメント	ドキュメント
Claude Desktop	ドキュメント	ドキュメント
Cursor	ドキュメント	ドキュメント
VS Code	ドキュメント	ドキュメント
Codex	ドキュメント	ドキュメント
Antigravity CLI	ドキュメント	ドキュメント
GitHub Copilot CLI	ドキュメント	ドキュメント
Kiro	ドキュメント	ドキュメント
Docker	—	ドキュメント

---

EU のサポート

Postman MCP Server は、リモートサーバーとローカルサーバーで EU リージョンをサポートしています。

• ストリーミング可能な HTTP の場合、リモートサーバーは https://mcp.eu.postman.com/mcp（Full）、https://mcp.eu.postman.com/code、および https://mcp.eu.postman.com/minimal で利用できます。
• STDIO パブリックパッケージの場合は、--region eu フラグを使用するか、POSTMAN_API_BASE_URL 環境変数を直接設定してください。
• EU サーバーでは OAuth はサポートされていません。EU リモートサーバーは API キー認証のみをサポートしています。

---

ユースケース

• API テスト — Postman コレクションを使用して、API を継続的にテストします。ローカル API のテストにはローカルサーバーを使用してください。リモートサーバーからはワークステーションのネットワークにアクセスできません。
• コードの同期 — コードを Postman Collections および仕様と同期させます。
• コレクション管理 — エディターを離れることなく、コレクションの作成やタグ付け、ドキュメントの更新、コメントの追加、複数のコレクションに対する操作を行えます。
• ワークスペースと環境の管理 — ワークスペースや環境を作成し、環境変数を管理します。
• 仕様の自動作成 — コードから仕様を作成し、それを使用してコレクションを生成します。
• クライアントコードの生成 — ベストプラクティスとプロジェクトの規約に従って API を利用する、本番環境で使用可能なクライアントコードを生成します。

---

Docker

Docker のセットアップとインストールについては、DOCKER.md をご覧ください。

---

コントリビューション

バグ報告、ツールのリクエスト、ドキュメントの修正を歓迎します。CONTRIBUTING.md をご覧ください。

• バグを報告する
• ツールやツールの変更をリクエストする
• ドキュメントの問題を報告する

ここにある MCP ツールの定義とサーバーの実装は、Postman の内部にある信頼できる情報源から同期されています。そのため、このリポジトリでは src/ 配下のファイルへの変更をマージできません。ただし、変更は課題を通じて実現され、リリースされた貢献はクレジットに記載されます。ドキュメントとリポジトリのツールについては、プルリクエストを直接受け付けています。

セキュリティ上の問題を見つけた場合は、SECURITY.md をご覧ください。公開の課題は作成しないでください。

---

質問とサポート

• Postman を使用して MCP リクエストを行う方法については、コレクションに MCP リクエストを追加するをご覧ください。
• Postman Community で、作成したものを共有したり、質問したり、サポートを受けたりできます。
• リモートサーバーとローカルサーバーの両方に接続し、Postman MCP Server collection を使用してテストできます。
• GitHub Issues でバグを報告したり、ツールをリクエストしたりできます。質問に適した窓口については、SUPPORT.md をご覧ください。

---

キーワード

Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · 仕様 · REST API · API テスト · TypeScript · OpenAPI