Postman API

officiel

Un 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 / IDEDistantLocal
Claude CodeDocsDocs
Claude DesktopDocsDocs
CursorDocsDocs
VS CodeDocsDocs
CodexDocsDocs
Antigravity CLIDocsDocs
GitHub Copilot CLIDocsDocs
KiroDocsDocs
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/code et https://mcp.eu.postman.com/minimal.
  • Pour le package public STDIO, utilisez l'indicateur --region eu ou définissez directement la variable d'environnement POSTMAN_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.

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


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