Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Σύνδεση ενός client AI μέσω MCP

Προσθέστε το Xuda ως απομακρυσμένο διακομιστή MCP στο Claude, το Cursor ή οποιονδήποτε άλλο client που υποστηρίζει MCP.

Αυτή η σελίδα αφορά την πλευρά του client: να κάνετε το Claude, το Cursor ή οτιδήποτε άλλο μιλά MCP να επικοινωνήσει με τον λογαριασμό σας στο Xuda. Για το ίδιο το πρωτόκολλο, την ονομασία εργαλείων, τον κύκλο ζωής της συνεδρίας, τη μορφή σφαλμάτων, δείτε το MCP.

Τι χρειάζεστε

Ένα πράγμα: ένα κλειδί API. Δημιουργήστε ένα από την περιοχή Προγραμματιστές του λογαριασμού (η πλήρης πρόσβαση φτάνει σε ό,τι μπορεί ο ιδιοκτήτης του κλειδιού, η προσαρμοσμένη πρόσβαση φτάνει μόνο σε ένα σύνολο επιτρεπόμενων μεθόδων), δείτε Αυθεντικοποίηση. Δεν υπάρχει ξεχωριστό διαπιστευτήριο MCP, το ίδιο κλειδί δουλεύει μέσω απλού REST στο /cpi/<method> και μέσω MCP.

Ένα endpoint για κάθε κλειδί

Κάθε κλειδί API λογαριασμού, και το αυτόματα εκδοθέν κλειδί κάθε μηχανήματος Πλήρες VPS, δείχνουν στην ίδια διεύθυνση: https://xuda.ai/mcp. Ένα κλειδί Πλήρες VPS εκθέτει επιπλέον τα εργαλεία πρόσθετων που είναι εγκατεστημένα στο μηχάνημα δίπλα στις μεθόδους του οικοσυστήματος, δείτε Full Stack VPS.

Συνδέστε έναν client

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 διαβάζει το snippet του από το .cursor/mcp.json (έργο) ή από τις καθολικές ρυθμίσεις MCP. Το Claude Desktop και το claude.ai προσθέτουν έναν απομακρυσμένο διακομιστή από τις Ρυθμίσεις, στο Connectors: ένα όνομα, το URL και την ίδια κεφαλίδα Authorization. Κάθε άλλος client MCP χρειάζεται μόνο τα ίδια δύο στοιχεία: ένα streamable HTTP endpoint στο https://xuda.ai/mcp, και το κλειδί σε κάθε αίτημα ως Authorization: Bearer YOUR_API_KEY.

Το dashboard το γράφει για εσάς

Η σελίδα Προγραμματιστές, Κλειδιά API κάθε λογαριασμού έχει μια κάρτα Connect κάτω από τη λίστα κλειδιών. Ο επιλογέας μορφής αλλάζει ένα block ανάμεσα σε .env, Next.js, MCP, cURL, Node.js και PHP, καθένα ήδη συμπληρωμένο με το endpoint και το πρώτο κλειδί της λίστας, το οποίο ονομάζει η κεφαλίδα του block. Η μορφή .env περιέχει το XUDA_MCP_URL δίπλα στη βάση REST και το κλειδί, και η μορφή MCP είναι η εντολή Claude Code παραπάνω. Το κλειδί εμφανίζεται συγκαλυμμένο μέχρι να το αποκαλύψετε· το Copy παίρνει πάντα την πραγματική τιμή.

Τι παίρνει ο πράκτορας κατά τη σύνδεση

Το πρώτο αίτημα σε μια νέα σύνδεση είναι μια κλήση MCP initialize. Η απάντηση του Xuda περιέχει ένα πεδίο instructions χτισμένο από τον οδηγό LLM του Studio, το ίδιο μοντέλο εγγράφων prog, την αναφορά attributes xu-* και τους κανόνες ροής εργασίας που καλύπτονται σε εκείνη τη σελίδα, συγχωνευμένα από τα ζωντανά μητρώα της ίδιας της πλατφόρμας ώστε να μην περιγράφει ποτέ έναν κανόνα που ο αναπτυγμένος επικυρωτής δεν επιβάλλει πραγματικά. Οι περισσότεροι clients MCP προωθούν τα instructions απευθείας στο πλαίσιο του μοντέλου, οπότε ο πράκτορας ξέρει ήδη πώς συντίθεται ένα prog του Studio πριν από την πρώτη κλήση εργαλείου, χωρίς ξεχωριστή ενημέρωση.

Δύο εργαλεία αξίζει να καλούνται απευθείας αντί να βασίζεστε σε ό,τι ήρθε κατά τη σύνδεση: το get_studio_guide ξαναδιαβάζει οποιοδήποτε θέμα κατά παραγγελία (components, tables, programs, javascript, attributes, anatomy, gotchas), και το get_prog_examples επιστρέφει λειτουργικά, επιλεγμένα παραδείγματα progs πάνω στα οποία μπορείτε να βασίσετε μια κατασκευή.

Ένα ειδικό endpoint για ένα πρόγραμμα API

Οι παραπάνω μέθοδοι είναι ολόκληρος ο κατάλογος του λογαριασμού πίσω από ένα κλειδί. Όταν θέλετε ένα εξωτερικό σύστημα να φτάνει ακριβώς σε ένα endpoint ενός έργου, αναπτύξτε το: το Ανάπτυξη > Αναπτύξεις > Server παραθέτει τον Διακομιστής MCP δίπλα στα Cron, Api, Node και Emitter. Το βήμα Ρυθμίσεις εκκίνησης του επιλέγει ένα από τα δικά του προγράμματα api του έργου ως στόχο, και μετά τα συνήθη βήματα datacenter, επιπέδου απόδοσης και ονομασίας το στέλνουν ως δικό του endpoint. Δείτε Η πρώτη σας ανάπτυξη για τα κοινά μέρη αυτού του οδηγού, και API για το τι είναι ένα πρόγραμμα api.

Τύπος ανάπτυξης beta

Το mcp παρατίθεται σήμερα ανάμεσα στους τύπους ανάπτυξης beta της πλατφόρμας, μαζί με τα router, android και emitter.