server_url και server_label
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση τη σελίδα Remote MCP Tools της xAI: το
server_labelπροσθέτει πρόθεμα στις κλήσεις εργαλείων, αλλά η τεκμηρίωση δεν καθορίζει την ακριβή μορφή του προθέματος· η σημειογραφίαlabel__toolπου χρησιμοποιείται σε αυτό το μάθημα αποτελεί σύμβαση ανάγνωσης—επαληθεύστε την πραγματική μορφή στις αποκρίσεις του API σας. Πηγή: Remote MCP Tools.
Οι δύο παράμετροι χωρίς τις οποίες δεν μπορείτε να προχωρήσετε
Κάθε σύνδεση μεταξύ του Grok και ενός απομακρυσμένου διακομιστή MCP βασίζεται σε δύο παραμέτρους: server_url και server_label. Είναι αδιαπραγμάτευτες· χωρίς αυτές, το API απορρίπτει το αίτημα πριν επιχειρήσει οτιδήποτε. Όλες οι άλλες παράμετροι που θα συναντήσετε στη συνέχεια βελτιώνουν αυτό το θεμέλιο· δεν το αντικαθιστούν ποτέ.
server_url: Η ακριβής διεύθυνση του endpoint
Η παράμετρος server_url περιέχει το πλήρες URL του διακομιστή MCP στον οποίο πρέπει να συνδεθεί το Grok, και αυτό το URL ακολουθεί αυστηρούς κανόνες.
Ο πρώτος κανόνας είναι το HTTPS. Το URL πρέπει να ξεκινά με https:// και η xAI απορρίπτει οποιαδήποτε μη κρυπτογραφημένη σύνδεση HTTP. Ο λόγος είναι απλός: οι ανταλλαγές μεταξύ του Grok και του διακομιστή MCP μεταφέρουν τα αιτήματα των χρηστών σας, τα αποτελέσματα των εργαλείων και μερικές φορές το ίδιο το διακριτικό πιστοποίησης. Το να αφήσετε αυτά τα δεδομένα να κυκλοφορούν ως απλό κείμενο θα ήταν αδικαιολόγητο.
# Σωστό
mcp(server_url="https://mcp.deepwiki.com/mcp")
# Απορρίπτεται από το API
mcp(server_url="http://mcp.deepwiki.com/mcp")
Ο δεύτερος κανόνας αφορά την ακρίβεια της διαδρομής. Το URL πρέπει να δείχνει στο endpoint του MCP, όχι στη ρίζα του τομέα. Σχεδόν όλοι οι διακομιστές εκθέτουν το endpoint τους σε μια αφιερωμένη διαδρομή και η σύμβαση διαφέρει από τον έναν στον άλλον. Ακολουθούν τρεις έγκυρες μορφές που θα συναντήσετε:
https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp
Ο τρίτος κανόνας προκύπτει από τους δύο πρώτους: το localhost και οι ιδιωτικές διευθύνσεις IP αποκλείονται. Ο διακομιστής πρέπει να είναι προσβάσιμος από την υποδομή της xAI, σε έναν δημόσιο τομέα, με έγκυρο πιστοποιητικό SSL. Αυτό θέτει ένα συγκεκριμένο ερώτημα κατά την ανάπτυξη, καθώς ο διακομιστής MCP που γράφετε εκτελείται στο μηχάνημά σας. Η συνήθης λύση είναι η χρήση μιας σήραγγας—για παράδειγμα ngrok ή Cloudflare Tunnel—η οποία εκθέτει την τοπική σας instance πίσω από ένα δημόσιο URL HTTPS για τη διάρκεια των δοκιμών σας.
server_label: Η ταυτότητα του διακομιστή στη συνομιλία
Το server_label είναι ένας σύντομος αναγνωριστικός κωδικός που χρησιμοποιεί το Grok για να προσθέσει πρόθεμα στις κλήσεις εργαλείων από αυτόν τον διακομιστή. Ο ρόλος του είναι διττός: να κάνει τα ίχνη ευανάγνωστα και να εξαλείψει κάθε ασάφεια όταν συνυπάρχουν πολλαπλοί διακομιστές.
Η τεκμηρίωση της xAI αναφέρει ότι η ετικέτα προσθέτει πρόθεμα στις κλήσεις εργαλείων από αυτόν τον διακομιστή, χωρίς να καθορίζει την ακριβή μορφή του προθέματος. Σε αυτό το μάθημα, συμβολίζουμε ένα εργαλείο search_docs από τον διακομιστή deepwiki ως deepwiki__search_docs, για λόγους ευανάγνωσης: επαληθεύστε την πραγματική μορφή στις αποκρίσεις του API πριν χτίσετε λογική πάνω σε αυτήν.
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
# Οι κλήσεις εργαλείων από αυτόν τον διακομιστή θα έχουν το πρόθεμα "deepwiki"
Τρία κριτήρια καθοδηγούν την επιλογή μιας καλής ετικέτας. Πρέπει να είναι σύντομη, καθώς προστίθεται στο όνομα κάθε κλήσης και μια verbose ετικέτα φουσκώνει άσκοπα τα αρχεία καταγραφής σας. Πρέπει να είναι περιγραφική, ώστε η πηγή μιας κλήσης να είναι ευανάγνωστη με μια ματιά, χωρίς να χρειάζεται να συμβουλευτείτε τη διαμόρφωση. Πρέπει να είναι μοναδική στη διαμόρφωσή σας, διαφορετικά δεν θα μπορείτε να διακρίνετε μεταξύ δύο διακομιστών. Τα παρακάτω παραδείγματα πληρούν αυτές τις τρεις απαιτήσεις:
server_label="deepwiki" # Τεκμηρίωση GitHub
server_label="crm" # Σύστημα διαχείρισης πελατών
server_label="jira" # Παρακολούθηση εισιτηρίων
server_label="search" # Εσωτερική μηχανή αναζήτησης
Αυτό γίνεται πολύ πιο απτό μόλις συνδέσετε πολλαπλούς διακομιστές στην ίδια συνεδρία. Υποθέστε ότι η εσωτερική σας τεκμηρίωση και το DeepWiki εκθέτουν και τα δύο ένα εργαλείο που ονομάζεται search. Χωρίς διακριτικές ετικέτες, τα ονόματα των εργαλείων συγκρούονται και το Grok δεν έχει τρόπο να ξέρει ποιο να στοχεύσει. Με τις ετικέτες, τα δύο εργαλεία λαμβάνουν διαφορετικά προθέματα—εδώ σημειώνονται ως deepwiki__search και internal-docs__search—και η σύγχυση εξαφανίζεται. Θα επανέλθετε σε αυτό το σημείο στο μάθημα που είναι αφιερωμένο σε πολλαπλούς διακομιστές.
Ελάχιστη διαμόρφωση και στα δύο SDK
Μαζί, αυτές οι δύο παράμετροι αρκούν για να λειτουργήσει ένας δημόσιος διακομιστής MCP. Με το εγγενές SDK της xAI:
from xai_sdk.tools import mcp
tools = [
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
]
Και το ακριβές ισοδύναμο με το Responses API σε μορφή OpenAI:
tools = [{
"type": "mcp",
"server_url": "https://mcp.deepwiki.com/mcp",
"server_label": "deepwiki",
}]
Βασικά σημεία
- Τα
server_urlκαιserver_labelείναι οι μόνες δύο απαιτούμενες παράμετροι - Το URL πρέπει να είναι HTTPS με έγκυρο πιστοποιητικό SSL, χωρίς localhost
- Η ετικέτα προσθέτει πρόθεμα σε όλες τις κλήσεις εργαλείων από αυτόν τον διακομιστή (η ακριβής μορφή δεν τεκμηριώνεται· αυτό το μάθημα τη σημειώνει ως
label__tool) - Επιλέξτε ετικέτες που είναι σύντομες, περιγραφικές και μοναδικές ανά διακομιστή
- Η ετικέτα είναι απαραίτητη για πολλαπλούς διακομιστές ώστε να αποφεύγονται οι συγκρούσεις ονομάτων