Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Visiška MCP serverio konfigūracija

Paskaita 7 iš 12 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Viskas kartu
  2. Paprasčiausias atvejis
  3. Tik skaitymui skirtas vidinis serveris
  4. Išsami konfigūracija
  5. Patikrink prieš diegdamas
  6. Svarbiausi punktai

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.

ParametrasPrivalomasVaidmuo
server_urlTaipMCP serverio HTTPS URL
server_labelTaipĮrankio iškvietimo priešdėlis
server_descriptionNePadeda „Grok“ pasirinkti serverį
allowed_tool_namesNeApriboja pasiekiamus įrankius
authorizationNeAutentifikavimo žetonas
headersNePapildomos 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_url ir server_label
  • Pridėk server_description, kad nukreiptum „Grok“, ypač naudojant kelis serverius
  • Saugumui ir našumui apribok naudodamas allowed_tool_names
  • Autentifikavimui naudok authorization ir headers
  • Abu SDK (natūralus „xAI“ ir „OpenAI Responses“) priima tuos pačius parametrus, tik skirtinga sintakse