MCP-Schnittstelle
Der Streamable-HTTP-Endpunkt liegt unter https://projects.webdevmedia.de/documentation/mcp. Er unterstützt OAuth Authorization Code mit PKCE S256, dynamische Client-Registrierung, rotierende Refresh-Tokens und Revocation.
Tools
| Tool | Aufgabe |
|---|---|
documentation__guide |
kompakter Nutzungs- und Quellenleitfaden |
documentation__status |
Build-, Index- und Adapterstatus |
documentation__list |
veröffentlichte Baumstruktur |
documentation__search |
Volltextsuche mit kleinen Snippets |
documentation__read |
Originalquelle eines Dokuments lesen |
documentation__ask_start |
asynchronen Wiki-LLM-Auftrag starten |
documentation__ask_poll |
Status oder Ergebnis eines Auftrags lesen |
documentation__ask_cancel |
eigenen Auftrag abbrechen |
Authentifizierungsfluss
- Der Client liest die Protected-Resource-Metadaten.
- Er registriert seine erlaubten Redirect-URIs dynamisch.
- Der menschliche Nutzer autorisiert den Scope
mcpmit PKCE S256. - Access-Tokens sind kurzlebig; Refresh-Tokens rotieren bei jeder Nutzung.
- Die Wiederverwendung eines ersetzten Refresh-Tokens widerruft die gesamte Token-Familie.
Die kanonischen Discovery-Dokumente liegen unter:
https://projects.webdevmedia.de/.well-known/oauth-protected-resource/documentation/mcphttps://projects.webdevmedia.de/.well-known/oauth-authorization-server/documentation
Im MCP-Center besitzt der Upstream die ID documentation-wiki, keinen zusätzlichen Tool-Präfix und die Mindestrolle developer.
MCP-Antworten halten Inhalte kompakt. Große LLM-Antworten werden als asynchroner Auftrag gestartet und separat gepollt.
documentation__ask_poll behandelt completed, failed und cancelled als
terminal. queued, running und cancelling sind vorübergehend. Eine
unbekannte Job-ID ist ein terminaler Not-found-Fehler; nach 24 Stunden
Aufbewahrung wird eine bekannte terminale ID als abgelaufen gemeldet. Sichere
Fehlerklasse, Retry-Merkmal und Referenz dürfen für Supportzwecke übernommen
werden, nicht jedoch Nutzlasten oder vermeintliche Adapter-Rohmeldungen.