Postman API

oficial

Un servidor MCP para interactuar con la API de Postman, que requiere una clave de API.

GitHub

316

Prueba este MCPPatrocinado

¿Qué puedes hacer con Postman API MCP?

Administrar colecciones — Pídele a tu asistente que cree, etiquete o actualice colecciones de Postman y su documentación directamente desde tu editor.
Generar código de cliente — Solicita código de cliente listo para producción a partir de tus definiciones de API, siguiendo las mejores prácticas y convenciones del proyecto.
Crear especificaciones a partir de código — Haz que tu asistente genere especificaciones de API desde tu base de código y las convierta en colecciones de Postman.
Administrar entornos — Indícale a tu asistente que cree espacios de trabajo y entornos, y gestione variables de entorno sin salir de tu IDE.
Ejecutar pruebas de API — Usa el servidor local para probar continuamente tus APIs contra tus colecciones de Postman, incluidos los endpoints locales.

Servidor MCP alojado

npx add-mcp 'https://mcp.postman.com/minimal'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Postman MCP Server

El Postman MCP Server implementa el Model Context Protocol (MCP) para conectar agentes de IA y asistentes de codificación — incluyendo Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI y Gemini CLI — directamente con tus espacios de trabajo, colecciones, especificaciones y entornos de Postman.

Postman también ofrece el servidor como un paquete npm.

Para la guía de instalación completa con configuración específica por agente, consulta la página de producto del MCP Server de Postman.

Colección Postman MCP Server

La colección Postman MCP Server es la forma más rápida de explorar, probar y conectarte al Postman MCP Server. Úsala para:

Explorar la lista completa de herramientas disponibles en todas las configuraciones.
Conectarte y probar el servidor remoto — Full y Minimal.
Conectarte y probar el servidor local.

Configuraciones de herramientas

Minimal — (Predeterminado) Solo incluye herramientas esenciales para operaciones básicas de Postman. Ideal para usuarios que quieren modificar un solo elemento de Postman, como colecciones, espacios de trabajo o entornos.
Code — Incluye herramientas para generar código de cliente de alta calidad y bien organizado a partir de definiciones de API públicas e internas. Ideal para usuarios que necesitan consumir APIs o proporcionar contexto de API a sus agentes.
Full — Incluye todas las herramientas de Postman API disponibles (más de 100 herramientas). Ideal para usuarios que participan en colaboración avanzada y funciones Enterprise de Postman.
Learn — Busca en Postman Docs guías, tutoriales y contenido de referencia. Ideal para agentes que necesitan descubrir funciones de Postman, consultar conceptos de API o encontrar recursos de aprendizaje.

Autenticación

Para la mejor experiencia de desarrollo y la configuración más rápida, usa OAuth en el servidor remoto (https://mcp.postman.com). OAuth es totalmente compatible con la especificación de autorización MCP y no requiere configuración manual de claves de API.

El servidor remoto de la UE y el servidor local solo admiten autenticación mediante clave de API de Postman.

Inicio rápido

Remoto (cualquier host MCP compatible con OAuth):

Añade esta URL a la configuración de tu host MCP:

https://mcp.postman.com/minimal

Cambia /minimal a /code o /mcp para el modo Code o Full. Para autenticación con UE o clave de API, pasa Authorization: Bearer <POSTMAN_API_KEY> como encabezado.

Local:

npx @postman/postman-mcp-server

Añade --code o --full para el modo Code o Full. Establece POSTMAN_API_KEY como variable de entorno.

Para instrucciones de configuración específicas por IDE, consulta la siguiente tabla. Para más información, consulta la documentación del Postman MCP Server.

Agentes e IDEs compatibles

Agente / IDE	Remoto	Local
Claude Code	Documentación	Documentación
Claude Desktop	Documentación	Documentación
Cursor	Documentación	Documentación
VS Code	Documentación	Documentación
Codex	Documentación	Documentación
Antigravity CLI	Documentación	Documentación
GitHub Copilot CLI	Documentación	Documentación
Kiro	Documentación	Documentación
Docker	—	Documentación

Soporte para la UE

El Postman MCP Server admite la región de la UE para servidores remotos y locales:

Para HTTP transmisible, el servidor remoto está disponible en https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code y https://mcp.eu.postman.com/minimal.
Para el paquete público STDIO, usa la bandera --region eu o establece la variable de entorno POSTMAN_API_BASE_URL directamente.
OAuth no es compatible con el servidor de la UE. El servidor remoto de la UE solo admite autenticación mediante clave de API.

Casos de uso

Pruebas de API — Prueba tu API de forma continua usando tu colección de Postman. Usa el servidor local para probar APIs locales, ya que el servidor remoto no tendrá acceso de red a tu estación de trabajo.
Sincronización de código — Mantén tu código sincronizado con tus colecciones de Postman y especificaciones.
Gestión de colecciones — Crea y etiqueta colecciones, actualiza documentación, añade comentarios o realiza acciones en varias colecciones sin salir de tu editor.
Gestión de espacios de trabajo y entornos — Crea espacios de trabajo y entornos, además de gestionar variables de entorno.
Creación automática de especificaciones — Crea especificaciones a partir de tu código y úsalas para generar colecciones.
Generación de código de cliente — Genera código de cliente listo para producción que consuma APIs siguiendo las mejores prácticas y convenciones del proyecto.

Docker

Para la configuración e instalación de Docker, consulta DOCKER.md.

Contribuciones

Los informes de errores, las solicitudes de herramientas y las correcciones de documentación son bienvenidos — consulta CONTRIBUTING.md.

Las definiciones de herramientas MCP y la implementación del servidor aquí se sincronizan desde la fuente de verdad interna de Postman, por lo que los cambios en archivos bajo src/ no se pueden fusionar en este repositorio — pero los issues son cómo se realizan esos cambios, y reconocemos las contribuciones que se publican. La documentación y las herramientas del repositorio aceptan pull requests directamente.

¿Encontraste un problema de seguridad? Consulta SECURITY.md — por favor, no abras un issue público.

Preguntas y soporte

Consulta Añade tus solicitudes MCP a tus colecciones para aprender a usar Postman para realizar solicitudes MCP.
Visita la Comunidad de Postman para compartir lo que has creado, hacer preguntas y obtener ayuda.
Puedes conectarte tanto al servidor remoto como al local y probarlos usando la colección Postman MCP Server.
Informa de errores y solicita herramientas en GitHub Issues. Consulta SUPPORT.md para saber qué canal se adapta a tu pregunta.

Palabras clave

Model Context Protocol · MCP Server · Postman · Agentes de IA · Claude Code · Cursor · VS Code · Especificaciones · REST API · Pruebas de API · TypeScript · OpenAPI