Zum Inhalt springen
Geprüft

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:

claude mcp add
claude mcp add --transport http xuda https://xuda.ai/mcp

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

claude mcp add
claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

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 private ist, 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.

Full-Stack-VPS-Schlüssel bringen zusätzliche Tools mit

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:

json
{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "Bad Request: Invalid Api key" }, "id": null }

Als Nächstes