Lähe põhisisu juurde
Eesti— Vali keel
Menüü

MCP serveri täielik konfiguratsioon

Õppetund 7 / 12 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Kõige kokkuvõtmine
  2. Lihtsaim juhtum
  3. Ainult-lugemis sisemine server
  4. Põhjalik konfiguratsioon
  5. Kontrolli enne kasutuselevõttu
  6. Peamised punktid

Kõige kokkuvõtmine

Oled iga parameetriga eraldi tutvunud. Selles õppetükis ühendame need terviklikeks konfiguratsioonideks, täpselt nii, nagu sa neid praktikas kirjutad, näidates iga kord vasteid mõlemas peamises SDK-s. Eesmärk ei ole tutvustada uusi mõisteid, vaid anda sulle mustrid, mida saad otse kohandada.

Siin on ülevaade kuuest parameetrist koos nende kohustusliku või valikulise staatusega.

ParameeterKohustuslikRoll
server_urlJahMCP serveri HTTPS URL
server_labelJahTööriista väljakutse eesliide
server_descriptionEiSuunab Groki serveri valikul
allowed_tool_namesEiPiirab ligipääsetavaid tööriistu
authorizationEiAutentimistoken
headersEiTäiendavad HTTP päised

Lihtsaim juhtum

Kaks parameetrit piisavad, kui server on avalik ja ei nõua autentimist.

# 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"
}]

Just nii kirjutad sa DeepWiki jaoks. Grok saab seejärel juurdepääsu kõigile serveri tööriistadele, mis on siin vastuvõetav, kuna tegemist on avaliku ainult-lugemis teenusega. Niipea kui server kuulub sinu organisatsioonile, muutub see konfiguratsioon ebapiisavaks.

Ainult-lugemis sisemine server

Liigume sammuke edasi: ettevõtte CRM, mida agent peab saama pärida, kuid mitte kunagi muutma. Lisandub kolm parameetrit, igaüks erineval põhjusel – kirjeldus suunab mudelit, token tõendab identiteeti ja lubatud nimekiri keelab kirjutamise.

# xAI SDK
tools = [
    mcp(
        server_url="https://api.monentreprise.com/mcp",
        server_label="crm",
        server_description="Sisemine CRM. Ainult kontaktide ja ettevõtete otsing.",
        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": "Sisemine CRM. Ainult kontaktide ja ettevõtete otsing.",
    "authorization": f"Bearer {os.getenv('CRM_TOKEN')}",
    "allowed_tool_names": ["search_contacts", "get_contact", "list_companies"]
}]

Võrdle kahte plokki: sisu on identne; muutub ainult pakend. Abifunktsioon mcp() võtab nimelisi argumente; OpenAI vorming eeldab sõnastikku koos täiendava võtmega "type". See on ainus erinevus, mida tuleb meeles pidada ühe SDK konfiguratsiooni teise tõlkimisel.

Põhjalik konfiguratsioon

Viimane samm, kus kõik kuus parameetrit on kombineeritud reaalses väljakutses xAI SDK-le.

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="Sisemine tööriistade platvorm: dokumendihaldus, tugipiletid, teadmistebaas. Ainult-lugemis juurdepääs.",
            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"],
)

Pane tähele selle näite sisemist järjepidevust. Kirjeldus teatab ainult-lugemis juurdepääsust ja viis lubatud tööriista on kõik päringutoimingud – vastuolu puudub selle vahel, mida mudel arvab endale lubatud olevat, ja selle vahel, mida konfiguratsioon võimaldab. Päis X-Environment väärtusega production takistab testagendil elavatesse andmetesse kirjutamast ja X-Request-Source muudab sinu serveri jäljed teostatavaks, kui peaksid vajaduse korral tuvastama, kust ootamatu päring pärines.

Kontrolli enne kasutuselevõttu

Enne tootmisse viimist väärib kuus punkti ülevaatamist ja igaüks neist vastab lõksule, millega selles kursuses varem kokku puutusid. URL peab olema HTTPS kehtiva sertifikaadiga, vastasel juhul ei lähe midagi läbi. Silt peab jääma lühikeseks, kirjeldavaks ja konfiguratsioonis unikaalseks. Kirjeldus peab vastama tegelikult avaldatud tööriistadele, vastasel juhul püüab mudel sooritada väljakutseid, mis on määratud ebaõnnestuma. Lubatud tööriistad tuleb taandada rangele miinimumile. Token peab tulema keskkonnamuutujast, mitte lähtekoodist. Ja täiendavad päised peavad olema täpselt need, mida sinu server ootab, õige tähistusega – tähistuse viga X-Organization-Id puhul tekitab vaikiva tõrke, mida on eriti valus diagnoosida.

Peamised punktid

  • Minimaalne konfiguratsioon nõuab ainult server_url ja server_label
  • Lisa server_description, et suunata Groki, eriti mitme serveriga seadistustes
  • Piira turvalisuse ja jõudluse huvides allowed_tool_names abil
  • Kasuta autentimiseks authorization ja headers
  • Mõlemad SDK-d (natiivne xAI ja OpenAI Responses) aktsepteerivad samu parameetreid erineva süntaksiga