Visiška MCP serverio konfigūracija
Šiame puslapyje
Viskas kartu
Iki šiol nagrinėjai kiekvieną parametrą atskirai. Šioje pamokoje juos sujungsime į pilnas konfigūracijas, lygiai taip, kaip rašysi jas praktikoje, kiekvieną kartą parodydami ekvivalentą abiejuose pagrindiniuose SDK. Tikslas – ne pristatyti naujų sąvokų, o suteikti tau šablonus, kuriuos galėtum pritaikyti tiesiogiai.
Štai šešių parametrų apžvalga su jų privalomu arba pasirenkamu statusu.
| Parametras | Privalomas | Vaidmuo |
|---|---|---|
server_url | Taip | MCP serverio HTTPS URL |
server_label | Taip | Įrankio iškvietimo priešdėlis |
server_description | Ne | Padeda „Grok“ pasirinkti serverį |
allowed_tool_names | Ne | Apriboja pasiekiamus įrankius |
authorization | Ne | Autentifikavimo žetonas |
headers | Ne | Papildomos HTTP antraštės |
Paprasčiausias atvejis
Kai serveris yra viešas ir nereikalauja autentifikavimo, pakanka dviejų parametrų.
# xAI SDK
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"
}]
Būtent taip ir rašysi dirbdamas su „DeepWiki“. Tuomet „Grok“ gauna prieigą prie visų serverio įrankių, kas šiuo atveju yra priimtina, nes tai vieša tik skaitymui skirta paslauga. Tačiau kai tik serveris priklauso tavo organizacijai, tokios konfigūracijos nepakanka.
Tik skaitymui skirtas vidinis serveris
Pakilkime lygmeniu aukščiau: įmonės CRM sistema, kurią agentas turi galėti užklausti, bet niekada negali modifikuoti. Pridedami trys parametrai, kiekvienas dėl skirtingos priežasties – aprašymas nukreipia modelį, žetonas įrodo tapatybę, o leidimų sąrašas draudžia rašymo operacijas.
# xAI SDK
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="crm",
server_description="Internal CRM. Contact and company lookup only.",
authorization=f"Bearer {os.getenv('CRM_TOKEN')}",
allowed_tool_names=["search_contacts", "get_contact", "list_companies"]
)
]
# Responses API (OpenAI)
tools = [{
"type": "mcp",
"server_url": "https://api.monentreprise.com/mcp",
"server_label": "crm",
"server_description": "Internal CRM. Contact and company lookup only.",
"authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
"allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]
Palygink abu blokus: turinys identiškas, keičiasi tik apvalkalas. Pagalbinė funkcija mcp() priima įvardytus argumentus, o „OpenAI“ formatas tikisi žodyno su papildomu raktu "type". Tai vienintelis skirtumas, kurį reikia atminti verčiant konfigūraciją iš vieno SDK į kitą.
Išsami konfigūracija
Paskutinis žingsnis – visi šeši parametrai sujungti realiame „xAI SDK“ iškvietime.
import os
from xai_sdk import Client
from xai_sdk.tools import mcp
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(
model="grok-4.20-0309-reasoning",
tools=[
mcp(
server_url="https://tools.monentreprise.com/v1/mcp",
server_label="outils-internes",
server_description="Internal tools platform: document management, support tickets, knowledge base. Read-only access.",
authorization=f"Bearer {os.getenv('TOOLS_MCP_TOKEN')}",
headers={
"X-Organization-Id": os.getenv("ORG_ID"),
"X-Environment": "production",
"X-Request-Source": "grok-agent"
},
allowed_tool_names=[
"search_documents",
"get_document",
"search_tickets",
"get_ticket",
"search_knowledge_base"
]
)
],
include=["verbose_streaming"],
)
Atkreipk dėmesį į šio pavyzdžio vidinį nuoseklumą. Aprašyme nurodyta prieiga tik skaitymui, o penki leidžiami įrankiai yra tik užklausų operacijos – jokių prieštaravimų tarp to, ką modelis mano galintis daryti, ir to, ką leidžia konfigūracija. Antraštė X-Environment, nustatyta kaip production, neleidžia testiniam agentui rašyti į gyvus duomenis, o X-Request-Source padės tavo serverio žurnaluose identifikuoti netikėtų užklausų šaltinį, jei prireiktų atlikti tyrimą.
Patikrink prieš diegdamas
Prieš bet kokį diegimą gamybinėje aplinkoje verta peržiūrėti šešis punktus, ir kiekvienas jų atitinka ankstesnes šio kurso metu aptartas klaidas. URL privalo būti HTTPS su galiojančiu sertifikatu, kitaip niekas neveiks. Etiketė turi būti trumpa, aiški ir unikali konfigūracijos ribose. Aprašymas turi atitikti realiai eksponuojamus įrankius, kitaip modelis bandys vykdyti iškvietimus, kurie pasmerkti žlugti. Leidžiami įrankiai turi būti sumažinti iki absoliučiai būtino minimumo. Žetonas turi būti gaunamas iš aplinkos kintamojo, o ne įrašytas tiesiai į kodą. Papildomos antraštės turi tiksliai atitikti serverio lūkesčius, įskaitant didžiųjų ir mažųjų raidžių rašybą – klaida rašant X-Organization-Id sukels tylią nesėkmę, kurią diagnozuoti ypač sunku.
Svarbiausi punktai
- Minimaliai konfigūracijai pakanka tik
server_urlirserver_label - Pridėk
server_description, kad nukreiptum „Grok“, ypač naudojant kelis serverius - Saugumui ir našumui apribok naudodamas
allowed_tool_names - Autentifikavimui naudok
authorizationirheaders - Abu SDK (natūralus „xAI“ ir „OpenAI Responses“) priima tuos pačius parametrus, tik skirtinga sintakse