Postman API

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

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 MCP Server 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 realizam colaboração avançada e usam os recursos Enterprise do Postman.
• Learn — Pesquisa na Documentação do Postman por 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 UE 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 os modos Code ou Full. Para autenticação por UE ou chave de API, passe Authorization: Bearer <POSTMAN_API_KEY> como cabeçalho.

Local:

npx @postman/postman-mcp-server

Adicione --code ou --full para os modos 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 à UE

O Servidor MCP do Postman suporta a região da UE para servidores remotos e locais:

• Para HTTP transmissível, o servidor remoto está disponível em https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code e https://mcp.eu.postman.com/minimal.
• Para o pacote público STDIO, use o sinalizador --region eu ou defina a variável de ambiente POSTMAN_API_BASE_URL diretamente.
• O OAuth não é suportado para o servidor da UE. O servidor remoto da UE 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 consuma APIs seguindo as melhores práticas e convenções do projeto.

---

Docker

Para configuração e instalação do Docker, consulte DOCKER.md.

---

Contribuindo

Relatórios de bugs, solicitações de ferramentas e correções de documentação são bem-vindos — consulte CONTRIBUTING.md.

• Relatar um bug
• Solicitar uma ferramenta ou uma alteração em uma
• Relatar um problema de documentação

As definições de ferramentas MCP e a implementação do servidor aqui são sincronizadas a partir da fonte interna de verdade do Postman, portanto, alterações em arquivos sob src/ não podem ser mescladas neste repositório — mas issues são como essas alterações são feitas, e creditamos contribuições que são enviadas. Documentação e ferramentas do repositório aceitam pull requests diretamente.

Encontrou um problema de segurança? Consulte SECURITY.md — por favor, não abra uma issue pública.

---

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 do 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.
• Relate bugs e solicite ferramentas em GitHub Issues. Consulte SUPPORT.md para saber qual canal atende à sua pergunta.

---

Palavras-chave

Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI