MCP szerver

Csatlakoztassa a Claude Code-ot, a Claude Desktopot vagy bármilyen MCP-klienst a Nordlet API-hoz egyetlen API-kulccsal.

A Nordlet a Model Context Protocol szabványt a https://api.nordlet.com/mcp címen éri el. A rácsatlakozott mesterséges intelligencia asszisztens képes az API-ban keresni, leolvasni bármely művelet kéréssémáját (schema) és meghívni azt, ugyanazzal az API-kulccsal, céggel és jogosultságkörökkel (scope), mint egy közvetlen kérés esetén. Minden eszközhívás egy hagyományos API-kérés: ugyanúgy hitelesítve van, vonatkoznak rá a kérésszám-korlátok (rate limit), és mérésre kerül, a módosító hívások pedig ténylegesen megváltoztatják a cég könyvelését.

Csatlakozás

A végpont Streamable HTTP protokollt használ, a hitelesítés pedig a Kezdeti lépések útmutatóban szereplő Bearer API-kulccsal történik. Claude Code-ban:

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

Bármilyen más MCP-kliens ugyanezt az URL-t és fejlécet használja. Egy *:read körre korlátozott kulcs csak az olvasási műveleteket hívhatja meg; az eszközök a hiányzó jogosultságot az API 403-as hibájaként jelzik.

Eszközök

Három eszköz lefedi az API összes műveletét:

Eszköz	Mit csinál
`search_operations`	Műveleteket keres a nevükben, elérési útjában (path), összegzésében vagy leírásában szereplő szavak alapján, választhatóan egy adott modulon (`sales`, `bank`, `reports`, ...) belül. Lekérdezés nélkül listázza a modulokat.
`describe_operation`	Visszaadja egy művelet metódusát, elérési útját, leírását és JSON kéréssémáját; az `includeResponse: true` paraméter hozzáadja a `200`-as válasz sémáját is.
`call_operation`	Végrehajt egy műveletet egy JSON törzzsel. A válasz törzse JSON formátumban érkezik vissza; a `4xx` vagy `5xx` válasz eszközhibaként jelenik meg az állapottal és a hibaburkolóval együtt. Egy opcionális `idempotencyKey` megadása esetén a rendszer elküldi az `Idempotency-Key` fejlécet, így az azonos kulccsal megismételt hívás az első választ adja vissza a hatás megismétlése helyett.

A leggyakrabban használt műveletek saját kéréssémával rendelkező, közvetlen eszközökként is elérhetők, így az asszisztens keresgélés nélkül látja a mezőiket: 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 és reports_debt_aging. Minden eszköz tartalmazza azokat az MCP-annotációkat (readOnlyHint, destructiveHint), amelyek jelzik a kliensnek, ha az adott művelet írási művelet.

A műveletindex és a sémák ugyanabból az OpenAPI-leírásból generálódnak, mint az API-referencia és az SDK-k, így az API-hoz hozzáadott új művelet a kiadásával egy időben azonnal megjelenik a search_operations eredményei között. A szerver utasításai emlékeztetik az asszisztenst a konvenciókra: az összegek decimális karakterláncok (decimal string), a listázások a page, pageSize, sort és filter paramétereket használják, az adóbevallási funkciók pedig 422-es hibával válaszolnak, ha a cég nem az adott országban van bejegyezve.