FGO API Ghiduri Referință API

Conectare

Conectează FGO la asistentul tău AI prin MCP (Model Context Protocol), ca să lucrezi cu datele firmelor tale din conversație.

ChatGPT și Claude

Alege asistentul pentru instrucțiunile de conectare:

Urmează pașii din ghidul ales pentru autorizarea accesului la FGO.

Alt client MCP

Pentru un client care permite conectarea la un server MCP la distanță cu autentificare Bearer, folosește adresa:

https://mcp.fgo.ro/mcp

Generează cheia în FGO

  1. În FGO, deschide Setări → eCommerce → API → Chei MCP.
  2. Generează o cheie: alege firmele la care îi dai acces și data de expirare.
  3. Copiază cheia afișată. O poți vedea o singură dată.

Cheile MCP sunt personale și pot autoriza mai multe firme, indiferent de firma curentă din FGO. Cheile MCP sunt separate de cheile pentru API REST. Folosește o cheie MCP pentru această conectare.

Configurează clientul

Adaugă adresa serverului în configurația MCP a clientului și setează cheia în câmpul pentru token Bearer. Dacă aplicația cere explicit un header, acesta este:

Authorization: Bearer <cheia-MCP-din-FGO>

Păstrează cheia în configurația de autentificare a clientului, fără să o incluzi în mesajele conversației.

Alegerea firmei

La apelarea unui tool, transmite CUI-ul firmei în params.arguments.cod_unic_firma.

Prima conversație

După conectare, activează FGO în conversație și încearcă: „Ce facturi am de încasat pentru firma mea?”. Precizează firma dacă ai autorizat mai multe.