API VEGA

Postman MCP Server

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

Postman также предоставляет сервер в виде npm package.

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

Postman MCP Server collection

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

  • Просмотра полного списка доступных инструментов во всех конфигурациях.

  • Подключения к удалённому серверу и тестирования его — [Full] и [Minimal].

  • Подключения к локальному серверу и его тестирования.

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

  • Minimal — (по умолчанию) Включает только базовые инструменты для операций в Postman. Подойдёт пользователям, которым нужно изменить всего один элемент Postman, например коллекции, рабочие пространства или окружения.

  • Code — Включает инструменты для генерации высококачественного, хорошо структурированного клиентского кода по публичным и внутренним определениям API. Подходит тем, кому нужно использовать API или получить контекст API для своих агентов.

  • Full — Включает все доступные инструменты Postman API (100+ инструментов). Подойдёт пользователям, работающим с продвинутыми сценариями совместной работы и функциями Enterprise Postman.

  • Learn — Выполняет поиск по Postman Docs по руководствам, туториалам и справочным материалам. Подходит агентам, которым нужно изучить возможности Postman, разобраться в концепциях API или найти обучающие ресурсы.

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

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

EU-удалённый сервер и локальный сервер поддерживают только аутентификацию через Postman API key.

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

Remote (любой хост MCP, совместимый с OAuth):

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

https://mcp.postman.com/minimal

Измените /minimal на /code или /mcp для режимов Code или Full. Для ЕС или аутентификации через API key передайте заголовок Authorization: Bearer <POSTMAN_API_KEY>.

Local:

npx @postman/postman-mcp-server

Добавьте --code или --full для режимов Code или Full. Установите переменную окружения POSTMAN_API_KEY.

Для инструкций по настройке под конкретную IDE смотрите приведённую ниже таблицу. Для получения дополнительной информации см. Postman MCP Server docs.

Поддерживаемые агенты и IDE

Агент / IDEУдалённыйЛокальный
Claude CodeДокументацияДокументация
Claude DesktopДокументацияДокументация
CursorДокументацияДокументация
VS CodeДокументацияДокументация
CodexДокументацияДокументация
Antigravity CLIДокументацияДокументация
GitHub Copilot CLIДокументацияДокументация
KiroДокументацияДокументация
Docker—Документация

Поддержка ЕС

Postman MCP Server поддерживает регион EU как для удалённых, так и локальных серверов:

  • Для потокового HTTP удалённый сервер доступен по адресам https://mcp.eu.postman.com/mcp (Полный), https://mcp.eu.postman.com/code, и https://mcp.eu.postman.com/minimal.

  • Для STDIO public package используйте флаг --region eu, или напрямую задайте переменную окружения POSTMAN_API_BASE_URL.

  • OAuth не поддерживается для EU-сервера. Удалённый EU-сервер поддерживает только аутентификацию через API key.

Примеры использования

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

  • Code synchronization — Поддерживайте синхронность вашего кода с вашими Postman Collections и спецификациями.

  • Collection management — Создавайте и помечайте коллекции, обновляйте документацию, добавляйте комментарии или выполняйте действия над несколькими коллекциями, не покидая редактор.

  • Workspace and environment management — Создавайте рабочие пространства и окружения, а также управляйте переменными окружения.

  • Automatic spec creation — Создавайте спецификации из вашего кода и используйте их для генерации коллекций.

  • Client code generation — Генерируйте готовый к использованию клиентский код, который потребляет API, следуя лучшим практикам и соглашениям проекта.

Docker

Для настройки и установки Docker смотрите DOCKER.md.

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

  • Смотрите [Add your MCP requests to your collections], чтобы узнать, как Postman можно использовать для выполнения MCP requests.

  • Посетите [Postman Community], чтобы поделиться тем, что вы построили, задать вопросы и получить помощь.

  • Вы можете подключаться как к удалённому, так и к локальному серверам и тестировать их с помощью [Postman MCP Server collection].

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

Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI