Server MCP

Nordlet jipprovdi l-Model Context Protocol fuq https://api.nordlet.com/mcp. Assistent tal-intelliġenza artifiċjali konness miegħu jista' jtfittex fl-API, jaqra l-iskema tat-talba ta' kwalunkwe operazzjoni u jsejħilha, bl-istess chiave tal-API, kumpanija u scopes bħal talba diretta. Kull sejħa ta' għodda hija talba ordinarja tal-API: tkun awtentikata, soġġetta għal-limiti tar-rata (rate limited) u mkejla bħala tali, u sejħa li timmodifika d-data tibdel ir-reġistri tal-kumpanija.

Konnessjoni

L-endpoint juża Streamable HTTP u huwa awtentikat bil-Bearer API key minn Kif tibda. F'Claude Code:

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

Kwalunkwe klijent MCP ieħor juża l-istess URL u header. Chiave ristretta għal *:read tista' ssejħa biss l-operazzjonijiet ta' qari; l-għodod jirrapportaw scope nieqes bħala żball 403 tal-API.

Għodod (Tools)

Tliet għodod kopru kull operazzjoni tal-API:

Għodda	X'tagħmel
search_operations	Sib l-operazzjonijiet permezz ta' kliem f'isimhom, fil-path, fis-sommarju jew fid-deskrizzjoni, b'għażla f'modulu partikolari (sales, bank, reports, ...). Mingħajr query, telenka l-moduli.
describe_operation	Tirritorna l-metodu, il-path, id-deskrizzjoni u l-iskema tat-talba JSON ta' operazzjoni waħda; includeResponse: true iżżid l-iskema tar-rispons 200.
call_operation	Tħaddem operazzjoni waħda b'korp (body) JSON. Il-korp tar-rispons jiġi lura bħala JSON; tweġiba 4xx jew 5xx tiġi lura bħala żball tal-għodda bl-istatus u l-envelop tal-iżbalji. Parametru fakultattiv idempotencyKey jintbagħat bħala l-header Idempotency-Key, sabiex sejħa ripetuta bl-istess chiave tirrepeti l-ewwel tweġiba minflok ma terġa' twettaq l-effett.

L-operazzjonijiet l-aktar użati huma wkoll għodod diretti bl-iskemi tat-talba tagħhom stess, sabiex assistent jara l-kampijiet tagħhom mingħajr ma jkollu għalfejn ifittexhom: 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 u reports_debt_aging. Kull għodda ġġorr l-anotazzjonijiet MCP (readOnlyHint, destructiveHint) li jinfurmaw lill-klijent jekk hijiex tikteb data.

L-indiċi tal-operazzjonijiet u l-iskemi huma ġenerati mill-istess deskrizzjoni OpenAPI bħar-referenza tal-API u s-SDKs, għalhekk operazzjoni miżjuda mal-API tidher f'search_operations mar-rilaxx li jżidha. L-istruzzjonijiet tas-server ifakkru lill-assistent dwar il-konvenzjonijiet: l-ammonti huma string deċimali, il-listi jaċċettaw page, pageSize, sort u filter, u preżentazzjoni tat-taxxa għal pajjiż partikolari twieġeb bi 422 għal kumpanija li tinsab barra dak il-pajjiż.