Postman API
公式Postman APIとやり取りするためのMCPサーバーで、APIキーが必要です。
Postman API MCPで何ができますか?
- Manage collections — アシスタントに依頼して、エディタから直接Postmanコレクションとそのドキュメントを作成、タグ付け、更新できます。
- Generate client code — API定義から、ベストプラクティスとプロジェクトの規約に従った本番対応のクライアントコードをリクエストできます。
- Create specs from code — コードベースからAPI仕様を生成し、それらをPostmanコレクションに変換するようアシスタントに依頼できます。
- Manage environments — IDEから離れることなく、ワークスペースや環境を作成し、環境変数を管理するようアシスタントに指示できます。
- Run API tests — ローカルサーバーを使用して、ローカルエンドポイントを含むPostmanコレクションに対してAPIを継続的にテストできます。
ホスト型 MCP サーバー
npx add-mcp 'https://mcp.postman.com/minimal'Claude Code、Codex、Cursor などにインストールできます
ドキュメント
Postman MCP サーバー
Postman MCP サーバーは、Model Context Protocol (MCP) を実装し、AIエージェントやコーディングアシスタント(Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI、Gemini CLI など)をPostmanのワークスペース、コレクション、仕様、環境に直接接続します。
Postmanはこのサーバーを npm パッケージ としても提供しています。
エージェント別のセットアップを含む完全なインストールガイドについては、Postmanの MCP サーバー製品ページ を参照してください。
Postman MCP サーバーコレクション
Postman MCP サーバーコレクション は、Postman MCP サーバーを探索、テスト、接続するための最も迅速な方法です。以下の用途に使用します:
ツール設定
- Minimal —(デフォルト)基本的なPostman操作に必要な必須ツールのみを含みます。コレクション、ワークスペース、環境など、単一のPostman要素を変更したいユーザーに最適です。
- Code — 公開および内部API定義から高品質で整理されたクライアントコードを生成するツールを含みます。APIを利用したり、APIコンテキストをエージェントに提供したりする必要があるユーザーに最適です。
- Full — 利用可能なすべてのPostman APIツール(100以上のツール)を含みます。高度なコラボレーションやPostmanのエンタープライズ機能を活用するユーザーに最適です。
- Learn — Postman Docs でガイド、チュートリアル、リファレンスコンテンツを検索します。Postmanの機能を発見したり、APIの概念を調べたり、学習リソースを見つけたりする必要があるエージェントに最適です。
認証
最良の開発者体験と最速のセットアップのために、リモートサーバーでは OAuth を使用してください(https://mcp.postman.com)。OAuthは MCP 認可仕様 に完全準拠しており、手動での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 サーバードキュメント を参照してください。
対応エージェントとIDE
| エージェント / IDE | リモート | ローカル |
|---|---|---|
| Claude Code | Docs | Docs |
| Claude Desktop | Docs | Docs |
| Cursor | Docs | Docs |
| VS Code | Docs | Docs |
| Codex | Docs | Docs |
| Antigravity CLI | Docs | Docs |
| GitHub Copilot CLI | Docs | Docs |
| Kiro | Docs | Docs |
| Docker | — | Docs |
EUサポート
Postman MCP サーバーは、リモートおよびローカルサーバーでEUリージョンをサポートしています:
- streamable 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 コレクション と仕様に合わせてコードを同期します。
- コレクション管理 — エディタを離れることなく、コレクションの作成やタグ付け、ドキュメントの更新、コメントの追加、複数コレクションにわたる操作を実行します。
- ワークスペースと環境の管理 — ワークスペースと環境を作成し、環境変数を管理します。
- 自動仕様作成 — コードから仕様を作成し、それを使用してコレクションを生成します。
- クライアントコード生成 — ベストプラクティスとプロジェクト規約に従ってAPIを利用する、本番環境対応のクライアントコードを生成します。
Docker
Dockerのセットアップとインストールについては、DOCKER.md を参照してください。
コントリビューション
バグ報告、ツールリクエスト、ドキュメント修正はすべて歓迎します — CONTRIBUTING.md を参照してください。
ここにあるMCPツール定義とサーバー実装は、Postmanの内部ソースから同期されているため、src/ 配下のファイルへの変更はこのリポジトリではマージできません。ただし、問題報告がそれらの変更を行う方法であり、出荷されたコントリビューションにはクレジットを付与します。ドキュメントとリポジトリツールはプルリクエストを直接受け付けています。
セキュリティの問題を発見しましたか? SECURITY.md を参照してください — 公開のissueを開かないでください。
質問とサポート
- MCPリクエストをコレクションに追加する を参照して、Postmanを使用してMCPリクエストを実行する方法を学びます。
- Postman コミュニティ にアクセスして、作成したものを共有したり、質問したり、ヘルプを得たりできます。
- Postman MCP サーバーコレクション を使用して、リモートサーバーとローカルサーバーの両方に接続してテストできます。
- GitHub Issues でバグを報告し、ツールをリクエストします。どのチャネルが質問に適しているかについては、SUPPORT.md を参照してください。
キーワード
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI