Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Konfigurācijas pabeigšana MCP serverim

Nodarbība 7 no 12 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Viss kopā
  2. Vienkāršākais gadījums
  3. Tikai lasāms iekšējais serveris
  4. Visaptveroša konfigurācija
  5. Pārbaude pirms izvietošanas
  6. Galvenās atziņas

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.

ParametrsObligātsLoma
server_urlJāMCP servera HTTPS URL
server_labelJāRīka izsaukuma prefikss
server_descriptionNēVirza Grok servera izvēlē
allowed_tool_namesNēIerobežo pieejamos rīkus
authorizationNēAutentifikācijas tokens
headersNē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_url un server_label
  • Pievieno server_description, lai virzītu Grok, it īpaši vairāku serveru vidē
  • Ierobežo ar allowed_tool_names drošības un veiktspējas nolūkos
  • Izmanto authorization un headers autentifikācijai
  • Abi SDK (natīvais xAI un OpenAI Responses) pieņem tos pašus parametrus, tikai ar atšķirīgu sintaksi