Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Fíordheimhniú agus ceanntásca

Ceacht 6 as 12 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Cruthaigh cé atá ag glaoch
  2. An paraiméadar authorization
  3. headers agus extra_headers
  4. Cumraíocht táirgeachta iomlán
  5. Príomhphointí

Cruthaigh cé atá ag glaoch

Glacann DeepWiki agus freastalaithe MCP poiblí eile le glaonna ó dhuine ar bith, rud atá comhoiriúnach lena gcuspóir. Ach luaithe is a nochtann tú do chuid uirlisí féin, athraíonn an scéal: gan fíordheimhniú, is féidir le duine ar bith a thuarann an URL do chuid CRM a cheistiú nó do phróisis a thosú. Soláthraíonn xAI dhá pharaiméadar chun é seo a réiteach—authorization don chomhartha rochtana, agus headers nó extra_headers do gach rud eile.

An paraiméadar authorization

Seolann sé comhartha fíordheimhnithe chuig an bhfreastalaí MCP. Go sonrach, cuirtear an teaghrán a sholáthraíonn tú isteach mar atá sé i gceanntásc HTTP Authorization gach iarratais a sheoltar chuig an bhfreastalaí sin.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-your-token-here"
)

Braitheann an fhormáid a bhfuiltear ag súil léi go hiomlán ar an bhfreastalaí sprioc, toisc go nglacann authorization le haon teaghrán: is é an freastalaí MCP a dhéanann bailíochtú air, ní xAI. Clúdaíonn trí fhoirm beagnach gach cás a thiocfaidh ort.

  • Comhartha Bearer: "Bearer sk-xxxx" — an ceann is coitianta, a úsáideann an chuid is mó de na APIanna REST
  • Eochair API: "ApiKey your-key" — úsáideann roinnt seirbhísí réimír saincheaptha
  • Fíordheimhniú bunúsach: "Basic base64(user:password)" — fíordheimhniú bunúsach códaithe i mbonn64

Ós rud é go dtéann an comhartha seo le gach iarratas, éilíonn a láimhseáil cúram. Ná déan é a chrua-chódú riamh i do fhoinse: críochnóidh rún atá scríofa i gcomhad leaganaithe i stór, i loga, nó i scáileangraf faoi dheireadh. Úsáid athróg timpeallachta i gcónaí. Má cheadaíonn an freastalaí é, roghnaigh comhartha scópaithe nach osclaíonn ach na huirlisí a theastaíonn uait go díreach—is é seo an leagan taobh an fhreastalaí den srian allowed_tool_names. Agus pleanáil rothlú rialta, go háirithe i dtáirgeadh, áit arb é comhartha síoraí comhartha a sceitfidh faoi dheireadh.

import os

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization=f"Bearer {os.getenv('MCP_SERVER_TOKEN')}"
)

headers agus extra_headers

Freagraíonn an comhartha ar an gceist “cé tú”. Teastaíonn freagraí breise ó go leor freastalaithe: cén eagraíocht, cén timpeallacht, cén leagan API. Téann an fhaisnéis seo tríd an bparaiméadar headers, nó extra_headers ag brath ar an SDK.

mcp(
    server_url="https://api.example.com/mcp",
    server_label="internal",
    authorization="Bearer sk-token",
    headers={
        "X-Organization-Id": "org-123",
        "X-Project-Id": "proj-456"
    }
)

Is é an cás is coitianta ná ardáin il-chíosaithe, áit a fhreastalaíonn an t-ionchur céanna ar chliaint iolracha agus a bhraitheann sé ar cheanntásc chun an t-iarratas a ródú chuig na sonraí cearta. Ina dhiaidh sin tá leaganú API, le ceanntásc cosúil le "X-API-Version": "2024-01" a ghlasálann leagan sonrach agus a chosnaíonn tú ar athruithe freastalaí. Bíonn meiteashonraí rianaithe ag teastáil ó roinnt córas freisin—ID seisiúin, ID gníomhaire—chun bunús na nglaonna a rianú, nó ceanntásca teorannaithe ráta a chinneann an plean billeála atá i bhfeidhm.

Athraíonn ainm an pharaiméadair ag brath ar an gcomhéadan a úsáideann tú. Úsáideann SDK dúchasach xAI headers sa chuid is mó de chásanna; d’fhéadfadh go n-éileodh an Responses API i bhformáid OpenAI extra_headers, chun aon imbhuailt le ceanntásca a bhainistíonn an SDK seo go huathoibríoch dó féin a sheachaint. Tá an t-iompar mar an gcéanna, áfach: cuirtear ceanntásca le gach iarratas chuig an bhfreastalaí MCP. Mura dtéann do chuid iarratas amach le do cheanntásca, seiceáil an t-ainm paraiméadair seo ar dtús sula bhféachann tú in áit eile.

Cumraíocht táirgeachta iomlán

Seo conas a chuirtear na paraiméadair seo le chéile leo siúd ó cheachtanna roimhe seo, i gcás réalaíoch freastalaí inmheánaigh.

from xai_sdk.tools import mcp
import os

tools = [
    mcp(
        server_url="https://api.monentreprise.com/mcp",
        server_label="internal",
        server_description="Internal tools: CRM, documentation, tickets",
        authorization=f"Bearer {os.getenv('INTERNAL_MCP_TOKEN')}",
        headers={
            "X-Organization-Id": os.getenv("ORG_ID"),
            "X-Environment": "production"
        },
        allowed_tool_names=["search_docs", "get_ticket", "search_contacts"]
    )
]

Nascann an chumraíocht seo leis an bhfreastalaí MCP inmheánach thar HTTPS, déanann sé fíordheimhniú le comhartha Bearer atá stóráilte in athróg timpeallachta, seolann sé ID na heagraíochta i gceanntásc, agus srianann sé rochtain ar thrí oibríocht léamh. Tabhair faoi deara go nglasálann gach líne gné eile: cosnaíonn criptiú an t-iompar, cruthaíonn an comhartha an t-aitheantas, sainíonn an ceanntásc scóip na sonraí, agus teorannaíonn an liosta ceadaithe an damáiste féideartha. Ní chuireann aon cheann de na sraitheanna seo na cinn eile in ionad.

Príomhphointí

  • Seolann authorization an comhartha rochtana chuig an bhfreastalaí MCP trí cheanntásc HTTP Authorization
  • Stóráil do chomharthaí i athróga timpeallachta i gcónaí, ná déan iad a chrua-chódú riamh sa chód
  • Cuireann headers / extra_headers ceanntásca HTTP breise le gach iarratas
  • Freastalaíonn ceanntásca ar aitheantas il-chíosaithe, leaganú API, agus rianú
  • Comhcheangail fíordheimhniú agus srianadh uirlisí don tslándáil is airde