Konfigurera en komplett MCP-server
På denna sida
Sätta ihop allt
Du har stött på varje parameter var för sig. I denna lektion slår vi ihop dem till kompletta konfigurationer, exakt så som du kommer att skriva dem i praktiken, och visar varje gång motsvarigheten i båda huvud-SDK:erna. Målet är inte att introducera nya begrepp utan att ge dig mönster som du kan anpassa direkt.
Här är en översikt över de sex parametrarna, med deras status som obligatorisk eller valfri.
| Parameter | Obligatorisk | Roll |
|---|---|---|
server_url | Ja | HTTPS-URL till MCP-servern |
server_label | Ja | Prefix för verktygsanrop |
server_description | Nej | Vägleder Grok vid val av server |
allowed_tool_names | Nej | Begränsar tillgängliga verktyg |
authorization | Nej | Autentiseringstoken |
headers | Nej | Ytterligare HTTP-headers |
Det enklaste fallet
Två parametrar räcker när servern är offentlig och inte kräver någon autentisering.
# 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"
}]
Detta är exakt vad du kommer att skriva för DeepWiki. Grok får då tillgång till alla serverns verktyg, vilket är acceptabelt här eftersom det rör sig om en offentlig skrivskyddad tjänst. Så snart servern tillhör din organisation blir denna konfiguration otillräcklig.
En intern skrivskyddad server
Låt oss ta ett steg upp: ett företags-CRM som agenten måste kunna fråga men aldrig modifiera. Tre parametrar läggs till, var och en av en specifik anledning – beskrivningen vägleder modellen, token bevisar identitet och allowlistan förbjuder skrivoperationer.
# xAI SDK
tools = [
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="crm",
server_description="Internt CRM. Endast uppslag av kontakter och företag.",
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": "Internt CRM. Endast uppslag av kontakter och företag.",
"authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
"allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]
Jämför de två blocken: innehållet är identiskt; endast omslaget skiljer sig. Hjälpfunktionen mcp() tar namngivna argument; OpenAI-formatet förväntar sig en ordbok med en extra nyckel "type". Detta är den enda skillnaden du behöver komma ihåg när du översätter en konfiguration från det ena SDK:t till det andra.
En omfattande konfiguration
Sista steget, där alla sex parametrar kombineras i ett verkligt anrop till xAI SDK.
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="Intern verktygsplattform: dokumenthantering, supportärenden, kunskapsbas. Skrivskyddad åtkomst.",
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"],
)
Lägg märke till den interna konsekvensen i detta exempel. Beskrivningen aviserar skrivskyddad åtkomst, och de fem tillåtna verktygen är alla frågeoperationer – ingen motsägelse mellan vad modellen tror att den kan göra och vad konfigurationen tillåter. Headern X-Environment satt till production förhindrar att en testagent skriver till live-data, och X-Request-Source gör dina serverspår hanterbara om du behöver spåra var ett oväntat anrop originated.
Kontrollera innan driftsättning
Sex punkter förtjänar en granskning innan varje produktionsdriftsättning, och var och en motsvarar en fallgrop som vi stött på tidigare i denna kurs. URL:en måste vara HTTPS med ett giltigt certifikat, annars kommer inget att fungera. Etiketten måste vara kort, beskrivande och unik inom konfigurationen. Beskrivningen måste matcha de verktyg som faktiskt exponeras, annars kommer modellen att försöka göra anrop som är dömda att misslyckas. Tillåtna verktyg måste reduceras till strikt minimum. Token måste komma från en miljövariabel, inte från källkoden. Och ytterligare headers måste vara exakt vad din server förväntar sig, med korrekt skiftläge – ett skiftlägesfel på X-Organization-Id ger ett tyst misslyckande som är särskilt smärtsamt att felsöka.
Viktiga punkter
- Minimal konfiguration kräver endast
server_urlochserver_label - Lägg till
server_descriptionför att vägleda Grok, särskilt i miljöer med flera servrar - Begränsa med
allowed_tool_namesför säkerhet och prestanda - Använd
authorizationochheadersför autentisering - Båda SDK:erna (native xAI och OpenAI Responses) accepterar samma parametrar med olika syntax