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.
| Strumento | Cosa fa | Tipo |
|---|---|---|
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.
- entra.microsoft.com → App registrations → New registration (tenant singolo), Redirect URI Web = quello mostrato qui sotto.
- API permissions → Dynamics 365 Business Central → Delegated → user_impersonation (più openid, email, offline_access).
- 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)
- Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
- Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
- 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.
- 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
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- 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.
Link utili
Console del fornitore citate nei passi: