Fíordheimhniú agus ceanntásca
Ar an leathanach seo
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
authorizationan 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_headersceanntá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