Postman API

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

Postman MCP Server

Der Postman MCP Server implementiert das Model Context Protocol (MCP), um KI-Agenten und Coding-Assistenten – einschließlich Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI und Gemini CLI – direkt mit Ihren Postman-Workspaces, -Collections, -Spezifikationen und -Umgebungen zu verbinden.

Postman bietet den Server auch als npm-Paket an.

Die vollständige Installationsanleitung mit agentspezifischer Einrichtung finden Sie auf der MCP-Server-Produktseite von Postman.

---

Postman MCP Server-Collection

Die Postman MCP Server-Collection ist der schnellste Weg, den Postman MCP Server zu erkunden, zu testen und sich mit ihm zu verbinden. Verwenden Sie sie, um:

• Die vollständige Liste der verfügbaren Tools über alle Konfigurationen hinweg zu durchsuchen.
• Sich mit dem Remote-Server zu verbinden und ihn zu testen – Full und Minimal.
• Sich mit dem lokalen Server zu verbinden und ihn zu testen.

---

Tool-Konfigurationen

• Minimal – (Standard) Enthält nur die wichtigsten Tools für grundlegende Postman-Operationen. Ideal für Benutzer, die ein einzelnes Postman-Element wie Collections, Workspaces oder Umgebungen ändern möchten.
• Code – Enthält Tools zum Generieren von hochwertigem, gut strukturiertem Client-Code aus öffentlichen und internen API-Definitionen. Ideal für Benutzer, die APIs nutzen oder ihren Agenten API-Kontext bereitstellen möchten.
• Full – Enthält alle verfügbaren Postman-API-Tools (100+ Tools). Ideal für Benutzer, die erweiterte Zusammenarbeit und die Enterprise-Funktionen von Postman nutzen.
• Learn – Durchsucht die Postman-Dokumentation nach Anleitungen, Tutorials und Referenzinhalten. Ideal für Agenten, die Postman-Funktionen entdecken, API-Konzepte nachschlagen oder Lernressourcen finden möchten.

---

Authentifizierung

Für die beste Entwicklererfahrung und die schnellste Einrichtung verwenden Sie OAuth auf dem Remote-Server (https://mcp.postman.com). OAuth ist vollständig konform mit der MCP-Autorisierungsspezifikation und erfordert keine manuelle API-Key-Konfiguration.

Der EU-Remote-Server und der lokale Server unterstützen nur die Authentifizierung über den Postman-API-Key.

---

Schnellstart

Remote (jeder OAuth-kompatible MCP-Host):

Fügen Sie diese URL zur Konfiguration Ihres MCP-Hosts hinzu:

https://mcp.postman.com/minimal

Ändern Sie /minimal zu /code oder /mcp für den Code- oder Full-Modus. Für EU- oder API-Key-Authentifizierung übergeben Sie Authorization: Bearer <POSTMAN_API_KEY> als Header.

Lokal:

npx @postman/postman-mcp-server

Fügen Sie --code oder --full für den Code- oder Full-Modus hinzu. Setzen Sie POSTMAN_API_KEY als Umgebungsvariable.

Anweisungen zur Einrichtung für spezifische IDEs finden Sie in der folgenden Tabelle. Weitere Informationen finden Sie in der Postman-MCP-Server-Dokumentation.

---

Unterstützte Agenten und IDEs

Agent / IDE	Remote	Lokal
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

---

EU-Unterstützung

Der Postman MCP Server unterstützt die EU-Region für Remote- und lokale Server:

• Für streambares HTTP ist der Remote-Server unter https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code und https://mcp.eu.postman.com/minimal verfügbar.
• Verwenden Sie für das öffentliche STDIO-Paket das Flag --region eu oder setzen Sie die Umgebungsvariable POSTMAN_API_BASE_URL direkt.
• OAuth wird für den EU-Server nicht unterstützt. Der EU-Remote-Server unterstützt nur die API-Key-Authentifizierung.

---

Anwendungsfälle

• API-Tests – Testen Sie Ihre API kontinuierlich mit Ihrer Postman-Collection. Verwenden Sie den lokalen Server zum Testen lokaler APIs, da der Remote-Server keinen Netzwerkzugriff auf Ihre Workstation hat.
• Code-Synchronisierung – Halten Sie Ihren Code mit Ihren Postman-Collections und Spezifikationen synchron.
• Collection-Verwaltung – Erstellen und taggen Sie Collections, aktualisieren Sie Dokumentationen, fügen Sie Kommentare hinzu oder führen Sie Aktionen über mehrere Collections hinweg aus, ohne Ihren Editor zu verlassen.
• Workspace- und Umgebungsverwaltung – Erstellen Sie Workspaces und Umgebungen und verwalten Sie Umgebungsvariablen.
• Automatische Spezifikationserstellung – Erstellen Sie Spezifikationen aus Ihrem Code und verwenden Sie sie zum Generieren von Collections.
• Client-Code-Generierung – Generieren Sie produktionsreifen Client-Code, der APIs gemäß Best Practices und Projektkonventionen nutzt.

---

Docker

Informationen zur Docker-Einrichtung und -Installation finden Sie in DOCKER.md.

---

Mitwirken

Fehlerberichte, Tool-Anfragen und Dokumentationskorrekturen sind willkommen – siehe CONTRIBUTING.md.

• Fehler melden
• Ein Tool oder eine Änderung an einem Tool anfragen
• Ein Dokumentationsproblem melden

Die MCP-Tooldefinitionen und die Serverimplementierung hier werden aus Postmans interner Quelle der Wahrheit synchronisiert. Daher können Änderungen an Dateien unter src/ nicht in dieses Repository übernommen werden – aber über Issues werden diese Änderungen umgesetzt, und wir würdigen Beiträge, die veröffentlicht werden. Dokumentation und Repository-Tooling akzeptieren Pull Requests direkt.

Ein Sicherheitsproblem gefunden? Siehe SECURITY.md – bitte eröffnen Sie kein öffentliches Issue.

---

Fragen und Support

• Lesen Sie Hinzufügen Ihrer MCP-Anfragen zu Ihren Collections, um zu erfahren, wie Sie Postman für MCP-Anfragen verwenden.
• Besuchen Sie die Postman-Community, um Ihre Arbeiten zu teilen, Fragen zu stellen und Hilfe zu erhalten.
• Sie können sich mit dem Remote- und dem lokalen Server verbinden und sie mit der Postman MCP Server-Collection testen.
• Melden Sie Fehler und fordern Sie Tools in GitHub Issues an. In SUPPORT.md erfahren Sie, welcher Kanal für Ihre Frage geeignet ist.

---

Schlüsselwörter

Model Context Protocol · MCP Server · Postman · KI-Agenten · Claude Code · Cursor · VS Code · Spezifikationen · REST API · API-Tests · TypeScript · OpenAPI