Vai al contenuto
Kaiross

Gestionali

Business Central

Clienti, articoli, ordini e fatture di Microsoft Dynamics 365 Business Central (sola lettura).

  • Accesso con Connetti (OAuth)
  • Sola lettura

Strumenti per l’agente

L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.

StrumentoCosa faTipo
list_companies Società dell’ambiente Business Central. Lettura
query Legge un’entità di una società con filtro OData; restituisce una tabella (grafici ed export). Lettura

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli Business Central e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. entra.microsoft.com → App registrations → New registration (tenant singolo), Redirect URI Web = quello mostrato qui sotto.
  2. API permissions → Dynamics 365 Business Central → Delegated → user_impersonation (più openid, email, offline_access).
  3. Certificates & secrets → New client secret; inserisci tenant, ambiente (es. production), Client ID e secret, poi Connetti.

Campi del modulo: Directory (tenant) ID o dominio, Ambiente, Application (client) ID.

Da incollare (cifrato nel Vault, poi non più visibile): Client secret.

Accesso con «Connetti» (OAuth)

  1. Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
  2. Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
  3. Inserisci in Kaiross Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore, accedi con l’account da usare e autorizza.
  4. Se in seguito il test segnala «Accesso scaduto», premi Ricollega nella connessione.

Permessi (scope) richiesti

Kaiross chiede solo questi permessi al fornitore; le azioni di scrittura restano comunque spente finché non le attivi.

  • https://api.businesscentral.dynamics.com/user_impersonation

Collegarla a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. Premi Prova in chat e fai una domanda che richiede i dati del servizio.

Errori frequenti

Account non collegato o accesso scaduto
Il collegamento OAuth non è mai stato completato o non è più valido: premi Connetti o Ricollega nella connessione.
Permessi insufficienti
All’account mancano gli scope necessari: confrontali con l’elenco qui sopra. Per Microsoft 365 verifica anche il consenso dell’amministratore.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria Gestionali

Tutte le integrazioni