Test und Problembehebung - MCP
Die Integration testen
Rufe von einem MCP-Client tools/list auf und vergleiche das Ergebnis mit den beim Erstellen des Schlüssels aktivierten Berechtigungen - die Liste sollte genau diese Werkzeuge enthalten, nicht mehr. Rufe danach ein Lese-Werkzeug auf, zum Beispiel projects.list, und prüfe in Einstellungen → MCP-Integration, dass sich beim Schlüssel das Datum der letzten Nutzung aktualisiert hat.
Typische Probleme
Ein Werkzeug fehlt in tools/list
Ein Werkzeug erscheint in der Antwort nur, wenn der Schlüssel die zugehörige Berechtigung besitzt. Prüfe in den Schlüsseleinstellungen, ob diese Berechtigung aktiviert ist - ein Werkzeug ohne sie ist nicht versteckt oder gesperrt, es existiert aus Sicht dieses Schlüssels schlicht nicht.
issues.get existiert für diesen Schlüssel nicht
Die Berechtigung issues.read allein gewährt über issues.list nur Gruppenmetadaten - Fehlermeldung, Absturzort, Stacktrace und die vollständigen Anfragedaten benötigen die separate Berechtigung issues.details, die standardmäßig nicht aktiviert ist. Aktiviere sie bewusst in den Schlüsseleinstellungen, sobald ein Werkzeug tatsächlich Fehler diagnostizieren muss.
Der Schlüssel funktioniert von einem Tag auf den anderen nicht mehr
Der Umfang eines Schlüssels wird bei jeder Anfrage mit den aktuellen Berechtigungen der Person geschnitten, die ihn ausgestellt hat. Wurde diese Person herabgestuft, hat sie eine bestimmte Berechtigung verloren oder wurde ihr Konto deaktiviert, schrumpft der Schlüssel sofort oder funktioniert nicht mehr - ohne jede Änderung am Schlüssel selbst. Die Wiederherstellung der Berechtigungen des Ausstellers stellt den vollen Umfang des Schlüssels wieder her, denn die Zeile in der Datenbank bleibt die ganze Zeit unberührt.
Die Anfrage endet mit 403
Prüfe den Origin-Header der Anfrage. Der MCP-Server weist jede Anfrage ab, deren Header auf eine fremde Domain zeigt - das ist ein Schutz gegen Aufrufe aus dem Browser, kein Konfigurationsfehler. Dieser Endpunkt ist für serverseitige Clients gedacht, nicht für Code, der im Browser einer Nutzerin oder eines Nutzers läuft.
Der Schlüssel funktioniert trotz gültigem Token und passenden Berechtigungen nicht
Prüfe, ob das Konto die MCP-Komponente noch gebucht hat - es ist eine kostenpflichtige Planfunktion, und ihr Wegfall (etwa nach dem Zurückstufen auf den kostenlosen Plan) schaltet die Authentifizierung aller Schlüssel des Kontos ab, unabhängig davon, mit welchen Berechtigungen sie ausgestellt wurden.
Es funktioniert weiterhin nicht
Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.