Postman API
Um servidor MCP para interagir com a Postman API, exigindo uma chave de API.
Documentação
Servidor MCP do Postman
O Servidor MCP do Postman implementa o Model Context Protocol (MCP) para conectar agentes de IA e assistentes de codificação — incluindo Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI e Gemini CLI — diretamente aos seus workspaces, coleções, especificações e ambientes do Postman.
O Postman também oferece o servidor como um pacote npm.
Para o guia completo de instalação com configuração específica por agente, consulte a página do produto Servidor MCP do Postman.
Coleção do Servidor MCP do Postman
A coleção do Servidor MCP do Postman é a maneira mais rápida de explorar, testar e conectar-se ao Servidor MCP do Postman. Use-a para:
- Navegar pela lista completa de ferramentas disponíveis em todas as configurações.
- Conectar-se e testar o servidor remoto — Full e Minimal.
- Conectar-se e testar o servidor local.
Configurações de ferramentas
- Minimal — (Padrão) Inclui apenas ferramentas essenciais para operações básicas do Postman. Ideal para usuários que desejam modificar um único elemento do Postman, como coleções, workspaces ou ambientes.
- Code — Inclui ferramentas para gerar código de cliente de alta qualidade e bem organizado a partir de definições de API públicas e internas. Ideal para usuários que precisam consumir APIs ou fornecer contexto de API aos seus agentes.
- Full — Inclui todas as ferramentas de API do Postman disponíveis (mais de 100 ferramentas). Ideal para usuários que participam de colaboração avançada e dos recursos Enterprise do Postman.
- Learn — Pesquisa na Documentação do Postman guias, tutoriais e conteúdo de referência. Ideal para agentes que precisam descobrir recursos do Postman, consultar conceitos de API ou encontrar recursos de aprendizado.
Autenticação
Para a melhor experiência de desenvolvimento e configuração mais rápida, use OAuth no servidor remoto (https://mcp.postman.com). O OAuth é totalmente compatível com a especificação de Autorização MCP e não requer configuração manual de chave de API.
O servidor remoto da EU e o servidor local suportam apenas autenticação por chave de API do Postman.
Início rápido
Remoto (qualquer host MCP compatível com OAuth):
Adicione esta URL à configuração do seu host MCP:
https://mcp.postman.com/minimal
Altere /minimal para /code ou /mcp para o modo Code ou Full. Para autenticação por EU ou chave de API, passe Authorization: Bearer <POSTMAN_API_KEY> como cabeçalho.
Local:
npx @postman/postman-mcp-server
Adicione --code ou --full para o modo Code ou Full. Defina POSTMAN_API_KEY como uma variável de ambiente.
Para instruções de configuração específicas por IDE, consulte a tabela a seguir. Para mais informações, consulte a documentação do Servidor MCP do Postman.
Agentes e IDEs suportados
| Agente / IDE | Remoto | Local |
|---|---|---|
| Claude Code | Docs | Docs |
| Claude Desktop | Docs | Docs |
| Cursor | Docs | Docs |
| VS Code | Docs | Docs |
| Codex | Docs | Docs |
| Antigravity CLI | Docs | Docs |
| GitHub Copilot CLI | Docs | Docs |
| Kiro | Docs | Docs |
| Docker | — | Docs |
Suporte à região EU
O Servidor MCP do Postman suporta a região EU para servidores remotos e locais:
- Para streamable HTTP, o servidor remoto está disponível em
https://mcp.eu.postman.com/mcp(Full),https://mcp.eu.postman.com/codeehttps://mcp.eu.postman.com/minimal. - Para o pacote público STDIO, use o sinalizador
--region euou defina a variável de ambientePOSTMAN_API_BASE_URLdiretamente. - O OAuth não é suportado para o servidor da EU. O servidor remoto da EU suporta apenas autenticação por chave de API.
Casos de uso
- Teste de API — Teste continuamente sua API usando sua coleção do Postman. Use o servidor local para testar APIs locais, pois o servidor remoto não terá acesso de rede à sua estação de trabalho.
- Sincronização de código — Mantenha seu código sincronizado com suas Coleções do Postman e especificações.
- Gerenciamento de coleções — Crie e marque coleções, atualize documentação, adicione comentários ou execute ações em várias coleções sem sair do seu editor.
- Gerenciamento de workspaces e ambientes — Crie workspaces e ambientes, além de gerenciar variáveis de ambiente.
- Criação automática de especificações — Crie especificações a partir do seu código e use-as para gerar coleções.
- Geração de código de cliente — Gere código de cliente pronto para produção que consome APIs seguindo as melhores práticas e convenções do projeto.
Docker
Para configuração e instalação do Docker, consulte DOCKER.md.
Perguntas e suporte
- Consulte Adicione suas solicitações MCP às suas coleções para aprender como usar o Postman para realizar solicitações MCP.
- Visite a Comunidade Postman para compartilhar o que você construiu, fazer perguntas e obter ajuda.
- Você pode conectar-se aos servidores remoto e local e testá-los usando a coleção do Servidor MCP do Postman.
Palavras-chave
Model Context Protocol · MCP Server · Postman · Agentes de IA · Claude Code · Cursor · VS Code · Especificações · REST API · Teste de API · TypeScript · OpenAPI