MCP
Derselbe API-Schlüssel, einem KI-Agent als ein typisiertes Tool pro erlaubter Methode bereitgestellt.
Xuda betreibt einen Model-Context-Protocol-Server unter /mcp, neben /cpi. Verbinde einen MCP-fähigen
Agent damit, per Anmeldung oder mit einem API-Schlüssel, und jede Methode, die dieser Schlüssel aufrufen darf,
erscheint als typisiertes Tool, ohne separate Integration für KI-Agents.
Verbinden
Es gibt zwei Wege hinein, und beide enden am selben Punkt: den Rechten eines API-Schlüssels.
Anmelden (Claude-Connectors und andere OAuth-Clients)
Füge https://xuda.ai/mcp in Claude als benutzerdefinierten Connector hinzu (Settings, Connectors,
Add custom connector), lasse OAuth-Client-ID und -Secret leer und drücke Connect. Claude öffnet Xuda:
Melde dich an, falls du es noch nicht bist, und ein Fenster im Dashboard fragt, welchen deiner API-Schlüssel
die Verbindung nutzt; wähle einen und drücke Verbinden. Claude im Web, Desktop, auf dem Smartphone und
Cowork teilen diese Verbindung, und jedes andere Claude-Konto fügt sie auf dieselbe Weise hinzu. Der Tab
Entwickler, MCP im Dashboard zeigt die einzufügende Adresse, diese Schritte und alles Folgende.
Claude Code meldet sich auf dieselbe Weise an, wenn du den Server ohne Header hinzufügst; führe dann /mcp
aus und wähle Authenticate:
Die Verbindung hat nie eigene Rechte. Jeder Tool-Aufruf läuft als der Schlüssel, den du gewählt hast, also gelten Zugriffsmodus, Zulassungsliste und Widerruf des Schlüssels auch für die Verbindung: Widerrufe den Schlüssel unter Entwickler, API-Schlüssel, und die Verbindung endet; die nächste Anmeldung fragt nach einem anderen Schlüssel. Die Seite listet nur deine eigenen aktiven Schlüssel; hast du keinen, erstelle zuerst einen.
Für Client-Entwickler: Der Server folgt der MCP-Autorisierungsspezifikation:
Ein Aufruf von /mcp ohne brauchbares Token wird mit 401 und WWW-Authenticate: Bearer resource_metadata="..." beantwortet, so findet ein Client den Rest. Zugriffstokens gelten eine Stunde;
Refresh-Tokens gelten 90 Tage und werden bei jeder Verwendung ersetzt. Eine Loopback-Redirect-URI
(http://localhost oder http://127.0.0.1) passt auf jeden Port.
Ein API-Schlüssel in einem Header
Der Schlüssel kommt in einen Authorization: Bearer-Header, derselbe Schlüssel, den du bei /cpi als
api_key nutzen würdest. Es gibt kein separates MCP-Zugangsdatum. Eine Anfrage ohne Authorization-Header
oder mit einem Schlüssel, der keinem aktiven xuda_api_keys-Dokument entspricht, wird mit 401 abgelehnt,
bevor ein Tool registriert wird.
Sitzungen
Der Transport ist Streamable HTTP: Die erste Anfrage ist ein MCP-Aufruf initialize, der eine Sitzung öffnet
und einen Header mcp-session-id zurückgibt; jede folgende Anfrage auf dieser Verbindung trägt denselben
Header und dasselbe Zugangsdatum. Eine Sitzung schließt sich nach 10 Minuten ohne Anfrage. Eine Anfrage auf
einer geschlossenen Sitzung wird mit 404 beantwortet, und ein MCP-Client startet dann von selbst eine neue Sitzung.
Was zu einem Tool wird
Tools werden zu Beginn der Sitzung aus dem Zugriffsmodus registriert, den der Schlüssel bereits hat:
- Voller Zugriff: Jede Methode des Katalogs, die nicht
privateist, wird als Tool registriert, beim Verbinden aufgelöst, sodass eine Methode, die nach der Erstellung des Schlüssels hinzukam, ohne Änderung am Schlüssel selbst verfügbar ist. - Benutzerdefinierter Zugriff: Nur die Methoden auf der Zulassungsliste des Schlüssels werden registriert.
Eine laufende Sitzung hält mit ihrem Schlüssel Schritt: Sie prüft den Schlüssel jede Minute und die Module
und Plugins dahinter alle fünf, und wenn sich die Menge der Tools verändert hat, sendet sie
notifications/tools/list_changed. Ein Client, der zuhört (Claude tut das), liest die neue Liste ohne
erneutes Verbinden, sodass eine Methode, die du für den Schlüssel erlaubst, einen bereits verbundenen Agent erreicht.
Jedes Tool behält die Form der Methode: Der Tool-Name ist der Methodenname (get_account_projects,
dbs_read, ...), sein Titel ist der Methodenname in Title Case, seine Beschreibung ist die eigene
description der Methode, und sein Eingabeschema wird Feld für Feld aus den fields der Methode gebaut,
Pflichtfelder bleiben erforderlich, alles andere ist optional. Ein Feld ohne erkannten Typ wird dennoch zu
einem großzügigen Tool-Argument, statt die ganze Sitzung zu brechen, sodass eine seltsam spezifizierte
Methode nie den Rest des Katalogs mitreißt.
Ein auf einen Full Stack VPS beschränkter Schlüssel stellt neben den obigen Ökosystem-Methoden auch die installierten Plugin-Tools dieser Box bereit, sodass ein Agent in einer Sitzung sowohl die Plattform als auch das erreichen kann, was der Entwickler auf der Box gebaut hat. Siehe Full Stack VPS.
Ein Tool aufrufen
Ein Agent ruft ein Tool mit denselben Argumenten auf, die die Felder der Methode beschreiben. Xuda antwortet,
indem es die Methode intern aufruft, so wie es /cpi/<method> täte, und gibt dem Tool die {code, data}-Hülle
der Methode als Text zurück. Ein fehlgeschlagener Aufruf kehrt auf der MCP-Ebene trotzdem normal zurück, Code
-1 und höher erscheint im Tool-Ergebnis genau wie bei einem einfachen REST-Aufruf, sodass ein Agent ihn so
liest wie deine eigene Fehlerbehandlung. Siehe Fehler.
Eine Anfrage, die scheitert, bevor ein Tool läuft, ein fehlendes oder abgelehntes Zugangsdatum (401), eine
geschlossene Sitzung (404, Code -32001), eine fehlerhafte MCP-Nachricht, kommt statt eines Tool-Ergebnisses
als JSON-RPC-Fehler zurück: