Ugrás a tartalomhoz
Ellenőrizve

AI-kliens csatlakoztatása MCP-n keresztül

Adja hozzá a Xudát távoli MCP szerverként a Claude-hoz, a Cursorhoz vagy bármely más MCP-t értő klienshez.

Ez az oldal a kliensoldalról szól: hogyan beszéljen a Claude, a Cursor vagy bármi más, amely MCP-t ért, a Xuda-fiókjával. Magáról a protokollról, az eszközök elnevezéséről, a munkamenet életciklusáról és a hibák alakjáról lásd az MCP oldalt.

Mire van szüksége

Egyetlen dologra: egy API-kulcsra. Hozzon létre egyet a fiók Fejlesztők területén (a teljes hozzáférés mindent elér, amit a kulcs tulajdonosa, az egyéni hozzáférés csak egy engedélyezőlistán szereplő metóduskészletet), lásd Hitelesítés. Nincs külön MCP hitelesítő adat, ugyanaz a kulcs működik egyszerű REST-en a /cpi/<method> címen és MCP-n keresztül is.

Egy végpont minden kulcshoz

Minden fiók API-kulcsa és minden Teljes körű VPS gép saját, automatikusan kiadott kulcsa ugyanarra a címre mutat: https://xuda.ai/mcp. A Teljes körű VPS kulcs ezen felül az adott gépre telepített bővítmény eszközeit is kiteszi az ökoszisztéma-metódusok mellett, lásd Teljes körű VPS.

Kliens csatlakoztatása

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" }
    }
  }
}

A Cursor a kódrészletét a .cursor/mcp.json fájlból (projekt) vagy a globális MCP-beállításaiból olvassa. A Claude Desktop és a claude.ai a Settings, majd Connectors alatt ad hozzá távoli szervert: egy nevet, az URL-t és ugyanazt az Authorization fejlécet. Bármely más MCP-kliensnek csak ugyanez a két tény kell: egy streamelhető HTTP-végpont az https://xuda.ai/mcp címen, és a kulcs minden kérésben Authorization: Bearer YOUR_API_KEY formában.

Az irányítópult megírja Ön helyett

Minden fiók Fejlesztők, API-kulcsok oldalán van egy Connect kártya a kulcslista alatt. A formátumválasztója egyetlen blokkot kapcsol át .env, Next.js, MCP, cURL, Node.js és PHP között, mindegyik már kitöltve a végponttal és a lista első kulcsával, amelyet a blokk fejléce megnevez. A .env formátum az XUDA_MCP_URL értéket hordozza a REST alap és a kulcs mellett, az MCP formátum pedig a fenti Claude Code parancs. A kulcs maszkolva látszik, amíg fel nem fedi; a Copy mindig a valódi értéket másolja.

Mit kap az ügynök csatlakozáskor

Az új kapcsolat első kérése egy MCP initialize hívás. A Xuda válasza egy instructions mezőt hordoz, amely a A Studio LLM útmutatója alapján épül, ugyanazt a prog dokumentummodellt, xu-* attribútum-referenciát és munkafolyamat-szabályokat tartalmazza, amelyek azon az oldalon szerepelnek, a platform saját élő nyilvántartásaiból összefésülve, így soha nem írhat le olyan szabályt, amelyet a telepített érvényesítő ténylegesen nem kényszerít ki. A legtöbb MCP-kliens az instructions tartalmát közvetlenül a modell kontextusába továbbítja, így az ügynök már az első eszközhívás előtt tudja, hogyan épül fel egy Studio prog, külön eligazítás nélkül.

Két eszközt érdemes közvetlenül hívni, ahelyett hogy a csatlakozáskor beérkezőre hagyatkozna: a get_studio_guide igény szerint újraolvas bármely témát (components, tables, programs, javascript, attributes, anatomy, gotchas), a get_prog_examples pedig működő, válogatott példa progokat ad vissza, amelyekre egy építés mintázható.

Dedikált végpont egyetlen API-programhoz

A fenti metódusok a teljes fiók katalógusát jelentik egyetlen kulcs mögött. Ha azt szeretné, hogy egy külső rendszer pontosan egy projekt egyetlen végpontját érje el, telepítse azt: a Telepítés > Élesítések > Server listában az MCP szerver található a Cron, Api, Node és Emitter mellett. Az Indítási beállítások lépése a projekt egyik saját api programját jelöli ki célként, majd a szokásos adatközpont-, teljesítményszint- és elnevezési lépések saját végpontként élesítik. A varázsló közös részeiről lásd Az első telepítése, arról pedig, mi az api program, az API oldalt.

Béta telepítési típus

Az mcp ma a platform béta telepítési típusai között szerepel, a router, android és emitter mellett.