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

Cumraíocht Iomlán Freastalaí MCP

Ceacht 7 as 12 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. An Pictiúr Iomlán a Chur Le Chéile
  2. An Cás is Simplí
  3. Freastalaí Inmheánach Léamh-Amháin
  4. Cumraíocht Chuimsitheach
  5. Seiceáil Sula nImíonn Tú i dTír
  6. Príomhphointí

An Pictiúr Iomlán a Chur Le Chéile

Tá gach paraiméadar feicthe agat ar leithligh. Sa cheacht seo, cuirimid le chéile iad i gcumraíochtaí iomlána, díreach mar a scríobhfaidh tú iad sa chleachtas, ag taispeáint an choibhéis i ngach ceann de na príomh-SDKanna gach uair. Ní hé an sprioc coincheapa nua a thabhairt isteach, ach patrúin a thabhairt duit is féidir leat a oiriúnú go díreach.

Seo achoimre ar an sé pharaiméadar, lena stádas éigeantach nó roghnach.

ParaiméadarÉigeantachRól
server_urlTáURL HTTPS an fhreastalaí MCP
server_labelTáRéimír glaonna uirlisí
server_descriptionNílTreoraíonn sé Grok i roghnú an fhreastalaí
allowed_tool_namesNílCuireann srian le huirlisí inrochtana
authorizationNílComhartha fíordheimhnithe
headersNílCeanntásc HTTP breise

An Cás is Simplí

Tá dhá pharaiméadar leordhóthanach nuair atá an freastalaí poiblí agus nach gceanglaíonn sé fíordheimhniú.

# 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"
}]

Is é seo go díreach a scríobhfaidh tú do DeepWiki. Beidh rochtain ag Grok ansin ar gach uirlis den fhreastalaí, rud atá inghlactha anseo ós rud é gur seirbhís phoiblí léamh-amháin í. Chomh luath agus a bhaineann an freastalaí le do chuid eagraíochta féin, éireoidh an chumraíocht seo neamhleor.

Freastalaí Inmheánach Léamh-Amháin

Déanaimis céim a ardú: CRM fiontair nach mór don ghníomhaire a bheith in ann ceist a chur air ach gan é a mhodhnú riamh. Cuirtear trí pharaiméadar leis, gach ceann acu ar chúis ar leith – treoraíonn an tuairisc an tsamhail, cruthaíonn an tsiombail féiniúlacht, agus toirmíonn an liosta bhán scríbhneoireacht.

# 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"]
}]

Déan comparáid idir an dá bhloc: tá an t-ábhar céanna iontu; níl ann ach go n-athraíonn an clúdach. Glacann an cabhlach mcp() le hargóintí ainmnithe; tá súil ag formáid OpenAI le foclóir a bhfuil eochair bhreise "type" ann. Is é seo an t-aon difríocht le cuimhneamh air agus cumraíocht á haistriú ón SDK amháin go dtí an ceann eile.

Cumraíocht Chuimsitheach

An chéim dheireanach, leis an sé pharaiméadar ar fad comhcheangailte i nglao fíorshaol chuig an 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"],
)

Tabhair faoi deara comhsheasmhacht inmheánach an tsampla seo. Fógraíonn an tuairisc rochtain léamh-amháin, agus is oibríochtaí ceiste iad na cúig uirlis cheadaithe go léir – gan aon chontrárthacht idir an méid a chreideann an tsamhail gur féidir léi a dhéanamh agus an méid a cheadaíonn an chumraíocht. Coscaíonn an ceanntasc X-Environment atá socraithe ar production gníomhaire tástála ó shonraí beo a scríobh, agus déanfaidh X-Request-Source do rianta freastalaí inbhéartaithe más gá duit a rianú cá as a tháinig iarratas gan choinne.

Seiceáil Sula nImíonn Tú i dTír

Tá sé phointe a d’fhéadfadh athbhreithniú a bheith orthu roimh aon imscaradh táirgeachta, agus freagraíonn gach ceann acu do phitfall a buaileadh tú leis níos luaithe sa chúrsa seo. Ní mór go mbeadh an URL HTTPS le teastas bailí, murach sin ní rachaidh aon rud tríd. Ní mór go mbeadh an lipéad gairid, cur síosach, agus uathúil laistigh den chumraíocht. Ní mór go mbeadh an tuairisc ag teacht leis na huirlisí a nochtar i ndáiríre, murach sin déanfaidh an tsamhail iarracht glaonna a dhéanfaidh teip orthu. Ní mór na huirlisí ceadaithe a laghdú go dtí an t-íosmhéid docht. Ní mór go dtagródh an chomhartha ó athróg timpeallachta, ní ón gcód foinse. Agus ní mór go mbeadh na ceanntáisc bhreise díreach mar a bhfuil súil ag do fhreastalaí leo, le cású ceart – cruthaíonn earráid cásaithe ar X-Organization-Id teip chiúil atá thar a bheith pianmhar le diagnóisiú.

Príomhphointí

  • Ní theastaíonn ach server_url agus server_label don chumraíocht íosta
  • Cuir server_description leis chun Grok a threorú, go háirithe i socruithe il-fhreastalaí
  • Cuir srian le allowed_tool_names le haghaidh slándála agus feidhmíochta
  • Úsáid authorization agus headers le haghaidh fíordheimhnithe
  • Glacann an dá SDK (xAI dúchasach agus Freagraí OpenAI) leis na paraiméadair chéanna le comhréir dhifriúil