Postman API
officielUn serveur MCP pour interagir avec l'API Postman, nécessitant une clé API.
Que pouvez-vous faire avec Postman API MCP ?
- Gérer les collections — Demandez à votre assistant de créer, taguer ou mettre à jour des collections Postman et leur documentation directement depuis votre éditeur.
- Générer du code client — Demandez du code client prêt pour la production à partir de vos définitions d'API, en suivant les bonnes pratiques et les conventions du projet.
- Créer des spécifications à partir du code — Faites générer par votre assistant des spécifications d'API à partir de votre base de code et transformez-les en collections Postman.
- Gérer les environnements — Donnez pour instruction à votre assistant de créer des espaces de travail et des environnements, et de gérer les variables d'environnement sans quitter votre IDE.
- Exécuter des tests d'API — Utilisez le serveur local pour tester en continu vos API par rapport à vos collections Postman, y compris les points de terminaison locaux.
Serveur MCP hébergé
npx add-mcp 'https://mcp.postman.com/minimal'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
Postman MCP Server
Le serveur MCP Postman implémente le Model Context Protocol (MCP) pour connecter les agents IA et les assistants de codage — notamment Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI et Gemini CLI — directement à vos espaces de travail, collections, spécifications et environnements Postman.
Postman propose également le serveur sous forme de package npm.
Pour le guide d'installation complet avec la configuration spécifique à chaque agent, consultez la page produit du serveur MCP de Postman.
Collection du serveur MCP Postman
La collection du serveur MCP Postman est le moyen le plus rapide d'explorer, de tester et de se connecter au serveur MCP Postman. Utilisez-la pour :
- Parcourir la liste complète des outils disponibles dans toutes les configurations.
- Se connecter au serveur distant et le tester — Full et Minimal.
- Se connecter au serveur local et le tester.
Configurations d'outils
- Minimal — (Par défaut) Inclut uniquement les outils essentiels pour les opérations Postman de base. Idéal pour les utilisateurs qui souhaitent modifier un seul élément Postman, comme les collections, les espaces de travail ou les environnements.
- Code — Inclut des outils pour générer du code client de haute qualité et bien organisé à partir de définitions d'API publiques et internes. Idéal pour les utilisateurs qui doivent consommer des API ou fournir du contexte API à leurs agents.
- Full — Inclut tous les outils d'API Postman disponibles (plus de 100 outils). Idéal pour les utilisateurs qui participent à une collaboration avancée et utilisent les fonctionnalités Enterprise de Postman.
- Learn — Recherche dans la documentation Postman des guides, des tutoriels et du contenu de référence. Idéal pour les agents qui doivent découvrir les fonctionnalités de Postman, consulter des concepts d'API ou trouver des ressources d'apprentissage.
Authentification
Pour une expérience développeur optimale et une configuration rapide, utilisez OAuth sur le serveur distant (https://mcp.postman.com). OAuth est entièrement conforme à la spécification d'autorisation MCP et ne nécessite aucune configuration manuelle de clé API.
Le serveur distant UE et le serveur local ne prennent en charge que l'authentification par clé API Postman.
Démarrage rapide
Distant (tout hôte MCP compatible OAuth) :
Ajoutez cette URL à la configuration de votre hôte MCP :
https://mcp.postman.com/minimal
Remplacez /minimal par /code ou /mcp pour le mode Code ou Full. Pour l'authentification UE ou par clé API, transmettez Authorization: Bearer <POSTMAN_API_KEY> comme en-tête.
Local :
npx @postman/postman-mcp-server
Ajoutez --code ou --full pour le mode Code ou Full. Définissez POSTMAN_API_KEY comme variable d'environnement.
Pour les instructions de configuration spécifiques à chaque IDE, consultez le tableau suivant. Pour plus d'informations, consultez la documentation du serveur MCP Postman.
Agents et IDE pris en charge
| Agent / IDE | Distant | 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 |
Prise en charge de l'UE
Le serveur MCP Postman prend en charge la région UE pour les serveurs distants et locaux :
- Pour HTTP streamable, le serveur distant est disponible à
https://mcp.eu.postman.com/mcp(Full),https://mcp.eu.postman.com/codeethttps://mcp.eu.postman.com/minimal. - Pour le package public STDIO, utilisez l'indicateur
--region euou définissez directement la variable d'environnementPOSTMAN_API_BASE_URL. - OAuth n'est pas pris en charge pour le serveur UE. Le serveur distant UE ne prend en charge que l'authentification par clé API.
Cas d'utilisation
- Tests d'API — Testez votre API en continu à l'aide de votre collection Postman. Utilisez le serveur local pour tester les API locales, car le serveur distant n'aura pas accès réseau à votre poste de travail.
- Synchronisation du code — Gardez votre code synchronisé avec vos collections Postman et vos spécifications.
- Gestion des collections — Créez et étiquetez des collections, mettez à jour la documentation, ajoutez des commentaires ou effectuez des actions sur plusieurs collections sans quitter votre éditeur.
- Gestion des espaces de travail et des environnements — Créez des espaces de travail et des environnements, et gérez les variables d'environnement.
- Création automatique de spécifications — Créez des spécifications à partir de votre code et utilisez-les pour générer des collections.
- Génération de code client — Générez du code client prêt pour la production qui consomme des API en suivant les bonnes pratiques et les conventions du projet.
Docker
Pour la configuration et l'installation de Docker, consultez DOCKER.md.
Contribution
Les rapports de bugs, les demandes d'outils et les corrections de documentation sont tous les bienvenus — consultez CONTRIBUTING.md.
- Signaler un bug
- Demander un outil ou une modification d'un outil
- Signaler un problème de documentation
Les définitions d'outils MCP et l'implémentation du serveur ici sont synchronisées à partir de la source de vérité interne de Postman. Par conséquent, les modifications apportées aux fichiers sous src/ ne peuvent pas être fusionnées dans ce dépôt — mais c'est par les issues que ces modifications sont réalisées, et nous créditons les contributions qui sont publiées. La documentation et les outils du dépôt acceptent directement les pull requests.
Vous avez trouvé un problème de sécurité ? Consultez SECURITY.md — veuillez ne pas ouvrir d'issue publique.
Questions et assistance
- Consultez Ajouter vos requêtes MCP à vos collections pour apprendre à utiliser Postman pour effectuer des requêtes MCP.
- Visitez la communauté Postman pour partager vos créations, poser des questions et obtenir de l'aide.
- Vous pouvez vous connecter aux serveurs distant et local et les tester à l'aide de la collection du serveur MCP Postman.
- Signalez les bugs et demandez des outils dans GitHub Issues. Consultez SUPPORT.md pour savoir quel canal correspond à votre question.
Mots-clés
Model Context Protocol · MCP Server · Postman · Agents IA · Claude Code · Cursor · VS Code · Spécifications · REST API · Tests d'API · TypeScript · OpenAPI