Postman a MCP: workspaces, colecciones, peticiones, entornos, specs, mocks y monitores en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Postman, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Postman

Trabaja con Postman desde tu agente de IA: recorre workspaces, colecciones, carpetas y peticiones, entornos, especificaciones de Spec Hub y APIs, servidores mock con sus registros de llamadas, monitores y usuarios del equipo, busca en todos ellos, y crea o modifica colecciones, peticiones, entornos, mocks, monitores y specs tras tu confirmación.

Configuración

La configuración lleva unos 2 minutos. Necesitas una cuenta de Postman con acceso a los workspaces.

1. En Postman abre tu avatar, Settings, API keys (https://go.postman.co/settings/me/api-keys) y haz clic en Generate API Key. Ponle un nombre y copia la clave; empieza por PMAK-.
2. Pégala en POSTMAN_API_KEY. Se envía en la cabecera X-Api-Key y actúa como tu usuario de Postman: la IA ve lo que tú ves en cada workspace.
3. Pon POSTMAN_API_URL en https://api.postman.com, o en https://api.eu.postman.com si tu equipo tiene un plan Enterprise en la región de datos de la UE de Postman.
4. Instala el conector y ejecuta postman_get_me: muestra tu user id, tu equipo y el uso mensual de la API, y confirma la clave.

Ids y uids: la mayoría de los objetos tienen un id y un uid (<owner user id>-<id>). Los mocks, los monitores y postman_update_collection usan el uid de la colección; postman_create_collection_request, postman_update_collection_request y postman_create_collection_folder usan el id simple. Las demás lecturas aceptan cualquiera de los dos.

Qué lee:

• Tú y tu equipo: postman_get_me, postman_list_workspaces (con createdBy igual a tu user id para "mis workspaces"), postman_get_workspace (las colecciones, entornos, mocks, monitores y APIs que contiene), postman_list_team_users y postman_search, que encuentra peticiones, colecciones, workspaces, entornos, documentos, flows o specs por texto (por defecto solo de tu equipo, los públicos con ownership).
• Colecciones en Postman Collection Format v2.1: postman_list_collections, postman_get_collection (primero model=minimal para una grande), postman_get_collection_folder y postman_get_collection_request con método, URL, cabeceras, cuerpo, autenticación y scripts.
• Entornos: postman_list_environments y postman_get_environment con clave, valor, tipo y estado activo de cada variable.
• Diseño de APIs: Spec Hub con postman_list_specs, postman_get_spec, postman_list_spec_files, postman_get_spec_file y postman_get_spec_definition (la definición OpenAPI o AsyncAPI completa y resuelta); las APIs del antiguo API Builder con postman_list_apis y postman_get_api.
• Mocks: postman_list_mocks, postman_get_mock y postman_get_mock_call_logs, lo que los clientes enviaron al mock y lo que respondió (como mucho 100 registros o 6,5 MB por llamada; cabeceras y cuerpos solo con include).
• Monitores: postman_list_monitors y postman_get_monitor, cuyo lastRun muestra el último estado, las horas y las aserciones superadas y fallidas.

Qué escribe, tras tu confirmación: postman_create_collection, postman_update_collection (nombre, descripción, variables, autenticación; carpetas y peticiones no cambian), postman_create_collection_folder, postman_create_collection_request, postman_update_collection_request (los campos indicados sustituyen a los anteriores), postman_create_environment, postman_update_environment, postman_create_mock, postman_create_monitor, postman_run_monitor, postman_create_spec (OpenAPI, AsyncAPI, protobuf, GraphQL, Smithy) y postman_update_spec_file. La IA dice qué va a crear o cambiar y en qué workspace, y llama a la herramienta tras tu sí. Todo lo que escribe es visible para los miembros del workspace. Ten en cuenta:

• postman_run_monitor envía las peticiones reales de la colección a sus APIs y consume una ejecución de monitorización de tu plan; postman_create_monitor lo sigue haciendo según su programación.
• Un mock nuevo es público salvo que private sea true.
• postman_update_environment acepta operaciones JSON Patch de un solo tipo por llamada; la IA lee antes el entorno para conocer las posiciones de las variables (values[0] es /values/0).
• La API de Postman no puede ejecutar una colección directamente. Usa un monitor o la Postman CLI en tu propia CI.

Las 35 herramientas están activas tras la instalación; ninguna está desactivada y ninguna elimina workspaces, colecciones, peticiones, entornos, mocks, monitores ni specs.

Secretos: las variables de entorno de tipo secret vuelven con su valor cuando están compartidas, y las variables de colección o la autenticación de las peticiones pueden contener tokens. La IA no repite esos valores salvo que se lo pidas.

Formatos de datos: colecciones y peticiones usan Postman Collection Format v2.1 (item contiene carpetas y peticiones). Las fechas son ISO 8601 en UTC.

Paginación: postman_list_workspaces, postman_list_apis, postman_list_specs, postman_list_monitors, postman_get_mock_call_logs y postman_search devuelven meta.nextCursor; la IA vuelve a llamar con cursor hasta que llega vacío. postman_list_collections pagina con limit y offset; su filtro name busca el nombre exacto y no se combina con ellos.

Límites: Postman permite 300 peticiones por minuto y usuario; postman_list_collections, postman_list_workspaces, postman_get_workspace y los endpoints de monitores solo 10 llamadas en 10 segundos. Cada plan tiene además una cuota mensual de llamadas a la API, que postman_get_me muestra en operations. Un 429 con rateLimited significa esperar (Retry-After indica los segundos); serviceLimitExhausted significa que la cuota del plan se ha agotado y un admin del equipo tiene que actuar.

Errores comunes: 401 indica que la clave es incorrecta, ha caducado o se ha revocado, o pertenece a la otra región de datos (revisa POSTMAN_API_URL). 403 indica que tu rol en ese workspace no permite la llamada. 404 indica que el id no existe o que no puedes verlo. 400 nombra el campo erróneo, por ejemplo un id de colección donde hace falta un uid.

El conector no elimina nada y no cubre forks y pull requests, comentarios, etiquetas, gobernanza, el catálogo de APIs, la red privada de APIs, SCIM, registros de auditoría, facturación ni las escrituras del antiguo API Builder.

Requisitos previos: POSTMAN_API_URL, POSTMAN_API_KEY

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Postman e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué colecciones hay en nuestro workspace Payments y qué peticiones contiene la colección Checkout?"
• "¿Superó el monitor nocturno de la API de pedidos su última ejecución? ¿Cuántas aserciones fallaron?"
• "Muéstrame las últimas 20 llamadas a nuestro servidor mock de checkout que recibieron un 404."
• "Añade a la colección Payments una petición POST 'Create refund' con un cuerpo JSON para orderId y amount."
• "Dame la definición OpenAPI resuelta de la spec Orders y enumera sus endpoints."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT