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

server_url agus server_label

Ceacht 4 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. An dá pharaiméadar nach féidir leat a sheachaint
  2. server_url: Seoladh beacht an chríochphointe
  3. server_label: Aitheantas an fhreastalaí sa chomhrá
  4. Cumraíocht íosta sa dá SDK
  5. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar leathanach Remote MCP Tools de chuid xAI: déanann server_label réimír ar ghlaonna uirlisí, ach ní shonraíonn an doiciméadú an formáid réimíre beacht; is gnás léitheoireachta é an nodaireacht label__tool a úsáidtear sa chúrsa seo—fíoraigh an fhormáid iarbhír i do fhreagairtí API. Foinse: Remote MCP Tools.

An dá pharaiméadar nach féidir leat a sheachaint

Braitheann gach nasc idir Grok agus freastalaí MCP cianda ar dhá pharaiméadar: server_url agus server_label. Níl siad idirbheartaithe—gan iad, diúltaíonn an API an t-iarratas sula ndéanann sé aon iarracht. Gach paraiméadar eile a thagann tú orthu ina dhiaidh sin, is mionchoigeartuithe ar an mbunús seo atá iontu; ní chuirtear in ionad an bhunúis iad riamh.

server_url
Cá bhfuil an freastalaí suite
server_label
Conas an freastalaí a aithint

server_url: Seoladh beacht an chríochphointe

Tá URL iomlán an fhreastalaí MCP ar cheangal Grok leis le fáil sa pharaiméadar server_url, agus leanann an URL rialacha docht.

Is é HTTPS an chéad riail. Ní mór don URL tosú le https://, agus diúltaíonn xAI aon nasc HTTP neamhchriptithe. Is simplí an fáth: iompraíonn malartuithe idir Grok agus an freastalaí MCP iarratais do chuid úsáideoirí, torthaí uirlisí, agus uaireanta an t-anntanas fíordheimhniúcháin féin. Bheadh sé doshannta ligean do na sonraí seo dul timpeall i ngnáth-théacs.

# Ceart
mcp(server_url="https://mcp.deepwiki.com/mcp")

# Diúltaithe ag an API
mcp(server_url="http://mcp.deepwiki.com/mcp")

Baineann an dara riail le cruinneas an chonair. Ní mór don URL pointeáil go díreach chuig críochphointe MCP, ní chuig fréamh an fhearainn. Nochtann beagnach gach freastalaí a chríochphointe ar chonair tiomnaithe, agus athraíonn an gnás ó cheann go ceann. Seo trí fhoirm bhailí a thiocfaidh tú orthu:

https://mcp.deepwiki.com/mcp
https://api.example.com/mcp
https://tools.monentreprise.com/v1/mcp

Eascraíonn an tríú riail as an dá cheann roimhe: tá localhost agus seoltaí IP príobháideacha eisiata. Ní mór teacht ar an bhfrestalaí ó bhonneagar xAI, ar fhearann poiblí, le teastas SSL bailí. Ardaíonn sé seo ceist phraiticiúil le linn forbartha, ós rud é go ritheann an freastalaí MCP atá tú a scríobh ar do mheaisín féin. Is é an réiteach gnáth ná tollán a úsáid—ngrok nó Cloudflare Tunnel, mar shampla—a nochtann do shampla áitiúil taobh thiar de URL HTTPS poiblí ar feadh do thástálacha.

server_label: Aitheantas an fhreastalaí sa chomhrá

Is aitheantóir gairid é an server_label a úsáideann Grok chun réimír a chur le glaonna uirlisí ón bhfrestalaí seo. Tá dhá ról aige: rianta a dhéanamh inléite, agus aon débhrí a bhaint nuair a bhíonn roinnt freastalaithe i láthair le chéile.

Deir doiciméadú xAI go gcuireann an lipéad réimír le glaonna uirlisí ón bhfrestalaí seo, gan an fhormáid réimíre beacht a shonrú. Sa chúrsa seo, déanaimid tagairt d’uirlis search_docs ón bhfrestalaí deepwiki mar deepwiki__search_docs, ar mhaithe le hinléiteacht: fíoraigh an fhormáid iarbhír i bhfreagairtí API sula dtógann tú loighic air.

mcp(
    server_url="https://mcp.deepwiki.com/mcp",
    server_label="deepwiki"
)
# Cuirfear réimír "deepwiki" le glaonna uirlisí ón bhfrestalaí seo

Treoraíonn trí chritéar roghnú lipéid mhaith. Ní mór dó a bheith gairid, ós rud é go gcuireann sé le hainm gach glao agus chuirfeadh lipéad fada logaíochtaí do chuid i mbarrachas gan ghá. Ní mór dó a bheith cur síosach, ionas go mbeidh foinse glao inléite ar an gcéad amharc gan an chumraíocht a sheiceáil. Ní mór dó a bheith uathúil i do chumraíocht, murach sin ní bheidh tú in ann idirdhealú a dhéanamh idir dhá fhreastalaí. Comhlíonann na samplaí thíos na trí riachtanas seo:

server_label="deepwiki"     # Doiciméadú GitHub
server_label="crm"          # Córas bainistíochta custaiméirí
server_label="jira"         # Rianú ticéad
server_label="search"       # Inneall cuardaigh inmheánach

Éiríonn sé seo i bhfad níos inbhraite a luaithe a nascann tú roinnt freastalaithe leis an seisiún céanna. Abair go nochtann do dhoiciméadú inmheánach agus DeepWiki araon uirlis darbh ainm search. Gan lipéid ar leith, buailfidh ainmneacha na n-uirlisí le chéile agus ní bheidh aon bhealach ag Grok a fháil amach cé acu ceann a dhírú air. Le lipéid, cuirtear réimír difriúil leis an dá uirlis—nodaithe anseo mar deepwiki__search agus internal-docs__search—agus imíonn an mhearbhall. Déanfaidh tú athbhreithniú ar an bpointe seo sa cheacht atá tiomnaithe do il-fhreastalaithe.

Cumraíocht íosta sa dá SDK

Le chéile, tá an dá pharaiméadar seo leordhóthanach chun freastalaí MCP poiblí a oibriú. Le SDK dúchasach xAI:

from xai_sdk.tools import mcp

tools = [
    mcp(
        server_url="https://mcp.deepwiki.com/mcp",
        server_label="deepwiki"
    )
]

Agus an comhionannas beacht leis an API Freagairtí i bhformáid OpenAI:

tools = [{
    "type": "mcp",
    "server_url": "https://mcp.deepwiki.com/mcp",
    "server_label": "deepwiki",
}]

Príomhphointí

  • Is iad server_url agus server_label an t-aon dá pharaiméadar atá éigeantach
  • Ní mór don URL a bheith HTTPS le teastas SSL bailí, gan localhost
  • Cuirtear réimír le gach glao uirlisí ón bhfrestalaí seo leis an lipéad (níl an fhormáid beacht doiciméadaithe; tugtar label__tool air sa chúrsa seo)
  • Roghnaigh lipéid atá gairid, cur síosach, agus uathúil in aghaidh an fhreastalaí
  • Tá an lipéad riachtanach d’il-fhreastalaithe chun coinbhleachtaí ainmneacha a sheachaint