Как подключить Postman к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Postman, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Postman + Claude

Работайте с Postman из AI-агента: просматривайте рабочие пространства, коллекции, папки и запросы, окружения, спецификации Spec Hub и API, mock-серверы с журналами вызовов, мониторы и пользователей команды, ищите по всем ним, а после вашего подтверждения создавайте и изменяйте коллекции, запросы, окружения, моки, мониторы и спецификации.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

POSTMAN_API_URL, POSTMAN_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Postman с доступом к рабочим пространствам.

1. В Postman откройте аватар, Settings, API keys (https://go.postman.co/settings/me/api-keys) и нажмите Generate API Key. Дайте ключу имя и скопируйте его; он начинается с PMAK-.
2. Вставьте его в POSTMAN_API_KEY. Ключ отправляется в заголовке X-Api-Key и действует от имени вашего пользователя Postman: ИИ видит то же, что и вы, во всех рабочих пространствах.
3. Укажите в POSTMAN_API_URL адрес https://api.postman.com, или https://api.eu.postman.com, если ваша команда на тарифе Enterprise в регионе данных Postman EU.
4. Установите коннектор и выполните postman_get_me: он покажет ваш user id, команду и месячное использование API и подтвердит ключ.

id и uid: у большинства объектов есть id и uid (<owner user id>-<id>). Моки, мониторы и postman_update_collection принимают uid коллекции; postman_create_collection_request, postman_update_collection_request и postman_create_collection_folder простой id. Остальные инструменты чтения принимают любой из них.

Что он читает:

• Вы и ваша команда: postman_get_me, postman_list_workspaces (с createdBy, равным вашему user id, для «моих пространств»), postman_get_workspace (коллекции, окружения, моки, мониторы и API внутри), postman_list_team_users и postman_search, который находит запросы, коллекции, пространства, окружения, документы, flows или спецификации по тексту (по умолчанию только в вашей команде, публичные с ownership).
• Коллекции в Postman Collection Format v2.1: postman_list_collections, postman_get_collection (для больших сначала model=minimal), postman_get_collection_folder и postman_get_collection_request с методом, URL, заголовками, телом, авторизацией и скриптами.
• Окружения: postman_list_environments и postman_get_environment с ключом, значением, типом и флагом enabled каждой переменной.
• Проектирование API: Spec Hub через postman_list_specs, postman_get_spec, postman_list_spec_files, postman_get_spec_file и postman_get_spec_definition (полное разрешённое определение OpenAPI или AsyncAPI); API старого API Builder через postman_list_apis и postman_get_api.
• Моки: postman_list_mocks, postman_get_mock и postman_get_mock_call_logs, то есть что клиенты отправили моку и что он ответил (не больше 100 записей или 6,5 МБ за вызов; заголовки и тела только с include).
• Мониторы: postman_list_monitors и postman_get_monitor, где lastRun показывает последний статус, время и число пройденных и проваленных проверок.

Что он записывает после вашего подтверждения: postman_create_collection, postman_update_collection (имя, описание, переменные, авторизация; папки и запросы не меняются), postman_create_collection_folder, postman_create_collection_request, postman_update_collection_request (переданные поля заменяют прежние), postman_create_environment, postman_update_environment, postman_create_mock, postman_create_monitor, postman_run_monitor, postman_create_spec (OpenAPI, AsyncAPI, protobuf, GraphQL, Smithy) и postman_update_spec_file. ИИ говорит, что и в каком пространстве он создаст или изменит, и вызывает инструмент только после вашего согласия. Всё записанное видят участники рабочего пространства. Учтите:

• postman_run_monitor отправляет настоящие запросы коллекции в их API и расходует запуск мониторинга по вашему тарифу; postman_create_monitor затем делает это по расписанию.
• Новый мок публичен, если private не равно true.
• postman_update_environment принимает за один вызов операции JSON Patch только одного вида; ИИ сначала читает окружение, чтобы узнать позиции переменных (values[0] это /values/0).
• Postman API не умеет запускать коллекцию напрямую. Используйте монитор или Postman CLI в своей CI.

После установки активны все 35 инструментов, ни один не отключён, и ни один не удаляет рабочие пространства, коллекции, запросы, окружения, моки, мониторы или спецификации.

Секреты: переменные окружения типа secret возвращаются со значениями, если они общие, а переменные коллекции и авторизация запросов могут содержать токены. ИИ не повторяет такие значения, если вы не попросите.

Форматы данных: коллекции и запросы используют Postman Collection Format v2.1 (item содержит папки и запросы). Даты в ISO 8601 по UTC.

Пагинация: postman_list_workspaces, postman_list_apis, postman_list_specs, postman_list_monitors, postman_get_mock_call_logs и postman_search возвращают meta.nextCursor; ИИ вызывает снова с cursor, пока он не станет пустым. postman_list_collections листает через limit и offset; его фильтр name ищет точное имя и не сочетается с ними.

Ограничения: Postman разрешает 300 запросов в минуту на пользователя; postman_list_collections, postman_list_workspaces, postman_get_workspace и эндпоинты мониторов только 10 вызовов за 10 секунд. У каждого тарифа есть ещё месячная квота вызовов API, которую postman_get_me показывает в operations. 429 с rateLimited значит подождать (Retry-After указывает секунды); serviceLimitExhausted значит, что квота тарифа исчерпана и нужен администратор команды.

Типичные ошибки: 401 означает, что ключ неверен, просрочен или отозван либо относится к другому региону данных (проверьте POSTMAN_API_URL). 403 означает, что ваша роль в этом пространстве не разрешает вызов. 404 означает, что id не существует или он вам не виден. 400 называет неверное поле, например id коллекции там, где нужен uid.

Коннектор ничего не удаляет и не работает с форками и pull requests, комментариями, тегами, governance, каталогом API, приватной сетью API, SCIM, журналами аудита, биллингом и записью в старый API Builder.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Postman, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Какие коллекции есть в нашем рабочем пространстве „Payments“ и какие запросы содержит коллекция Checkout?»
• «Прошёл ли ночной монитор API заказов последний запуск? Сколько проверок провалилось?»
• «Покажи последние 20 вызовов нашего mock-сервера checkout, получивших 404.»
• «Добавь в коллекцию Payments POST-запрос „Create refund“ с JSON-телом для orderId и amount.»
• «Дай мне разрешённое определение OpenAPI спецификации Orders и перечисли её эндпоинты.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot