Zum Inhalt springen
Geprüft

Einen KI-Client über MCP verbinden

Xuda als entfernten MCP-Server zu Claude, Cursor oder einem anderen MCP-fähigen Client hinzufügen.

Diese Seite handelt von der Client-Seite: Claude, Cursor oder alles andere, das MCP spricht, mit deinem Xuda-Konto sprechen zu lassen. Zum Protokoll selbst, zur Benennung der Tools, zum Sitzungslebenszyklus und zur Form der Fehler siehe MCP.

Was du brauchst

Eine einzige Sache: einen API-Schlüssel. Erstelle einen im Bereich Entwickler des Kontos (Vollzugriff erreicht alles, was der Eigentümer des Schlüssels kann, benutzerdefinierter Zugriff nur eine freigegebene Menge von Methoden), siehe Authentifizierung. Es gibt keine separaten MCP-Zugangsdaten, derselbe Schlüssel funktioniert per einfachem REST unter /cpi/<method> und über MCP.

Ein Endpunkt für jeden Schlüssel

Jeder API-Schlüssel eines Kontos und der automatisch ausgestellte Schlüssel jeder Full-Stack-VPS-Maschine zeigen auf dieselbe Adresse: https://xuda.ai/mcp. Ein Full-Stack-VPS-Schlüssel stellt zusätzlich zu den Methoden des Ökosystems die installierten Plugin-Tools dieser Maschine bereit, siehe Full Stack VPS.

Einen Client verbinden

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Cursor liest sein Snippet aus .cursor/mcp.json (Projekt) oder aus seinen globalen MCP-Einstellungen. Claude Desktop und claude.ai fügen einen entfernten Server über die Einstellungen unter Konnektoren hinzu: einen Namen, die URL und denselben Authorization-Header. Jeder andere MCP-Client braucht nur dieselben zwei Angaben: einen Streamable-HTTP-Endpunkt unter https://xuda.ai/mcp und den Schlüssel bei jeder Anfrage als Authorization: Bearer YOUR_API_KEY.

Das Dashboard schreibt das für dich

Die Seite Entwickler, API-Schlüssel jedes Kontos hat unter der Schlüsselliste eine Karte Verbinden. Ihre Formatauswahl schaltet einen Block zwischen .env, Next.js, MCP, cURL, Node.js und PHP um, jeweils bereits mit dem Endpunkt und dem ersten Schlüssel der Liste ausgefüllt, den die Kopfzeile des Blocks nennt. Das Format .env trägt XUDA_MCP_URL neben der REST-Basis und dem Schlüssel, und das MCP-Format ist der Claude-Code-Befehl oben. Der Schlüssel wird maskiert angezeigt, bis du ihn einblendest; Kopieren nimmt immer den echten Wert.

Was der Agent beim Verbinden bekommt

Die erste Anfrage einer neuen Verbindung ist ein MCP-initialize-Aufruf. Die Antwort von Xuda trägt ein Feld instructions, gebaut aus dem Studio-LLM-Leitfaden, demselben Prog-Dokumentmodell, derselben xu-*-Attributreferenz und denselben Workflow-Regeln, die auf dieser Seite behandelt werden, zusammengeführt aus den eigenen Live-Registern der Plattform, damit nie eine Regel beschrieben wird, die der bereitgestellte Validator gar nicht durchsetzt. Die meisten MCP-Clients reichen instructions direkt in den Kontext des Modells weiter, der Agent weiß also schon vor seinem ersten Tool-Aufruf, wie ein Studio-Prog aufgebaut ist, ohne separates Briefing.

Zwei Tools solltest du direkt aufrufen, statt dich auf das zu verlassen, was beim Verbinden ankam: get_studio_guide liest jedes Thema bei Bedarf neu (components, tables, programs, javascript, attributes, anatomy, gotchas), und get_prog_examples liefert funktionierende, kuratierte Beispiel-Progs, an denen du einen Bau ausrichten kannst.

Ein eigener Endpunkt für ein API-Programm

Die obigen Methoden sind der gesamte Katalog des Kontos hinter einem Schlüssel. Willst du, dass ein externes System stattdessen genau einen Endpunkt eines Projekts erreicht, stelle ihn bereit: Bereitstellen > Bereitstellungen > Server listet MCP-Server neben Cron, Api, Node und Emitter auf. Der Schritt Starteinstellungen wählt eines der eigenen api-Programme des Projekts als Ziel, dann liefern die üblichen Schritte für Rechenzentrum, Leistungsstufe und Benennung es als eigenen Endpunkt aus. Siehe Dein erstes Deployment für die gemeinsamen Teile dieses Assistenten und API dafür, was ein api-Programm ist.

Beta-Deploy-Typ

mcp steht heute unter den Beta-Deploy-Typen der Plattform, neben router, android und emitter.