Freastalaí MCP

Soláthraíonn Nordlet an Model Context Protocol ag https://api.nordlet.com/mcp. Is féidir le cúntóir AI atá ceangailte leis an API a chuardach, scéimre iarratais aon oibríochta a léamh agus é a chur i gcrích, leis an eochair API céanna, an chuideachta chéanna agus na scóip chéanna agus a bhíonn in iarratas díreach. Is iarratas gnáth-API é gach glao uirlisí: déantar é a fhíordheimhítani, teorainn ráta a chur air agus méadrú a dhéanamh air mar aon iarratas eile, agus athraíonn glao athraitheach leabhair na cuideachta.

Ceangail

Labhraíonn an pointe críochach HTTP Sruthaithe (Streamable HTTP) agus déantar é a fhíordheimhítani leis an eochair API Bearer ó Ag tosú. In Claude Code:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

Glacann aon chliant MCP eile leis an URL agus an ceanntásc céanna. Ní féidir le eochair a bhfuil scóip *:read aici ach na hoibríochtaí léitheoireachta a chur i gcrích; tuairiscíonn na huirlisí scóip ar et díreach mar earráid 403 an API.

Uirlisí

Clúdaíonn trí uirlis gach oibríocht den API:

Uirlis	Cad a dhéanann sé
search_operations	Aimsíonn sé oibríochtaí de réir focal ina n-ainm, cosán, achomair nó cur síos, de rogha laistigh d'mhodúl amháin (sales, bank, reports, ...). Mura bhfuil aon cheist ann, liostaíonn sé na modúil.
describe_operation	Tugann sé ar ais an modh, an cosán, an cur síos agus scéimre iarratais JSON d'oibríocht amháin; cuireann includeResponse: true scéimre an fhreagra 200 leis.
call_operation	Ritheann sé oibríocht amháin le comhlacht JSON. Tagann corp an fhreagra ar ais mar JSON; tagann freagra 4xx nó 5xx ar ais mar earráid uirlisí leis an stádas agus an clúdach earráide. Seoltar idempotencyKey roghnach mar cheanntásc Idempotency-Key, ionas go n-athimrítear an chéad fhreagra ag glao athchleachtach leis an eochair chéanna seachas an éifeacht a athdhéanamh.

Is uirlisí díreacha iad na hoibríochtaí is mó a úsáidtear lena gcuid scéimrí iarratais féin freisin, ionas go bhfeiceann cúntóir a réimsí gan cuardach a dhéanamh: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary agus reports_debt_aging. Tá na nótaí míniúcháin MCP (readOnlyHint, destructiveHint) ag gach uirlis a chuireann in iúl don chliant an scríobhann sé.

Gintear an t-innéacs oibríochta agus na scéimrí ón tuairisc OpenAPI chéanna leis an tagairt API agus na SDKanna, ionas go n-eascraíonn oibríocht a chuirtear leis an API i search_operations leis an scaoileadh a chuireann leis é. Meabhraíonn treoracha an fhreastalaí na comhionannais don chúntóir: is teaghráin dheachúla iad méideanna, glacann liostaí le page, pageSize, sort agus filter, agus freagraíonn comhdú tíre le 422 do chuideachta taobh amuigh den tír sin.