
Postman MCP Server
postmanlabs/postman-mcp-server · MCP server
Подключает агента к рабочим пространствам Postman: коллекции, спецификации и окружения, тестирование API, синхронизация кода с коллекциями и генерация клиентского кода.
Обзор
| Автор | |
|---|---|
| Репозиторий | postmanlabs/postman-mcp-server ↗ |
| Раздел | Разработка |
| Как подключается | Удалённый сервер (URL) · https://mcp.postman.com/minimal |
| Звёзды | 324 |
| Лицензия | Apache-2.0 |
| Обновлён | 21 октября 2026 г. |
| Что понадобится | аккаунт Postman; для локального запуска — API-ключ |
| Переменные и ключи |
|
Подключение
Выберите своё приложение и скопируйте готовую настройку. Значения в угловых скобках замените своими ключами.
claude mcp add --transport http postman https://mcp.postman.com/minimal
Claude Desktop: Настройки → Коннекторы → «Добавить свой коннектор» → вставьте адрес:
https://mcp.postman.com/minimal
Файл: .cursor/mcp.json
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/minimal"
}
}
}Файл: .vscode/mcp.json
{
"servers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/minimal"
}
}
}Файл: ~/.codex/config.toml
[mcp_servers.postman] command = "npx" args = ["-y", "mcp-remote", "https://mcp.postman.com/minimal"]
При первом подключении откроется окно входа в сервис (OAuth) — ключ вставлять не нужно.
Другой вариант · Node.js — npx
claude mcp add postman -e POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server
Файл: claude_desktop_config.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Файл: .cursor/mcp.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Файл: .vscode/mcp.json
{
"servers": {
"postman": {
"type": "stdio",
"command": "npx",
"args": [
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Файл: ~/.codex/config.toml
[mcp_servers.postman]
command = "npx"
args = ["@postman/postman-mcp-server"]
env = { POSTMAN_API_KEY = "<POSTMAN_API_KEY>" }README
оригинальный текст автора · только чтениеPostman MCP Server
The Postman MCP Server implements the Model Context Protocol (MCP) ↗ to connect AI agents and coding assistants — including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI — directly to your Postman workspaces, collections, specifications, and environments.
Postman also offers the server as an npm package ↗.
For the full installation guide with agent-specific setup, see Postman's MCP Server product page ↗.
Postman MCP Server collection
The Postman MCP Server collection ↗ is the quickest way to explore, test, and connect to the Postman MCP Server. Use it to:
- Browse the complete list of available tools across all configurations.
- Connect to and test the remote server — Full ↗ and Minimal ↗.
- Connect to and test the local server ↗.
Tool configurations
- Minimal — (Default) Only includes essential tools for basic Postman operations. Ideal for users who want to modify a single Postman element, such as collections, workspaces, or environments.
- Code — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. Ideal for users who need to consume APIs or get API context to their agents.
- Full — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
- Learn — Searches Postman Docs ↗ for guides, tutorials, and reference content. Ideal for agents who need to discover Postman features, look up API concepts, or find learning resources.
Authentication
For the best developer experience and fastest setup, use OAuth on the remote server (https://mcp.postman.com). OAuth is fully compliant with the MCP Authorization specification ↗ and requires no manual API key configuration.
The EU remote server and the local server support only Postman API key ↗ authentication.
Quick start
Remote (any OAuth-compatible MCP host):
Add this URL to your MCP host's configuration:
https://mcp.postman.com/minimal
Change /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer <POSTMAN_API_KEY> as a header.
Local:
npx @postman/postman-mcp-server
Add --code or --full for Code or Full mode. Set POSTMAN_API_KEY as an environment variable.
For IDE-specific setup instructions, see the following table. For more information, see the Postman MCP Server docs ↗.
Supported agents and IDEs
· Agent / IDE · Remote · Local ·
· Claude Code · Docs ↗ · Docs ↗ ·
· Claude Desktop · Docs ↗ · Docs ↗ ·
· Antigravity CLI · Docs ↗ · Docs ↗ ·
· GitHub Copilot CLI · Docs ↗ · Docs ↗ ·
· Docker · — · Docs ↗ ·
EU support
The Postman MCP Server supports the EU region for remote and local servers:
- For streamable HTTP, the remote server is available at
https://mcp.eu.postman.com/mcp(Full),https://mcp.eu.postman.com/code, andhttps://mcp.eu.postman.com/minimal. - For the STDIO public package, use the
--region euflag, or set thePOSTMAN_API_BASE_URLenvironment variable directly. - OAuth isn't supported for the EU server. The EU remote server only supports API key authentication.
Use cases
- API Testing — Continuously test your API using your Postman collection. Use the local server to test local APIs, as the remote server won't have network access to your workstation.
- Code synchronization — Keep your code in sync with your Postman Collections ↗ and specs.
- Collection management — Create and tag collections, update documentation, add comments, or perform actions across multiple collections without leaving your editor.
- Workspace and environment management — Create workspaces and environments, plus manage environment variables.
- Automatic spec creation — Create specs from your code and use them to generate collections.
- Client code generation — Generate production-ready client code that consumes APIs following best practices and project conventions.
Docker
For Docker setup and installation, see DOCKER.md ↗.
Contributing
Bug reports, tool requests, and documentation fixes are all welcome — see
The MCP tool definitions and the server implementation here are synced from Postman's
internal source of truth, so changes to files under src/ can't be merged in this
repository — but issues are how those changes get made, and we credit contributions
that ship. Documentation and repository tooling accept pull requests directly.
Found a security issue? See SECURITY.md ↗ — please don't open a public
issue.
Questions and support
- See Add your MCP requests to your collections ↗ to learn how to use Postman to perform MCP requests.
- Visit the Postman Community ↗ to share what you've built, ask questions, and get help.
- You can connect to both the remote and local servers and test them using the Postman MCP Server collection ↗.
- Report bugs and request tools in GitHub Issues ↗. See SUPPORT.md ↗ for which channel fits your question.
Keywords
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI
Вопросы и ответы
Что делает MCP-сервер Postman MCP Server?
Подключает агента к рабочим пространствам Postman: коллекции, спецификации и окружения, тестирование API, синхронизация кода с коллекциями и генерация клиентского кода.
Как подключить Postman MCP Server к Claude, Cursor или VS Code?
Postman MCP Server работает как удалённый сервер: достаточно добавить его адрес в настройки приложения. Готовые настройки для Claude Code, Claude Desktop, Cursor, VS Code и Codex — в блоке «Подключение» на этой странице.
Что нужно для работы Postman MCP Server?
аккаунт Postman; для локального запуска — API-ключ.
Postman MCP Server бесплатный?
Код сервера открыт на GitHub под лицензией Apache-2.0. Сам сервис, к которому он подключается, может быть платным — смотрите тарифы автора.
Что такое MCP-сервер?
MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-агенты подключаются к внешним программам и данным. MCP-сервер даёт модели новые инструменты: открыть страницу, прочитать файл, сделать запрос к базе или сервису.
Безопасно ли подключать MCP-серверы?
MCP-сервер выполняет действия от вашего имени, поэтому ставьте серверы из проверенных источников, давайте ключам минимальные права и проверяйте, что агент делает с файлами и сервисами. Не публикуйте ключи в открытых файлах настроек.