Postman MCP Server: коллекции и тесты API в Claude Code и Cursor

postmanlabs/postman-mcp-server· Проверено 12.11.2026· 329на GitHub

Подключает агента к рабочим пространствам Postman: коллекции, окружения, спецификации и моки, запуск коллекции с тестами и генерация клиентского кода к API.

3 реализации:

Удалённый сервер Postman со входом через OAuth, ключ API не нужен; путь /minimal, /code или /mcp выбирает набор инструментов.

Как подключить

Что сделать до подключения

Аккаунт Postman

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http postman https://mcp.postman.com/minimal

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.postman]
url = "https://mcp.postman.com/minimal"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "postman": {
      "url": "https://mcp.postman.com/minimal"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com/minimal"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "postman": {
      "httpUrl": "https://mcp.postman.com/minimal"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "postman": {
      "httpUrl": "https://mcp.postman.com/minimal"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "postman": {
        "type": "remote",
        "url": "https://mcp.postman.com/minimal"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.postman.com/minimal

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "postman": {
      "url": "https://mcp.postman.com/minimal"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

getWorkspacesпоказывает рабочие пространства

searchPostmanElementsищет запросы, коллекции, спецификации

getCollectionsпоказывает коллекции

getCollectionчитает коллекцию

createCollectionсоздаёт коллекцию

createCollectionRequestдобавляет запрос в коллекцию

updateCollectionRequestменяет запрос

duplicateCollectionкопирует коллекцию в другое пространство

runCollectionзапускает коллекцию с тестами

getEnvironmentsпоказывает окружения

createEnvironmentсоздаёт окружение

putEnvironmentзаменяет переменные окружения

createSpecсоздаёт спецификацию API

getSpecDefinitionчитает описание спецификации

generateCollectionстроит коллекцию по спецификации

generateSpecFromCollectionстроит OpenAPI по коллекции

syncCollectionWithSpecсверяет коллекцию со спецификацией

syncSpecWithCollectionсверяет спецификацию с коллекцией

createMockсоздаёт мок-сервер

publishMockоткрывает мок-сервер публично

Показано 20 из 42.

Тот же сервер на вашем компьютере через npx по ключу API: достаёт до API на localhost, флаги --code и --full меняют набор, --region eu включает европейский регион.

Как подключить

Что сделать до подключения

Node.js с командой npx

Ключ API Postman

POSTMAN_API_KEY

Postman → Settings → API keys (postman.postman.co/settings/me/api-keys) → Generate API Key

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'POSTMAN_API_KEY=<ключ API Postman>' --transport stdio postman-mcp-server \
  -- npx @postman/postman-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.postman-mcp-server]
command = "npx"
args = ["@postman/postman-mcp-server"]

[mcp_servers.postman-mcp-server.env]
POSTMAN_API_KEY = "<ключ API Postman>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "postman-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "postman-mcp-server": {
        "type": "local",
        "command": ["npx", "@postman/postman-mcp-server"],
        "environment": {
          "POSTMAN_API_KEY": "<ключ API Postman>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": ["@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "<ключ API Postman>"
      }
    }
  }
}

Инструменты сервера

getWorkspacesпоказывает рабочие пространства

getCollectionчитает коллекцию

createCollectionRequestдобавляет запрос в коллекцию

runCollectionзапускает коллекцию с тестами

getEnvironmentsпоказывает окружения

generateSpecFromCollectionстроит OpenAPI по коллекции

getCodeGenerationInstructionsвыдаёт правила генерации кода (--code)

getRequestCodeContextсобирает контекст запроса для кода (--code)

Показано 8 из 42.

Без аккаунта Postman: запускает коллекцию из файла или по ссылке через Newman и отдаёт итог тестов с ошибками и таймингами.

Как подключить

Что сделать до подключения

Node.js и pnpm

Склонировать репозиторий, выполнить pnpm install и pnpm build

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-postman \
  -- node '<путь к mcp-postman>/build/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-postman]
command = "node"
args = ["<путь к mcp-postman>/build/index.js"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-postman": {
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-postman": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-postman": {
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-postman": {
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-postman": {
        "type": "local",
        "command": ["node", "<путь к mcp-postman>/build/index.js"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-postman": {
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-postman": {
      "command": "node",
      "args": ["<путь к mcp-postman>/build/index.js"]
    }
  }
}

Инструменты сервера

run-collectionпрогоняет коллекцию через Newman

Что попросить агента

«Запусти коллекцию <название> на окружении <окружение> и скажи, какие тесты упали»Агент найдёт коллекцию через getCollections, окружение через getEnvironments и запустит runCollection

«Run the Postman collection at <путь к collection.json> and tell me if all tests passed»MCP Postman вызовет run-collection и перескажет итог: сколько тестов прошло, какие упали

«Сделай OpenAPI-спецификацию по коллекции <название>»Агент вызовет generateSpecFromCollection и проверит результат через getSpecDefinition

«Создай коллекцию по нашей спецификации <название> и держи их в паре»Агент вызовет generateCollection, а после правок — syncCollectionWithSpec

«Напиши клиент на TypeScript для API из коллекции <название>»Локальный сервер с --code вызовет getCodeGenerationInstructions и getRequestCodeContext и напишет код

Для каких задач

Прогнать тесты коллекции и разобрать, какие проверки упали

Собрать коллекцию по спецификации OpenAPI или спецификацию по коллекции

Держать коллекцию и спецификацию в соответствии с кодом

Завести рабочее пространство, окружение и переменные

Написать клиентский код к API из коллекции Postman

Ограничения

Удалённый сервер не видит ваш компьютер: API на localhost тестируйте локальным сервером

Европейский регион работает только с ключом API, вход через OAuth там не поддерживается

Теги в Postman доступны только на тарифе Enterprise: на Free, Basic и Professional getTaggedEntities отвечает 404

MCP Postman на Newman — проект одного автора, 84 звезды, ставится только из исходников

Если не работает

Тесты не достают до API на localhost

Удалённый сервер не имеет сетевого доступа к вашему компьютеру: подключите локальный сервер через npx @postman/postman-mcp-server.

Европейский удалённый сервер не принимает вход через OAuth

EU-сервер на mcp.eu.postman.com работает только с ключом API: передайте его заголовком Authorization: Bearer <POSTMAN_API_KEY>.

Локальный сервер сразу завершается с ошибкой про переменные окружения

Для STDIO-режима обязателен POSTMAN_API_KEY: задайте его в env конфига клиента.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Postman MCP Server (удалённый)разработчик сервиса	Postman	329	HTTP	вход	42	12 ноября 2026
Postman MCP Server (локальный)разработчик сервиса	Postman	329	локально	токен	42	12 ноября 2026
MCP Postman (Newman)	shannonlal	84	локально	не нужен	1	20 сентября 2026

Частые вопросы

Чем отличаются режимы Minimal, Code и Full?

Minimal включён по умолчанию и даёт 42 основных инструмента для коллекций, окружений, спецификаций и моков. Code нужен для генерации клиентского кода по API. Full включает все инструменты Postman API, их больше 100.

Нужен ли ключ API Postman?

Для удалённого сервера на mcp.postman.com — нет, вход через OAuth. Локальному серверу и европейскому удалённому нужен POSTMAN_API_KEY: у удалённого он передаётся заголовком Authorization: Bearer <ключ>.

Можно запустить коллекцию без аккаунта Postman?

Да, через MCP Postman на Newman: инструмент run-collection берёт коллекцию из файла или по ссылке, а также файлы окружения и глобальных переменных, и возвращает число пройденных и упавших тестов.

Есть ли сервер в Docker?

Есть образ mcp/postman: docker run -i -e POSTMAN_API_KEY="<ключ>" mcp/postman. В Docker Desktop сервер ставится из Docker MCP Hub кнопкой Add to Docker Desktop.

Есть ли у Postman свой MCP-сервер?

Есть, его ведёт Postman в репозитории postmanlabs/postman-mcp-server: удалённый на https://mcp.postman.com и пакет npm @postman/postman-mcp-server. Инструменты синхронизируются из внутреннего кода Postman, поэтому правки в src через pull request не принимаются.

Как подключить Postman MCP к Claude Code?

Добавьте в клиент адрес https://mcp.postman.com/minimal и войдите через OAuth; для режима Full замените /minimal на /mcp. Локальный вариант — npx @postman/postman-mcp-server с POSTMAN_API_KEY, команды есть во вкладке Claude Code в блоке «Как подключить».

Работает ли сервер из России?

Нужен аккаунт Postman: удалённый сервер работает на mcp.postman.com, локальный ходит в api.postman.com с вашим ключом, а вариант на Newman запускается на вашем компьютере без аккаунта.

Postman MCP Server: коллекции и тесты API в Claude Code и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы