Collegare ANAF a Microsoft Copilot via MCP

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → ANAF Romania Company Check, installalo senza chiave, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

ANAF Romania Company Check + Microsoft Copilot

Controllo delle aziende romene con i servizi web pubblici gratuiti ANAF, senza chiave API: identità, registrazione IVA, IVA su base di cassa, stato inattivo, IVA scissa e stato RO e-Factura fino a 100 codici fiscali (CUI) in una data specifica, e gli indicatori del bilancio annuale pubblicato.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:

(nessuna: dati pubblici, nessuna chiave API)

Passo 1 — Configura il connettore

Dati pubblici, nessuna chiave: la configurazione richiede meno di un minuto. Il connettore utilizza i servizi web pubblici gratuiti di ANAF (Agenția Națională de Administrare Fiscală), l'amministrazione fiscale romena: il controllo dello stato del contribuente e IVA (PlatitorTvaRest, versione 9) e i bilanci pubblicati (bilanț). Non è necessario alcun account, chiave API o accesso.

1. Nello store dei connettori, seleziona ANAF Romania Company Check e installalo. Non c'è nulla da incollare e nessun passaggio di Autorizza con Provider.
2. Controllalo con anaf_get_company_vat_status, il codice fiscale 14399840 e la data odierna: restituisce il nome dell'azienda, l'indirizzo, lo stato di registrazione e lo stato IVA in quella data.

Cloud e self-hosted funzionano allo stesso modo: non c'è nulla da configurare in entrambi.

Identificatori: il codice fiscale (CUI o CIF) è un numero di fino a 10 cifre. Le aziende registrate per l'IVA lo citano con il prefisso RO (RO14399840); il connettore lo invia sempre senza RO, come numero. nrRegCom è il numero di registrazione commerciale, ad esempio J40/372/2002.

Da dove iniziare: per controllare se un fornitore è reale, attivo e registrato per l'IVA alla data di una fattura, usa anaf_get_company_vat_status per una singola azienda o anaf_get_companies_vat_status per fino a 100, con la data della fattura o del controllo (YYYY-MM-DD). Per la dimensione di un'azienda, anaf_get_financial_statement legge gli indicatori pubblicati di un anno; l'anno precedente è il primo tentativo sicuro, perché i bilanci dell'anno corrente appaiono solo dopo la presentazione.

Cosa legge: dal controllo IVA, il nome, gli indirizzi fiscali e della sede legale, il numero di registrazione commerciale, lo stato di registrazione e la data, il codice di attività CAEN, la forma giuridica e l'ufficio fiscale competente; se l'azienda è registrata per l'IVA in quella data, con i suoi periodi IVA e il motivo legale di una cancellazione; IVA su base di cassa (TVA la încasare); se ANAF l'ha dichiarata inattiva, con le date di inattivazione, riattivazione e cancellazione; IVA scissa; e se è nel registro RO e-Factura. I codici che ANAF non conosce tornano in notFound. Dal bilancio, indicatori in lei (RON) con le loro etichette romene: attivi fissi e correnti, inventari, crediti, liquidità, passività, patrimonio netto, fatturato netto, ricavi e spese totali, utile o perdita lordo e netto, e il numero medio di dipendenti. I numeri degli indicatori significano cose diverse per diversi tipi di bilancio, quindi l'AI legge l'etichetta, non solo il codice.

Perché il flag inattivo è importante: le fatture di un contribuente che ANAF ha dichiarato inattivo rappresentano un rischio fiscale. Controlla alla data della fattura e conserva la data del controllo.

Solo lettura: ogni strumento legge solo, quindi non c'è nulla da confermare e nessuno strumento viene disattivato all'installazione.

Limiti: ANAF consente al massimo 100 codici fiscali per richiesta IVA e al massimo 1 richiesta al secondo per cliente, e dichiara che il sovraccarico del servizio è sanzionato. L'AI distribuisce le chiamate quando controlla molte aziende e inserisce fino a 100 codici in una richiesta.

Il connettore non invia dichiarazioni o fatture e-Factura e non modifica nulla presso ANAF.

Passo 2 — Installa l'adattatore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Passo 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di ANAF Romania Company Check.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Strumenti disponibili

Esempi di prompt

• "Era CUI 14399840 registrato per IVA e non inattivo il 2026-10-15, la data della fattura?"
• "Controlla questi 20 codici fiscali dei fornitori per oggi: quali sono inattivi, non registrati per IVA o non in RO e-Factura?"
• "Mostra gli indicatori del bilancio 2024 per CUI 14399840: fatturato netto, utile netto e numero medio di dipendenti."
• "Questa azienda applica IVA su base di cassa, e da quando?"
• "Quando è stato registrato RO14399840, e qual è il suo indirizzo registrato e codice CAEN?"

FAQ

Devo rimuovere il prefisso RO? Puoi digitarlo in entrambi i modi; il connettore invia il codice fiscale ad ANAF come numero senza RO, come richiesto da ANAF.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude