API ir MCP

MCP serveris

MCP yra protokolas, kuriuo dirbtinio intelekto klientas prisijungia prie išorinės sistemos. Praktiškai tai reiškia, kad savo Balanso įmonę galite prijungti prie Claude ir dirbti su ja iš ten.

Įrankių yra 58, ir tai apgalvotas skaičius. Kurį laiką jų buvo 127, po vieną kiekvienam ekrano mygtukui, ir tai pasirodė klaida: kiekviena sesija prarasdavo apie dvidešimt tūkstančių žetonų vien įrankių aprašams, o modeliui tekdavo rinktis tarp kelių beveik vienodų.

Dabar forma kitokia. Paieška grąžina sąrašą, o gavusi identifikatorių vieną įrašą. Išsaugojimas kuria, kai identifikatoriaus nėra, ir atnaujina, kai jis yra. Būsenos keitimas surenka visus vieno įrašo perėjimus. Atskirą įrankį turi tik tai, kas neatšaukiama, kad klientas pamatytų įspėjimą.

Aprėptis yra visa: dokumento įkėlimas ir atpažinimas, pirkimo patvirtinimas, sąskaitos kūrimas ir išrašymas, banko sudengimas, ataskaitos, PVM deklaracija, komandiruotės, laikotarpių uždarymas, įmonės nustatymai.

Ko ten sąmoningai nėra: API raktų kūrimo ir jų peržiūros. Modelis neturi gaminti ar rodyti prisijungimo duomenų.

REST API

API gyvena atskirame adrese ir turi dokumentaciją, kurioje kiekvienas laukas yra aprašytas, o pavyzdžiai yra lietuviški ir tikroviški.

Autentikacija dvejopa: įmonės API raktas arba OAuth prieigos raktas. Abu eina per tą patį tikrinimą, todėl teisės ir įmonės ribos yra tos pačios, kaip ir naršyklėje. Žmogus, kuris sistemoje yra tik peržiūrintis, per API taip pat nieko neįrašys.

Kartotiniai užklausų siuntimai apsaugoti: tas pats idempotencijos raktas antrą kartą grąžina pirmąjį atsakymą, o ne sukuria antrą dokumentą. Jei tuo pačiu raktu bandoma padaryti ką kita, užklausa atmetama, o ne tyliai grąžinamas senas atsakymas.

Endpointai skelbiami po vieną, kai jie aprašyti dokumentacijoje. Šiuo metu paskelbta autentikacija, įmonė, sąskaitos su visu jų ciklu, serijos, bankai, žymos ir pirkimai kartu su dokumento įkėlimu atpažinimui.

OAuth

Kad prijungtumėte Balanso prie dirbtinio intelekto kliento, prisijungimo duomenų niekur kopijuoti nereikia. Kliento registracija vyksta automatiškai, o jūs matote sutikimo langą, kuriame pasirenkate, prie kurios įmonės duomenų prieiga suteikiama. Prieigą galima atšaukti savo paskyros nustatymuose.