Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Konfigurera en komplett MCP-server

Lektion 7 av 12 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Sätta ihop allt
  2. Det enklaste fallet
  3. En intern skrivskyddad server
  4. En omfattande konfiguration
  5. Kontrollera innan driftsättning
  6. Viktiga punkter

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.

ParameterObligatoriskRoll
server_urlJaHTTPS-URL till MCP-servern
server_labelJaPrefix för verktygsanrop
server_descriptionNejVägleder Grok vid val av server
allowed_tool_namesNejBegränsar tillgängliga verktyg
authorizationNejAutentiseringstoken
headersNejYtterligare 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_url och server_label
  • Lägg till server_description för att vägleda Grok, särskilt i miljöer med flera servrar
  • Begränsa med allowed_tool_names för säkerhet och prestanda
  • Använd authorization och headers för autentisering
  • Båda SDK:erna (native xAI och OpenAI Responses) accepterar samma parametrar med olika syntax