Postman API

npx add-mcp 'https://mcp.postman.com/minimal'

Postman MCP Server

Postman MCP Server реализует Model Context Protocol (MCP) для подключения AI-агентов и ассистентов для программирования — включая Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI и Gemini CLI — напрямую к вашим рабочим областям, коллекциям, спецификациям и окружениям Postman.

Postman также предлагает сервер в виде npm-пакета.

Полное руководство по установке с настройкой для конкретных агентов см. на странице продукта MCP Server в Postman.

---

Коллекция Postman MCP Server

Коллекция Postman MCP Server — это самый быстрый способ изучить, протестировать и подключиться к Postman MCP Server. Используйте её, чтобы:

• Просмотреть полный список доступных инструментов во всех конфигурациях.
• Подключиться и протестировать удалённый сервер — Full и Minimal.
• Подключиться и протестировать локальный сервер.

---

Конфигурации инструментов

• Minimal — (по умолчанию) включает только основные инструменты для базовых операций Postman. Идеально подходит для пользователей, которым нужно изменять один элемент Postman, например коллекции, рабочие области или окружения.
• Code — включает инструменты для генерации качественного, хорошо структурированного клиентского кода из публичных и внутренних определений API. Идеально подходит для пользователей, которым нужно потреблять API или передавать контекст API своим агентам.
• Full — включает все доступные инструменты Postman API (более 100 инструментов). Идеально подходит для пользователей, которые занимаются продвинутой совместной работой и используют корпоративные функции Postman.
• Learn — выполняет поиск по документации Postman для поиска руководств, учебных пособий и справочных материалов. Идеально подходит для агентов, которым нужно узнавать о функциях Postman, искать концепции API или находить учебные ресурсы.

---

Аутентификация

Для лучшего опыта разработчика и самой быстрой настройки используйте OAuth на удалённом сервере (https://mcp.postman.com). OAuth полностью соответствует спецификации авторизации MCP и не требует ручной настройки ключа API.

Сервер EU и локальный сервер поддерживают только аутентификацию с помощью ключа API Postman.

---

Быстрый старт

Удалённый сервер (любой MCP-хост, совместимый с OAuth):

Добавьте этот URL в конфигурацию вашего MCP-хоста:

https://mcp.postman.com/minimal

Замените /minimal на /code или /mcp для режима Code или Full. Для 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 напрямую.
• OAuth не поддерживается для сервера EU. Удалённый сервер EU поддерживает только аутентификацию по ключу API.

---

Варианты использования

• Тестирование API — непрерывно тестируйте свой API с помощью коллекции Postman. Используйте локальный сервер для тестирования локальных API, так как удалённый сервер не будет иметь сетевого доступа к вашей рабочей станции.
• Синхронизация кода — поддерживайте свой код в синхронизации с коллекциями Postman и спецификациями.
• Управление коллекциями — создавайте коллекции и добавляйте теги, обновляйте документацию, добавляйте комментарии или выполняйте действия с несколькими коллекциями, не покидая редактор.
• Управление рабочими областями и окружениями — создавайте рабочие области и окружения, а также управляйте переменными окружения.
• Автоматическое создание спецификаций — создавайте спецификации из своего кода и используйте их для генерации коллекций.
• Генерация клиентского кода — генерируйте готовый к продакшену клиентский код, который потребляет API, следуя лучшим практикам и соглашениям проекта.

---

Docker

Инструкции по настройке и установке Docker см. в DOCKER.md.

---

Участие в разработке

Отчёты об ошибках, запросы инструментов и исправления документации приветствуются — см. CONTRIBUTING.md.

• Сообщить об ошибке
• Запросить инструмент или изменение существующего
• Сообщить о проблеме с документацией

Определения MCP-инструментов и реализация сервера здесь синхронизированы с внутренним источником истины Postman, поэтому изменения файлов в src/ не могут быть объединены в этом репозитории — но именно через issues вносятся такие изменения, и мы указываем вклад участников, чьи изменения попадают в релиз. Документация и инструменты репозитория принимают pull request'ы напрямую.

Обнаружили проблему безопасности? См. SECURITY.md — пожалуйста, не открывайте публичный issue.

---

Вопросы и поддержка

• См. Добавление MCP-запросов в ваши коллекции, чтобы узнать, как использовать Postman для выполнения MCP-запросов.
• Посетите сообщество Postman, чтобы поделиться своими разработками, задать вопросы и получить помощь.
• Вы можете подключиться к удалённому и локальному серверам и протестировать их с помощью коллекции Postman MCP Server.
• Сообщайте об ошибках и запрашивайте инструменты в GitHub Issues. См. SUPPORT.md, чтобы узнать, какой канал подходит для вашего вопроса.

---

Ключевые слова

Model Context Protocol · MCP Server · Postman · AI-агенты · Claude Code · Cursor · VS Code · Спецификации · REST API · Тестирование API · TypeScript · OpenAPI