Πιστοποίηση και κεφαλίδες
Σε αυτήν τη σελίδα
Αποδείξτε ποιος καλεί
Το DeepWiki και άλλοι δημόσιοι διακομιστές MCP δέχονται οποιονδήποτε καλούντα, κάτι που συνάδει με τον σκοπό τους. Μόλις όμως εκθέσετε τα δικά σας εργαλεία, τα δεδομένα αλλάζουν: χωρίς πιστοποίηση, οποιοσδήποτε μαντέψει το URL μπορεί να αναρωτήσει το CRM σας ή να ενεργοποιήσει τις διαδικασίες σας. Η xAI παρέχει δύο παραμέτρους για την αντιμετώπιση αυτού του ζητήματος: το authorization για το διακριτικό πρόσβασης και τα headers ή extra_headers για οτιδήποτε άλλο.
Η παράμετρος authorization
Στέλνει ένα διακριτικό πιστοποίησης στον διακομιστή MCP. Συγκεκριμένα, η συμβολοσειρά που παρέχετε τοποθετείται ως έχει στην κεφαλίδα HTTP Authorization κάθε αιτήματος που αποστέλλεται σε αυτόν τον διακομιστή.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-your-token-here"
)
Η αναμενόμενη μορφή εξαρτάται εξ ολοκλήρου από τον διακομιστή προορισμού, καθώς το authorization δέχεται οποιαδήποτε συμβολοσειρά: ο διακομιστής MCP την επικυρώνει, όχι η xAI. Τρεις μορφές καλύπτουν σχεδόν όλες τις περιπτώσεις που θα συναντήσετε.
- Διακριτικό Bearer:
"Bearer sk-xxxx"— η πιο συνηθισμένη, χρησιμοποιείται από την πλειοψηφία των REST APIs - Κλειδί API:
"ApiKey your-key"— ορισμένες υπηρεσίες χρησιμοποιούν ένα προσαρμοσμένο πρόθεμα - Βασική πιστοποίηση (Basic auth):
"Basic base64(user:password)"— βασική πιστοποίηση κωδικοποιημένη σε base64
Επειδή αυτό το διακριτικό συνοδεύει κάθε αίτημα, ο χειρισμός του απαιτεί προσοχή. Μην το ενσωματώνετε ποτέ απευθείας στον πηγαίο κώδικά σας: ένα μυστικό γραμμένο σε αρχείο υπό έλεγχο εκδόσεων καταλήγει τελικά σε ένα αποθετήριο, σε αρχείο καταγραφής ή σε στιγμιότυπο οθόνης. Χρησιμοποιείτε πάντα μεταβλητή περιβάλλοντος. Εάν ο διακομιστής το επιτρέπει, προτιμήστε ένα διακριτικό με περιορισμένο πεδίο εφαρμογής που ανοίγει μόνο τα εργαλεία που χρειάζεστε πραγματικά — αυτή είναι η αντίστοιχη ενέργεια στην πλευρά του διακομιστή για τον περιορισμό allowed_tool_names. Προγραμματίστε επίσης την τακτική περιστροφή των διακριτικών, ειδικά σε περιβάλλον παραγωγής, όπου ένα διακριτικό αιώνιας διάρκειας είναι ένα διακριτικό που τελικά θα διαρρεύσει.
import os
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)
headers και extra_headers
Το διακριτικό απαντά στο ερώτημα «ποιος είστε». Πολλοί διακομιστές χρειάζονται πρόσθετες απαντήσεις: για ποιον οργανισμό, σε ποιο περιβάλλον, με ποια έκδοση API. Αυτές οι πληροφορίες διαβιβάζονται μέσω της παραμέτρου headers ή extra_headers, ανάλογα με το SDK.
mcp(
server_url="https://api.example.com/mcp",
server_label="internal",
authorization="Bearer sk-token",
headers={
"X-Organization-Id": "org-123",
"X-Project-Id": "proj-456"
}
)
Η πιο συνηθισμένη περίπτωση αφορά τις πολυ tenant πλατφόρμες, όπου το ίδιο τελικό σημείο εξυπηρετεί πολλούς πελάτες και βασίζεται σε μια κεφαλίδα για να δρομολογήσει το αίτημα στα σωστά δεδομένα. Ακολουθεί η εκδοσιοποίηση της API, με μια κεφαλίδα όπως "X-API-Version": "2024-01" που παγιώνει μια συγκεκριμένη έκδοση και σας προστατεύει από αλλαγές στον διακομιστή. Ορισμένα συστήματα αναμένουν επίσης μεταδεδομένα παρακολούθησης — ID συνεδρίας, ID πράκτορα — για την ιχνηλάτηση της προέλευσης των κλήσεων, ή κεφαλίδες ορίου ρυθμού που καθορίζουν το εφαρμοζόμενο πρόγραμμα χρέωσης.
Το όνομα της παραμέτρου varies ανάλογα με τη διεπαφή που χρησιμοποιείτε. Το εγγενές SDK της xAI χρησιμοποιεί το headers στις περισσότερες περιπτώσεις· το Responses API μορφής OpenAI ενδέχεται να απαιτεί το extra_headers, για να αποφευχθεί οποιαδήποτε σύγκρουση με κεφαλίδες που αυτό το SDK διαχειρίζεται αυτόματα για τον εαυτό του. Η συμπεριφορά, ωστόσο, είναι ακριβώς η ίδια: οι κεφαλίδες προστίθενται σε κάθε αίτημα προς τον διακομιστή MCP. Εάν τα αιτήματά σας εξέρχονται χωρίς τις κεφαλίδες σας, ελέγξτε πρώτα αυτό το όνομα παραμέτρου πριν αναζητήσετε αλλού.
Μια πλήρης διαμόρφωση για παραγωγή
Ακολουθεί ο τρόπος με τον οποίο αυτές οι παράμετροι συνδυάζονται με εκείνες από προηγούμενα μαθήματα, σε μια ρεαλιστική περίπτωση εσωτερικού διακομιστή.
from xai_sdk.tools import mcp
import os
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="internal",
server_description="Internal tools: CRM, documentation, tickets",
authorization=f"Bearer {os.getenv('INTERNAL_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production"
},
allowed_tool_names=["search_docs", "get_ticket", "search_contacts"]
)
]
Αυτή η διαμόρφωση συνδέεται με τον εσωτερικό διακομιστή MCP μέσω HTTPS, πιστοποιείται με ένα διακριτικό Bearer αποθηκευμένο σε μεταβλητή περιβάλλοντος, στέλνει το ID του οργανισμού σε μια κεφαλίδα και περιορίζει την πρόσβαση σε τρεις λειτουργίες ανάγνωσης. Σημειώστε ότι κάθε γραμμή κλειδώνει μια διαφορετική πτυχή: η κρυπτογράφηση προστατεύει τη μεταφορά, το διακριτικό αποδεικνύει την ταυτότητα, η κεφαλίδα ορίζει το εύρος των δεδομένων και η λίστα επιτρεπόμενων ονομάτων περιορίζει τις πιθανές ζημιές. Κανένα από αυτά τα επίπεδα δεν αντικαθιστά τα άλλα.
Βασικά σημεία
- Το
authorizationστέλνει το διακριτικό πρόσβασης στον διακομιστή MCP μέσω της κεφαλίδας HTTP Authorization - Αποθηκεύετε πάντα τα διακριτικά σας σε μεταβλητές περιβάλλοντος, ποτέ σκληρά κωδικοποιημένα στον κώδικα
- Τα
headers/extra_headersπροσθέτουν επιπλέον κεφαλίδες HTTP σε κάθε αίτημα - Οι κεφαλίδες εξυπηρετούν την ταυτοποίηση πολυ tenant, την εκδοσιοποίηση API και την παρακολούθηση
- Συνδυάστε την πιστοποίηση και τον περιορισμό εργαλείων για μέγιστη ασφάλεια