Guida al connettore
Connettore MCP di Rigo
Cerca e consulta le fonti tributarie di Rigo direttamente da Claude o da un altro assistente compatibile con MCP.
Il connettore collega l’assistente agli archivi di normativa, prassi fiscale, decisioni della Corte di Cassazione e sentenze tributarie. Rigo restituisce le fonti; l’assistente che utilizzi elabora la risposta nella conversazione.
URL del server MCP
https://rigo.tax/mcpServer remoto · HTTPS · Autenticazione OAuth
Collegare Rigo
Servono un account Rigo attivo e un client che supporti server MCP remoti con autenticazione OAuth. Le funzionalità disponibili nel client dipendono dal suo piano e dalle impostazioni dell’organizzazione.
Configurazione su Claude
Rigo è disponibile nella directory ufficiale dei connettori di Claude. Puoi collegarlo cercando il nome, senza inserire manualmente l’indirizzo del server.
- Apri i connettori di Claude. Vai in Impostazioni → Connettori e seleziona “Scopri” (Discover).
- Cerca Rigo. Scrivi “Rigo” nella ricerca dei connettori e apri il risultato pubblicato da “Rigo AI”.
- Avvia il collegamento. Nella scheda di Rigo, clicca “Connetti a Claude” (Connect to Claude).
- Accedi e autorizza. Si apre Rigo: effettua l’accesso, verifica il client che richiede il collegamento e seleziona “Autorizza”. Le credenziali Rigo si inseriscono nella pagina di accesso Rigo, non nella conversazione.
- Abilita Rigo nella conversazione. Prova una delle richieste riportate sotto e verifica che l’assistente utilizzi gli strumenti del connettore.
Segui il tutorial con le immagini dei passaggi.
L’amministratore potrebbe dover abilitare Rigo prima che i membri possano collegarlo. Ogni utente completa l’accesso con il proprio account Rigo.
Altri client MCP
Aggiungi lo stesso URL come server MCP remoto con trasporto Streamable HTTP. Completa il flusso OAuth proposto dal client e abilita gli strumenti. La procedura e i nomi dei menu possono variare; il connettore non richiede l’installazione di software locale.
Esempi di utilizzo
Puoi formulare richieste in linguaggio naturale. Quando conosci gli estremi di una fonte, includili nella domanda.
Trovare fonti su un argomento
Cerca nella prassi dell’Agenzia delle Entrate documenti sulle note di variazione IVA. Indicami gli estremi delle fonti e consulta i documenti rilevanti.
L’assistente cerca i documenti pertinenti e può recuperarne il testo per costruire una risposta con riferimenti verificabili.
Consultare una disposizione
Consulta l’articolo 73 del DPR 917 del 1986 e riportami gli estremi e il testo della disposizione disponibile in Rigo.
L’assistente consulta la norma dagli estremi indicati, senza dover prima effettuare una ricerca per argomento.
Leggere un documento di prassi
Recupera la risposta a interpello dell’Agenzia delle Entrate n. 268 del 2023. Riassumi il quesito e la risposta, distinguendo la sintesi dal testo della fonte.
L’assistente recupera il documento identificato da ente, tipo, numero e anno e ne usa il contenuto nella risposta.
Strumenti disponibili
I sei strumenti leggono gli archivi delle fonti. Non modificano documenti, non inviano comunicazioni e non eseguono adempimenti o operazioni fiscali per conto dell’utente.
| Strumento | Funzione |
|---|---|
cerca_fonti | Ricerca per argomento nella normativa, nella prassi e nella giurisprudenza. Restituisce passaggi rilevanti e identificativi delle fonti. |
consulta_legge | Consulta una legge tramite tipo, numero e anno. La richiesta può specificare un articolo, un allegato o un comma. |
consulta_prassi | Consulta un documento di prassi tramite ente, tipo, numero e anno: ad esempio una risposta a interpello o una circolare. |
consulta_sentenza_cassazione | Consulta una decisione di Cassazione tramite citazione, identificativo ECLI o ID interno Rigo. |
consulta_sentenza_tributaria | Consulta una sentenza tributaria tramite corte, numero e anno oppure ID interno Rigo. |
recupera_fonti | Recupera il contenuto delle fonti già individuate, usando i loro source_id completi. Accetta anche fonti di archivi diversi. |
L’assistente riceve dal server gli schemi dei parametri, le descrizioni e le annotazioni di sola lettura. Non occorre compilare manualmente questi parametri per usare il connettore in una conversazione.
Dati e permessi
Accesso autorizzato
Il collegamento usa OAuth con consenso esplicito e PKCE. Il permesso mcp:read consente la consultazione delle fonti; offline_access, se richiesto, permette al client di rinnovare la sessione senza ripetere ogni volta l’accesso.
Gli strumenti esposti non permettono di leggere la cronologia delle chat, i file del client o i dossier dello studio, né di modificare l’account Rigo. Per interrompere l’utilizzo del collegamento, disconnetti Rigo dalle impostazioni del client.
Quali informazioni riceve Rigo
Il client invia i parametri delle chiamate: query di ricerca, filtri, estremi delle fonti o identificativi da recuperare, oltre alle informazioni necessarie all’autenticazione. Rigo non acquisisce automaticamente l’intera conversazione. Qualsiasi informazione inserita dall’assistente nei parametri viene però trasmessa al servizio.
Per gestire quote, sicurezza e diagnostica, Rigo registra dati di utilizzo, tra cui utente e organizzazione, client, strumento, query o riferimenti richiesti e numero di risultati. Le ricerche possono impiegare servizi tecnici di elaborazione per individuare e ordinare le fonti.
Per cercare una fonte sono normalmente sufficienti il tema o gli estremi. Evita dati personali dei clienti e informazioni riservate non necessarie. Il trattamento della conversazione da parte di Claude o di altri assistenti dipende dalle condizioni del rispettivo provider e dalle impostazioni del tuo account.
Per finalità, conservazione, fornitori e diritti, consulta la Privacy policy di Rigo e il DPA.
Limiti e lettura dei risultati
- Quote di utilizzo. Le chiamate dipendono dai limiti dell’account o dell’organizzazione Rigo. Una richiesta all’assistente può comportare più chiamate agli strumenti.
- Dimensione delle risposte. La ricerca restituisce al massimo 50 risultati per chiamata; il recupero per ID accetta al massimo 10 fonti. I campi testuali possono essere troncati e terminare con “...”. La soglia predefinita è 12.000 caratteri, fino a 20.000 per campo, non per l’intera risposta.
- Testi e sintesi. I passaggi di ricerca possono contenere arricchimenti. I campi
generated_principleegenerated_subjectsono elaborazioni, da distinguere dal testo della fonte. - Copertura e corrispondenze. Il connettore consulta le fonti presenti negli archivi Rigo. Una fonte non trovata non è prova della sua inesistenza; più corrispondenze possono richiedere ulteriori estremi per identificare quella desiderata.
Le risposte dell’assistente richiedono verifica professionale. Controlla il testo, la data e la pertinenza delle fonti rispetto al caso e al periodo di interesse.
Risoluzione dei problemi
Il collegamento o l’accesso non si completa
Verifica l’URL del server e di aver completato l’accesso a Rigo nella finestra di autorizzazione. Se la richiesta è scaduta, avvia un nuovo collegamento dal client. In un’organizzazione, controlla che l’amministratore consenta il connettore.
Rigo è collegato, ma l’assistente non lo usa
Controlla che Rigo sia abilitato nella conversazione. Chiedi esplicitamente di cercare o consultare una fonte con Rigo, usando uno degli esempi di questa pagina. La selezione degli strumenti dipende anche dal client e dalle sue impostazioni.
È stata raggiunta la quota di utilizzo
Le chiamate agli strumenti consumano la quota MCP prevista dall’account o dall’organizzazione Rigo. Segui le indicazioni del messaggio ricevuto; se segnala la quota giornaliera esaurita, attendi il rinnovo. Per chiarire i limiti del tuo account, contatta l’assistenza.
Una fonte non viene trovata o ha più corrispondenze
Verifica tipo, numero e anno; per una sentenza controlla anche corte, sezione e data, se disponibili. Una ricerca per argomento può aiutare a identificare gli estremi corretti. Se il documento resta assente, il risultato non dimostra che la fonte non esista.
Assistenza
Scrivi a info@rigo.tax indicando il client utilizzato, lo strumento coinvolto e il messaggio di errore. Includi una descrizione del problema priva di dati riservati. Non inviare password, token o codici di accesso.