Konfigurācijas pabeigšana MCP serverim
Šajā lapā
Viss kopā
Tu esi iepazinies ar katru parametru atsevišķi. Šajā nodarbībā mēs tos apvienojam pilnīgās konfigurācijās, tieši tā, kā tu tās rakstīsi praksē, katru reizi parādot ekvivalentu abos galvenajos SDK. Mērķis nav ieviest jaunus konceptus, bet gan dot tev gatavus šablonus, kurus vari uzreiz pielāgot.
Lūk, pārskats par sešiem parametriem ar norādi, vai tie ir obligāti vai neobligāti.
| Parametrs | Obligāts | Loma |
|---|---|---|
server_url | Jā | MCP servera HTTPS URL |
server_label | Jā | Rīka izsaukuma prefikss |
server_description | Nē | Virza Grok servera izvēlē |
allowed_tool_names | Nē | Ierobežo pieejamos rīkus |
authorization | Nē | Autentifikācijas tokens |
headers | Nē | Papildu HTTP galvenes |
Vienkāršākais gadījums
Divi parametri ir pietiekami, ja serveris ir publisks un neprasa autentifikāciju.
# 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"
}]
Tieši tā tu rakstīsi konfigurāciju priekš DeepWiki. Grok tad iegūst piekļuvi visiem servera rīkiem, kas šeit ir pieņemami, jo tas ir publisks tikai lasāms serviss. Tiklīdz serveris pieder tavai organizācijai, šī konfigurācija kļūst nepietiekama.
Tikai lasāms iekšējais serveris
Pakāpsimies soli augstāk: uzņēmuma CRM, ko aģentam jāspēj vaicāt, bet nekādā gadījumā nedrīkst modificēt. Tiek pievienoti trīs parametri, katrs sava iemesla dēļ – apraksts virza modeli, tokens pierāda identitāti, bet atļauto saraksts aizliedz rakstīšanas operācijas.
# 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"]
}]
Salīdzini abus blokus: saturs ir identisks, mainās tikai ietvars. Palīgfunkcija mcp() pieņem nosauktos argumentus, savukārt OpenAI formāts sagaida vārdnīcu ar papildu atslēgu "type". Šī ir vienīgā atšķirība, kas jāatceras, pārvēršot konfigurāciju no viena SDK uz otru.
Visaptveroša konfigurācija
Noslēguma solis, kur visi seši parametri ir apvienoti reālā izsaukumā, izmantojot 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="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"],
)
Ievēro šī piemēra iekšējo konsekvenci. Apraksts paziņo par tikai lasāmu piekļuvi, un pieci atļautie rīki ir tikai vaicājumu operācijas – nav pretrunu starp to, ko, pēc modeļa domām, tas var darīt, un to, ko konfigurācija atļauj. Galvene X-Environment, kas iestatīta uz production, novērš testa aģenta rakstīšanu dzīvajos datos, bet X-Request-Source padarīs tava servera pēdas izsekojamas, ja tev būs jānoskaidro, no kurienes nācis negaidīts pieprasījums.
Pārbaude pirms izvietošanas
Pirms jebkuras izvietošanas ražošanas vidē ir vērts pārskatīt sešus punktus, un katrs no tiem atbilst kādai kļūdai, ar ko saskārāmies šī kursa gaitā. URL ir jābūt HTTPS ar derīgu sertifikātu, pretējā gadījumā nekas nestrādās. Etiķetei (label) jābūt īsai, aprakstošai un unikālai konfigurācijas ietvaros. Aprakstam ir jāatbilst faktiski eksponētajiem rīkiem, pretējā gadījumā models mēģinās veikt izsaukumus, kas lemti neveiksmei. Atļautajiem rīkiem ir jābūt samazinātiem līdz absolūti nepieciešamajam minimumam. Tokenam ir jānāk no vides mainīgā, nevis no koda. Un papildu galvenēm ir jābūt tieši tādām, kādas sagaida tavs serveris, ar pareizu lielo un mazo burtu lietojumu – kļūda lielo un mazo burtu lietojumā, piemēram, X-Organization-Id, radīs klusu kļūmi, kuru diagnosticēt ir īpaši sāpīgi.
Galvenās atziņas
- Minimālajai konfigurācijai pietiek tikai ar
server_urlunserver_label - Pievieno
server_description, lai virzītu Grok, it īpaši vairāku serveru vidē - Ierobežo ar
allowed_tool_namesdrošības un veiktspējas nolūkos - Izmanto
authorizationunheadersautentifikācijai - Abi SDK (natīvais xAI un OpenAI Responses) pieņem tos pašus parametrus, tikai ar atšķirīgu sintaksi