Postman über MCP mit ChatGPT verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Postman klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Postman + ChatGPT

Arbeite aus deinem KI-Agent mit Postman: Workspaces, Collections, Ordner und Requests, Environments, Spec-Hub-Spezifikationen und APIs, Mock-Server mit ihren Call-Logs, Monitore und Team-Mitglieder durchsehen, alles durchsuchen und nach deiner Bestätigung Collections, Requests, Environments, Mocks, Monitore und Specs anlegen oder ändern.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

POSTMAN_API_URL, POSTMAN_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Postman-Konto mit Zugriff auf die Workspaces.

1. Öffne in Postman deinen Avatar, Settings, API keys (https://go.postman.co/settings/me/api-keys) und klicke auf Generate API Key. Gib ihm einen Namen und kopiere den Key; er beginnt mit PMAK-.
2. Füge ihn in POSTMAN_API_KEY ein. Er wird im Header X-Api-Key gesendet und handelt als dein Postman-Benutzer: Die KI sieht, was du in jedem Workspace siehst.
3. Setze POSTMAN_API_URL auf https://api.postman.com oder auf https://api.eu.postman.com, wenn dein Team einen Enterprise-Plan in der EU-Datenregion von Postman hat.
4. Installiere den Connector und führe postman_get_me aus: Es zeigt deine User-ID, dein Team und die monatliche API-Nutzung und bestätigt den Key.

IDs und UIDs: Die meisten Objekte haben eine id und eine uid (<owner user id>-<id>). Mocks, Monitore und postman_update_collection nehmen die UID der Collection; postman_create_collection_request, postman_update_collection_request und postman_create_collection_folder die reine ID. Die anderen Lese-Tools akzeptieren beides.

Was er liest:

• Du und dein Team: postman_get_me, postman_list_workspaces (mit createdBy auf deiner User-ID für „meine Workspaces“), postman_get_workspace (die enthaltenen Collections, Environments, Mocks, Monitore und APIs), postman_list_team_users und postman_search, das Requests, Collections, Workspaces, Environments, Dokumente, Flows oder Specs per Text findet (standardmäßig nur in deinem Team, öffentliche mit ownership).
• Collections im Postman Collection Format v2.1: postman_list_collections, postman_get_collection (bei großen zuerst model=minimal), postman_get_collection_folder und postman_get_collection_request mit Methode, URL, Headern, Body, Auth und Skripten.
• Environments: postman_list_environments und postman_get_environment mit Key, Wert, Typ und Aktiv-Flag jeder Variablen.
• API-Design: Spec Hub mit postman_list_specs, postman_get_spec, postman_list_spec_files, postman_get_spec_file und postman_get_spec_definition (die vollständig aufgelöste OpenAPI- oder AsyncAPI-Definition); ältere API-Builder-APIs mit postman_list_apis und postman_get_api.
• Mocks: postman_list_mocks, postman_get_mock und postman_get_mock_call_logs, also was Clients an den Mock geschickt haben und was er geantwortet hat (höchstens 100 Logs oder 6,5 MB pro Aufruf; Header und Bodies nur mit include).
• Monitore: postman_list_monitors und postman_get_monitor, dessen lastRun den letzten Status, die Zeiten und die bestandenen und fehlgeschlagenen Assertions zeigt.

Was er nach deiner Bestätigung schreibt: postman_create_collection, postman_update_collection (Name, Beschreibung, Variablen, Auth; Ordner und Requests bleiben, wie sie sind), postman_create_collection_folder, postman_create_collection_request, postman_update_collection_request (die übergebenen Felder ersetzen die alten), postman_create_environment, postman_update_environment, postman_create_mock, postman_create_monitor, postman_run_monitor, postman_create_spec (OpenAPI, AsyncAPI, Protobuf, GraphQL, Smithy) und postman_update_spec_file. Die KI sagt, was sie in welchem Workspace anlegen oder ändern will, und ruft das Tool erst nach deinem Ja auf. Alles Geschriebene sehen die Mitglieder des Workspaces. Beachte:

• postman_run_monitor schickt die echten Requests der Collection an ihre APIs und verbraucht einen Monitoring-Lauf deines Plans; postman_create_monitor tut das danach regelmäßig nach Zeitplan.
• Ein neuer Mock ist öffentlich, solange private nicht true ist.
• postman_update_environment nimmt pro Aufruf JSON-Patch-Operationen nur einer Art; die KI liest das Environment vorher, um die Positionen der Variablen zu kennen (values[0] ist /values/0).
• Die Postman API kann eine Collection nicht direkt ausführen. Nutze einen Monitor oder die Postman CLI in deiner eigenen CI.

Alle 35 Tools sind nach der Installation aktiv; keines ist abgeschaltet, und kein Tool löscht einen Workspace, eine Collection, einen Request, ein Environment, einen Mock, einen Monitor oder eine Spec.

Secrets: Environment-Variablen vom Typ secret kommen mit ihren Werten zurück, wenn sie geteilt sind, und Collection-Variablen oder Request-Auth können Tokens enthalten. Die KI wiederholt solche Werte nur, wenn du darum bittest.

Datenformate: Collections und Requests nutzen das Postman Collection Format v2.1 (item enthält Ordner und Requests). Datumsangaben sind ISO 8601 in UTC.

Paging: postman_list_workspaces, postman_list_apis, postman_list_specs, postman_list_monitors, postman_get_mock_call_logs und postman_search liefern meta.nextCursor; die KI ruft erneut mit cursor auf, bis er leer ist. postman_list_collections blättert mit limit und offset; sein Filter name sucht den exakten Namen und lässt sich nicht damit kombinieren.

Limits: Postman erlaubt 300 Requests pro Minute und Benutzer; postman_list_collections, postman_list_workspaces, postman_get_workspace und die Monitor-Endpunkte nur 10 Aufrufe in 10 Sekunden. Jeder Plan hat außerdem ein monatliches Kontingent an API-Aufrufen, das postman_get_me unter operations zeigt. Ein 429 mit rateLimited heißt warten (Retry-After nennt die Sekunden); serviceLimitExhausted heißt, das Kontingent des Plans ist aufgebraucht und ein Team-Admin muss handeln.

Häufige Fehler: 401 bedeutet, dass der Key falsch, abgelaufen oder widerrufen ist oder zur anderen Datenregion gehört (prüfe POSTMAN_API_URL). 403 bedeutet, dass deine Rolle in diesem Workspace den Aufruf nicht erlaubt. 404 bedeutet, dass die ID nicht existiert oder du sie nicht sehen kannst. 400 nennt das falsche Feld, zum Beispiel eine Collection-ID, wo eine UID nötig ist.

Der Connector löscht nichts und deckt Forks und Pull Requests, Kommentare, Tags, Governance, den API-Katalog, das Private API Network, SCIM, Audit-Logs, Abrechnung und die älteren API-Builder-Schreibzugriffe nicht ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Postman.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Welche Collections liegen in unserem Workspace ‚Payments‘, und welche Requests enthält die Collection Checkout?“
• „Hat der nächtliche Monitor für die Orders-API seinen letzten Lauf bestanden? Wie viele Assertions sind fehlgeschlagen?“
• „Zeig mir die letzten 20 Aufrufe an unseren Checkout-Mock-Server, die eine 404 bekommen haben.“
• „Füge der Collection Payments einen POST-Request ‚Create refund‘ mit einem JSON-Body für orderId und amount hinzu.“
• „Gib mir die aufgelöste OpenAPI-Definition der Spec Orders und liste ihre Endpunkte auf.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden