Σύνδεση ενός client AI μέσω MCP
Προσθέστε το Xuda ως απομακρυσμένο διακομιστή MCP στο Claude, το Cursor ή οποιονδήποτε άλλο client που υποστηρίζει MCP.
Αυτή η σελίδα αφορά την πλευρά του client: να κάνετε το Claude, το Cursor ή οτιδήποτε άλλο μιλά MCP να επικοινωνήσει με τον λογαριασμό σας στο Xuda. Για το ίδιο το πρωτόκολλο, την ονομασία εργαλείων, τον κύκλο ζωής της συνεδρίας, τη μορφή σφαλμάτων, δείτε το MCP.
Τι χρειάζεστε
Ένα πράγμα: ένα κλειδί API. Δημιουργήστε ένα από την περιοχή Προγραμματιστές του λογαριασμού (η πλήρης πρόσβαση φτάνει
σε ό,τι μπορεί ο ιδιοκτήτης του κλειδιού, η προσαρμοσμένη πρόσβαση φτάνει μόνο σε ένα σύνολο επιτρεπόμενων μεθόδων), δείτε
Αυθεντικοποίηση. Δεν υπάρχει ξεχωριστό διαπιστευτήριο MCP, το ίδιο κλειδί
δουλεύει μέσω απλού REST στο /cpi/<method> και μέσω MCP.
Κάθε κλειδί API λογαριασμού, και το αυτόματα εκδοθέν κλειδί κάθε μηχανήματος Πλήρες VPS, δείχνουν στην ίδια
διεύθυνση: https://xuda.ai/mcp. Ένα κλειδί Πλήρες VPS εκθέτει επιπλέον τα εργαλεία πρόσθετων που είναι εγκατεστημένα στο μηχάνημα
δίπλα στις μεθόδους του οικοσυστήματος, δείτε Full Stack VPS.
Συνδέστε έναν client
Το 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.
Η σελίδα Προγραμματιστές, Κλειδιά 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.
Το mcp παρατίθεται σήμερα ανάμεσα στους τύπους ανάπτυξης beta της πλατφόρμας, μαζί με τα router, android και
emitter.