MCP serveri täielik konfiguratsioon
Sellel lehel
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.
| Parameeter | Kohustuslik | Roll |
|---|---|---|
server_url | Jah | MCP serveri HTTPS URL |
server_label | Jah | Tööriista väljakutse eesliide |
server_description | Ei | Suunab Groki serveri valikul |
allowed_tool_names | Ei | Piirab ligipääsetavaid tööriistu |
authorization | Ei | Autentimistoken |
headers | Ei | Tä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_urljaserver_label - Lisa
server_description, et suunata Groki, eriti mitme serveriga seadistustes - Piira turvalisuse ja jõudluse huvides
allowed_tool_namesabil - Kasuta autentimiseks
authorizationjaheaders - Mõlemad SDK-d (natiivne xAI ja OpenAI Responses) aktsepteerivad samu parameetreid erineva süntaksiga