Cómo conectar Postman a Microsoft Copilot vía MCP

💡 ¿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 + Microsoft Copilot

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.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

POSTMAN_API_URL, POSTMAN_API_KEY

Paso 1 — Obtener credenciales

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.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Postman.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse