MCP agus uirlisí ceangailte

Ceangail Nessie le freastalaithe MCP, agus péireáil gníomhaire seachtrach ionas go bhféadfaidh sé oibriú i Nessie mar thusa.

Cad is MCP ann

Is coinbhinsiún beag, oscailte é an Model Context Protocol chun uirlisí a chur síos do shamhail teanga agus chun glaoch orthu. Fógraíonn freastalaí cad is féidir leis a dhéanamh — liosta ainmnithe uirlisí, gach ceann acu le scéim JSON dá argóintí — agus aimsíonn cliant an liosta sin agus glaonn sé ar na huirlisí thar ceann na samhla. Tá sé simplí d’aon ghnó: is é an luach atá ann ná go n-oibríonn comhtháthú amháin, scríofa aon uair amháin, le gach samhail agus gach táirge a labhraíonn é.

Tá Nessie ar an dá thaobh de

Tá sé tábhachtach a bheith cruinn faoi seo, mar go bhfuil an dá leath éasca a mheascadh lena chéile, agus tá siad ar chonairí atá deartha difriúil d’aon ghnó.

• Amach. Is cliant MCP é Nessie. Nasctar freastalaithe a reáchtálann duine eile, agus éiríonn na huirlisí a nochtann siad ina n-uirlisí is féidir le gníomhairí iad a úsáid. Is é /api/mcp/* an dromchla bainistíochta.
• Isteach. Is freastalaí MCP é Nessie freisin. Is féidir le gníomhaire a rith in áit eile — Claude Code nó Codex ar ríomhaire forbróra — glaoch isteach ar chláir agus doiciméid. Is é POST /mcp an críochphointe sin, lasmuigh de /api d’aon ghnó, ionas nach mbeidh an dá bhrí chontrártha ina gcuid den chonair chéanna.

Freastalaí MCP a nascadh le Nessie

Iontrálacha catalóige agus cásanna

Tá dhá rud ann, agus tá an difríocht tábhachtach:

• Is iontráil catalóige sainmhíniú freastalaí — a ainm, a iompar, agus conas a fhíordheimhníonn sé. Scríobhtar uair amháin é, agus is féidir é a roinnt.
• Is cás an iontráil sin suiteáilte ag scóip amháin, leis na dintiúir a bhaineann amach é. Tugann an iontráil chéanna suiteáilte do dhá fhoireann dhifriúla dhá chás.

Ní bhíonn formhór na ndaoine ag baint le ceachtar acu go díreach. Is é an doras isteach sa riarthóir an siopa aipeanna ag /admin/apps: brabhsálann sé an catalóg chéanna gan na sonraí nasctha a thaispeáint, agus cruthaíonn Connect ar liosta cás. Oibreoirí a theastaíonn na réada amha uathu, úsáideann siad /api/mcp/catalog agus /api/mcp/instances.

Mura bhfuil freastalaí sa chatalóg fós, léann POST /api/mcp/discover URL agus tugann sé ar ais an méid a deir an freastalaí faoi féin, agus tarraingíonn POST /api/mcp/library/import iontráil ó leabharlann phoiblí na bhfreastalaithe. Is féidir nasc an chéad uair a chruthú go díreach ó URL freisin, le POST /api/apps/custom.

Iompair

Nascann Nessie le freastalaithe cianda thar HTTP. Oibríonn dhá iompar: HTTP inshruthaithe (iompar MCP reatha) agus an t-iompar HTTP+SSE níos sine. Roghnaítear http mura dtairgeann an freastalaí sse amháin.

Diúltaítear don iompar stdio d’iontrálacha a scríobhtar. Ciallaíonn stdio go bhfuil freastalaí MCP ina phróiseas áitiúil a thosaíonn an t-óstach, agus níl sé indéanta do dhuine ar bith athbhreithniú ciallmhar a dhéanamh ar chláir treallacha a reáchtáil laistigh de fhreastalaí Nessie. Baintear freastalaithe a fhoilsítear mar phacáiste le rith go háitiúil as iompórtálacha leabharlainne ar an gcúis chéanna. Tá luach ws sa réimse protocail, ach níl sé curtha i bhfeidhm: teipeann nasc a úsáideann é nuair a dhéanann Nessie iarracht é a oscailt.

Conas a fhíordheimhníonn Nessie leis an bhfreastalaí

Dearbhaíonn iontráil catalóige ceann de chúig mhodh: none, api_key, bearer, basic nó oauth2.

Is api_key instealladh ceanntáisc, agus luann an iontráil cén ceanntásc agus cén réimír — mar sin is é an modh céanna iad Authorization: Bearer …, X-API-Key: … agus X-Auth-Token: Token …, ach iad a chumrú ar bhealaí éagsúla. Greamaítear an eochair uair amháin le POST /api/mcp/instances/:instanceId/secret agus ní féidir í a léamh arís; ní iompraíonn freagra ar bith ó na bealaí cásanna tagairt do dhintiúr rúnda ar bith.

Tá dhá chruth ar oauth2. Tá críochphointí seasta ag freastalaí ina iontráil catalóige. Ní gá aon ní a chumrú do fhreastalaí a fhoilsíonn meiteashonraí caighdeánacha: léann Nessie na doiciméid acmhainne cosanta agus údaraithe, agus cruthaíonn sé cliant dó féin trí chlárú cliant dinimiciúil nó trí dhoiciméad meiteashonraí aitheantais chliant a fhoilsíonn sé ar a chosán well-known féin. Is é an lámhshéanadh POST /api/mcp/instances/:instanceId/oauth/start, agus ansin atreorú an sholáthraí ar ais chuig GET /api/mcp/oauth/callback. Tá an comhartha stáit in aon-úsáid, stóráilte sa bhunachar sonraí agus bailí ar feadh deich nóiméad, agus úsáidtear PKCE i gcónaí.

Tá riail amháin ann a chuireann iontas ar dhaoine: ní féidir le húinéir eagraíochta fiú dintiúr pearsanta nó OAuth a cheangal le duine eile. Is féidir dintiúr roinnte ach d’iontráil eochair API a dearbhaíodh mar cheann bailí; diúltaítear d’aon rud eile. Fanann dintiúr a bhaineann le duine ina dhintiúr a bhaineann leis an duine sin.

Cá bhfuil na dintiúir stóráilte

Stóráiltear rúnda cliant agus beartáin chomharthaí OAuth i mbunachar sonraí Postgres an imscartha féin, i gclúdaigh AES-256-GCM faoi chuspóir, faoi fháinne eochracha criptithe an imscartha a bhfuil a leagan neamhspleách aige, agus ní thagraítear dóibh ach trí thagairtí doiciméadaithe secret_*. Níl siad ar chor ar bith sa stóras rúnda seachtrach a choinníonn rúin Nessie eile. Diúltaíonn imscaradh táirgthe nach bhfuil an stóras criptithe cumraithe aige tosú, seachas lámhshéanadh OAuth a chríochnú a gcaillfí a thoradh ina dhiaidh sin.

Cá sroicheann nasc

Suiteáiltear cás ag ceann de sé raon: system, organization, project, team, channel nó user. Is uasteorainn chrua é an raon sin maidir leis na ritheanna is féidir leo é a úsáid, agus ní féidir le deontais ach é a chúngú, ní a leathnú riamh — mar sin ní féidir le comhtháthú a shuiteáiltear le cuntas duine dul ina chomhtháthú ar fud na heagraíochta ar bhealach ciúin.

Maidir le cé a fhéadfaidh suiteáil agus cá, leanann sé an cruth céanna: bainistíonn úinéirí agus riarthóirí eagraíochta suiteálacha ag aon raon; suiteálann gach duine eile nascóirí ar a raon user féin, agus is féidir leo na suiteálacha roinnte a bhfuil rochtain acu orthu a fheiceáil.

Uirlis a thabhairt do ghníomhaire

Ní thugann nascadh freastalaí a uirlisí do dhuine ar bith. Nuair a shuiteáiltear cás, déanann Nessie scrúdú ar an bhfreastalaí agus tionscnaíonn sé gach uirlis a fhógraíonn sé isteach sa chlár uirlisí — an rud a thaispeánann an riarthóir ag /admin/advanced/tools. Liosta amháin is ea é do na huirlisí tógtha isteach, uirlisí MCP, uirlisí bundle agus uirlisí executor, gach ceann acu lena fhoinse agus a stádas.

Tá ceann de thrí stádas ag uirlis thionscanta: active, pending_review nó disabled. Tagann uirlisí ó shuiteáil roinnte-raon mar pending_review agus ní mór iad a cheadú ar an leathanach sin sula bhfeiceann gníomhaire iad; tá uirlisí ó shuiteáil user-raon gníomhach láithreach, mar is é an duine a shuiteáil iad an t-aon duine nochtaithe. Is athbhreithniú leanúnach é an t-athbhreithniú, ní searmanas aonuaire: má aimsíonn scrúdú níos déanaí go bhfuil tuairisc nó scéim uirlise imithe ar seachrán, filleann an uirlis ar pending_review, agus stopann sí á tairiscint go mbreathnaítear ar an athrú.

Tá dhá bhealach ann chun a chinneadh cé na gníomhairí ar féidir leo uirlis ghníomhach a ghlaoch:

• Éilíonn nasc a cruthaíodh tríd an siopa aipeanna deontas sainráite. Faigheann gníomhaire an uirlis ach amháin nuair a ainmníonn deontas í, agus seiceáiltear an deontas i gcoinne mhéarlorg reatha na huirlise, mar sin teastaíonn cinneadh nua nuair a athraítear uirlis.
• Seachas sin, tá an uirlis ar siúl de réir réamhshocraithe do ghníomhaithe atá laistigh de raon a scóipe, agus cuirtear gníomhairí aonair as feidhm ar phainéal mionsonraí na huirlise.

Ainmníonn deontas príomhoide amháin — ról nó gníomhaire, ní an dá cheann — agus bíonn an diúltú níos láidre ná an ceadú. I gcás nasc user-raon ní thagann an cheist aníos ar chor ar bith: is féidir le haon ghníomhaire a labhraíonn an duine sin leis an uirlis a úsáid, agus ní choinníonn siar í ach lasc sainráite as.

Rud atá éasca a lorg san áit mhícheart: is é /settings/accounts sa riarthóir na cuntais nasctha — Slack, boscaí ríomhphoist, síntiúis mhúnla agus naisc OAuth le Linear, Jira, GitHub agus Trello a thacaíonn le boird sheachtracha. Tá nascóirí MCP ag /admin/apps, agus tá na huirlisí a tháirgeann siad ag /admin/advanced/tools.

Geataí ceadaithe ar ghlaonna uirlisí

Stopann glaonna uirlisí áirithe agus fanann siad ar dhuine. Nuair a tharlaíonn sé sin, ní theipeann ar an rith: reoitear an glao — ainm na huirlise, hais de na hargóintí agus go leor stáit chun atosú — agus tagann iarratas ceadaithe chun cinn in /api/approvals le go bhfreagróidh duine éigin air. Tá atosú idempotent, mar sin ní féidir glao dúbailte ceadaithe a rith faoi dhó. Feiceann an duine a dhéanann an cinneadh achoimre theorannaithe ar an méid a iarrtar; fanann na hargóintí beachta agus an rith bunaidh ar an bhfreastalaí.

Tá dhá gheata ar leith ann, agus cumraítear ar bhealaí éagsúla iad.

• Geataí struchtúrtha is airí d’uirlisí áirithe tógtha isteach iad agus ní féidir iad a chumrú. Tá na nithe seo go léir geataithe ar an mbealach seo: ríomhphost a sheoladh ó bhosca ríomhphoist gníomhaire nó ó chuntas nasctha, dréacht Gmail a sheoladh, bosca ríomhphoist a dhícheangal, imeacht féilire a chruthú, a athrú nó a chur ar ceal, agus gníomh brabhsálaí a scríobhfadh chuig suíomh nach bhfuil an brabhsálaí logáilte isteach ann. Tugtar fuinneog 24 uair an chloig dóibh chun freagra a fháil, seachas an 30 nóiméad gnáthach.
• Geataí polasaí tagann siad ó rialacha polasaí ar an bpéire tool/invoke. Is féidir le riail a cheadaíonn glao requiresApproval a iompar, agus gan ceadú fíoraithe, tugann an meastóireacht APPROVAL_REQUIRED seachas rith. Meastar rialacha diúltaithe ar dtús, agus iad ordaithe de réir raoin.

Níl sé deimhnithe againn cén scáileán riarthóra a scríobhann riail polasaí requiresApproval d’uirlis. Tá an tsamhail sonraí agus an fhorfheidhmiú ar fad ann, ach ní bhfuarthas an scáileán a scríobhann a leithéid de riail.

Gníomhaire seachtrach a nascadh le Nessie

An taobh eile. Ritheann Nessie freastalaí MCP dá chuid féin ag POST /mcp, thar HTTP inshruthaithe, agus tá sé gan stát: iompraíonn gach glao a dhintiúr féin agus réitíonn sé a ghníomhaí féin, mar sin níl aon seisiún ann chun cliant a cheangal le macasamhail amháin. Is féidir le ChatGPT, Claude, Claude Code, Codex nó gníomhaire ar ríomhaire glúine duine éigin oibriú ar chláir, ar dhoiciméid agus ar chustaiméirí laistigh den uirlis ar bith atá ag an duine sin cheana. Tá an treoir céim ar chéim do gach aip le Ceangail ChatGPT, Claude agus aipeanna intleachta shaorga eile.

Cad is dintiúr péireáilte ann i ndáiríre

Is é seo an chuid is tábhachtaí a fháil ceart, mar go bhfuil an tuairim intinne is dóichí — eochair API le ceadanna ceangailte léi — mícheart.

Ní aitheantas é dintiúr péireáilte riamh. Ainmníonn sé duine, agus ritheann gach glao uirlise mar an duine sin, agus glaonn sé ar na feidhmeanna seirbhíse céanna a nglaonann na bealaí HTTP orthu. Mar sin ní féidir le gníomhaire rochtain a fháil ar aon rud nach bhféadfadh an duine a thug ar iasacht é rochtain a fháil air trí chliceáil. Ní chúngaíonn scóipeanna ach an rochtain sin; níl aon scóip ann a leathnaíonn í.

Léitear an bhfuil an dintiúr fós beo ar gach glao aonair, ní iontaoitear é ón gcomhartha: cúlghairm, dul in éag, leagan comhartha an úsáideora, ballraíocht na heagraíochta agus ról reatha. Ní théann ísliú céime, díghníomhachtú nó “sign me out everywhere” i bhfeidhm ach ar an gcéad ghlao eile den ghníomhaire, seachas ag dul in éag an dintiúir.

Is comhartha neamh-inléite é, a réimíríonn nag1_, agus stóráiltear é mar hais SHA-256 amháin, agus maireann sé 90 lá. Diúltaítear dó le 403 ar leith ar aon chonair seachas an deireadh pointe MCP, agus ní toradh páirtiúil é ar a bhfuil le hathdhéanamh é a thaispeáint in áit eile. Coinníonn sin ar “thug mé mo chláir ar iasacht do ghníomhaire” a bheith ar “thug mé mo chuntas ar iasacht”.

Dhá bhealach chun nascadh

Úsáideann aip ar féidir léi brabhsálaí a oscailt — ChatGPT, Claude, Claude Code, Codex — profail údaraithe MCP: OAuth 2.1 le PKCE (S256), clárú cliant dinimiciúil ag POST /mcp/oauth/register, athnuachan comharthaí agus tagairtí acmhainne. Seolann an aip an duine chuig /settings/security, roghnaíonn an duine cad is féidir leis an aip a dhéanamh agus cé de na foirne a bhaineann sé amach, agus filleann an brabhsálaí ar an aip le cód. Maireann a chomhartha rochtana uair an chloig agus athnuaitear é; maireann an nasc 90 lá.

Ní rialaíonn gníomhaire líne ordaithe brabhsálaí agus ní féidir leis URL glaonna siar a óstáil, mar sin péireálann sé leis an ngrant údaraithe gléis (RFC 8628) ina ionad.

1. Glaonn an gníomhaire POST /mcp/auth/device le clientName agus na scopes a theastaíonn uaidh. Faigheann sé ar ais device_code, cód gearr user_code, verification_uri agus verification_uri_complete leis an gcód cheana sa cheist, chomh maith le interval na vótála agus expires_in. Priontálann sé an URI.
2. Osclaíonn duine an URI sin agus é logáilte isteach ag /settings/security. Feiceann siad cén gníomhaire a iarrann, cé an cuntas a oibreodh sé faoi, go dtí cathain, agus go díreach cad is féidir leis a dhéanamh — agus roghnaíonn siad Ceadaigh nó Ná ceadaigh.
3. Vótálann an gníomhaire POST /mcp/auth/token leis an deviceCode, ag urramú authorization_pending, slow_down, expired_token agus access_denied. Ar rath faigheann sé { access_token, token_type, scope, expires_at }.

Tá céim dhaonna ann ar aon nós, mar tagann an dintiúr le cearta duine, agus ní mór do dhuine roghnú iad a thabhairt ar iasacht. Ní chruthaíonn aon rud anseo rochtain as ar bith. Is féidir nascadh a chasadh as d’eagraíocht iomlán ag /admin/security?tab=programs, agus seiceáiltear an freagra sin nuair a cheadaíonn duine nasc, ní nuair a thosaíonn gníomhaire ceann.

Aimsiú

Freagraíonn POST /mcp gan fíordheimhniú le 401 agus ceanntásc WWW-Authenticate a ghlaonn ar /.well-known/oauth-protected-resource (RFC 9728), a ainmníonn an bunús seo mar an fhreastalaí údaraithe; ainmníonn a mheiteashonraí ag /.well-known/oauth-authorization-server (RFC 8414) na críochphointí clárúcháin, údaraithe, comhartha agus cúlghairme. Is é sin uile a theastaíonn ó chliant nuair a bhíonn an seoladh aige. Chun seoladh a aimsiú ó fhearann, léitear /.well-known/ai-catalog.json, a ainmníonn Cárta an Fhreastalaí ag /mcp/server-card (MCP Server Cards, SEP-2127). Tá críochphointí an deonaithe gléis liostaithe sa doiciméad acmhainne cosanta faoi x-nessie-device-authorization.

Is féidir le imscaradh seoladh eile níos giorra a fhreagairt freisin: seachfhreastalaítear https://nessie.works/mcp de Nessie Cloud chuig an API, agus tugtar an seoladh sin ar ais mar an acmhainn do chliant a tháinig isteach ar an mbealach sin, cé go bhfanann an logáil isteach ag an API. Ní leor atreorú, mar diúltaíonn cliant do mheiteashonraí a ainmníonn seoladh ar bith ach an ceann a tugadh dó. Liostáiltear na bunúis seo ag an oibreoir i NESSIE_MCP_ALIAS_ORIGINS.

Raonta agus uirlisí

Tá raonta comhdhlúite d’aon ghnó — ní socraíonn duine ar bith raon ar bith nach féidir le duine a mhíniú. Chun nasc a liostú a bhaineann le níos mó ná foireann amháin, úsáidtear nessie_team_list, agus ansin ainmníonn gach uirlis eile a teamId.

Freagraíonn glao gan an raon a theastaíonn uaidh mar thoradh uirlise a ainmníonn an raon le hiarraidh, seachas earráid iompair, ionas gur féidir leis an tsamhail rud úsáideach a thuairisciú in ionad athdhéanamh gan toradh.

Ní teaghlach uirlisí ar leith é do rianaitheoirí seachtracha: is clár é clár cibé an dtagann a thascanna ó Nessie nó a macasamhlaítear ó Linear, Jira, GitHub nó Trello, agus mar sin clúdaíonn tacar amháin uirlisí an dá cheann, agus deir gach tasc cé acu é. Is é an difríocht ná an scríobh: diúltaíonn clár a macasamhlaítear ó fhoinse inléite amháin scríbh, agus insíonn sé sa ghníomhaire i bhfocail gurb é an córas eile is úinéir don ticéad, agus nach mbeidh athdhéanamh ag cabhrú.

Is ceadú é foilsiú doiciméid, riamh ní raon

Dréachtaíonn gníomhairí; foilsíonn duine. Cuirtear an riail sin i bhfeidhm do ghníomhaithe Nessie féin trí ghníomhaire a dhiúltú ar fad — ach feidhmíonn dintiúr péireáilte mar dhuine, agus mar sin ní féidir leis an diúltú sin é a ghabháil. Caithfidh an geata a bheith in áit eile.

Mar sin ní fhoilsíonn nessie_doc_publish. Osclaíonn sé iarratas ceadaithe knowledge.page.publish — an ceann céanna a osclaíonn gníomhaire Nessie — agus tugann sé ar ais { status: "awaiting_approval", approvalId }. Nuair a vótálann duine arís, tugtar an t-iarratas céanna ar ais, seachas iarratas nua a oscailt. Déantar an cinneadh mar a dhéantar gach cinneadh foilsithe eile in Nessie: ag duine, faoin doiciméad sin, ag an nóiméad a bhfuil sé ann.

Níl raon foilsithe ann d’aon ghnó. Bhí ceann ann — tic ag am an phéireálaithe a deir go bhféadfaidh an gníomhaire seo foilsiú — ach baineadh é. Chinn sé uair amháin, ar feadh nócha lá, ceist a fhiafraíonn an táirge in aghaidh gach doiciméid, agus chinn sé sula raibh an doiciméad ann, mar sin ní raibh an duine a chuir an tic ar an eolas faoin méid a bhí sé ag aontú a fhoilsiú. Teastaíonn documents_write ó nessie_doc_publish, mar ní saor in aisce iarraidh a dhéanamh — léann sé an leathanach agus cuireann sé cinneadh os comhair duine — ach ní dheonaíonn an raon sin aon rud maidir le foilsiú.

Taifeadtar dhá aitheantas ar an iarraidh, agus tá an difríocht ríthábhachtach. Is é an iarrthóir an dintiúr, riamh ní an duine a ngníomhaíonn sé mar. Is é an ceadaitheoir riachtanach an duine sin, agus ní féidir ach leo freagra a thabhairt. Dá ainmneofaí an duine mar iarrthóir ar an iarraidh, dhícháileodh an riail a chuireann cosc ar dhuine a iarraidh féin a cheadú an t-aon duine a bhfuil sé de cheart aige cinneadh a dhéanamh.

Na rudaí péireáilte a fheiceáil agus a chúlghairm

Liostaítear gníomhairí péireáilte duine ag /settings/security, le lipéad agus rialú cúlghairme do gach ceann acu. Feiceann úinéir nó riarthóir eagraíochta gach dintiúr san eagraíocht ag /admin/security?tab=programs — cad a thugtar ar gach ceann, cad is féidir leis a dhéanamh, an bhfuil sé beo, agus cé an cuntas a fhaigheann ar iasacht é — agus is féidir leo aon cheann acu a chúlghairm. Fanann an liosta pearsanta féin-amháin, mar is liosta de bhealaí isteach é liosta de dhintiúir bheo, ní léamh ginearálta.

Scríobhtar athruithe a dhéantar trí dhintiúr chuig an duine a thugann ar iasacht é, agus iompraíonn siad aitheantas an dintiúir sa mheiteashonraí iniúchta, ionas gur féidir leis an log idirdhealú a dhéanamh idir eagarthóireacht phearsanta duine agus ceann a rinne a ghníomhaire dó.

Cad nach bhfuil ar fáil fós

Soiléir d’aon ghnó, mar go bhfuil an bhearna idir cumais prótacail agus cumais freastalaí áirithe, agus is ann a bhíonn doiciméadú mí-cheart de ghnáth:

• Ní nochtar comhrá, cainéil, ritheanna ná bainistíocht gníomhairí thar MCP.
• Ullmhaíonn clár nuachtlitir agus seolann duine é: ní sheolann, ní sceidealaíonn agus ní scriosann aon rud feachtas, agus scríobhtar an ríomhphost féin sa dearthóir.
• Teagmhálacha a nascadh agus a chumasc, athruithe ar scéimeanna CRM, iompórtálacha agus socrú cainéal fanann siad le duine sa bhrabhsálaí.
• Is socrú eagraíochta é an lasc nascaidh. Ní féidir le foireann ná le duine socruithe ar leibhéal foirne nó ar leibhéal pearsanta a shárú faoi láthair.