Collegare Openapi.com MCP a Microsoft Copilot

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Openapi.com Company, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Openapi.com Company + Microsoft Copilot

Dati di aziende italiane e internazionali da Openapi.com per partita IVA o codice fiscale: profilo aziendale su tre livelli, PEC, codice SDI, indirizzo, soci, stakeholder, titolari effettivi, verifiche di cessazione e di gruppo IVA, pubbliche amministrazioni, split payment, ricerca aziende, verifiche VIES UE e ricerche in tutto il mondo. Sola lettura; Openapi.com addebita ogni singola chiamata.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

OPENAPI_COMPANY_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede pochi minuti. Ti servono un account Openapi.com su console.openapi.com con credito nel wallet o un abbonamento alla Company API, e un token con gli scope Company.

1. Accedi a console.openapi.com e ricarica il credito o abbonati alla Company API.
2. Crea un token con gli scope Company che ti servono, nella sezione Tokens della console o con la OAuth API. Uno scope indica l'endpoint, ad esempio GET:company.openapi.com/IT-advanced per openapi_company_it_advanced. Un token può avere più scope e vale fino a un anno.
3. Copia il token in OPENAPI_COMPANY_TOKEN: solo il token, senza Bearer. Il connettore lo invia come Authorization: Bearer ....
4. Installa il connettore. Per verificare la connessione, cerca con openapi_company_it_start una partita IVA che conosci; anche questa chiamata viene addebitata.

Ogni chiamata si paga: Openapi.com addebita ogni richiesta sul tuo account, dal credito del wallet o dall'abbonamento, al prezzo per endpoint indicato su console.openapi.com. Nessun tool è gratuito. openapi_company_it_full è la chiamata più cara dell'API; openapi_company_it_search ha un prezzo che dipende dal numero di risultati e dall'arricchimento dei dati richiesto. L'AI sceglie il tool più economico che risponde alla domanda (openapi_company_it_start o openapi_company_it_name prima di openapi_company_it_advanced, openapi_company_it_advanced prima di openapi_company_it_full), non ripete una ricerca di cui ha già la risposta e lancia una ricerca prima con dryRun 1: così ottiene il numero di risultati e il prezzo, che ti comunica prima della ricerca vera.

Gli scope decidono cosa funziona: una chiamata a un endpoint per cui il token non ha lo scope risponde 403. In quel caso crea un token con gli scope GET:company.openapi.com che ti servono.

Produzione, o la sandbox per provare: il connettore chiama la produzione su https://company.openapi.com. Openapi.com offre anche una sandbox su https://test.company.openapi.com, con token sandbox propri e un elenco fisso di aziende di test. Per provarla, imposta come base URL del connettore l'indirizzo della sandbox e usa un token sandbox. Un token sandbox usato in produzione risponde 401.

Cloud e self-hosting funzionano allo stesso modo: il token è l'unica credenziale, e il connettore chiama lo stesso indirizzo di Openapi.com in entrambi i casi.

Quali paesi: l'Italia in profondità, da Camera di Commercio, Agenzia delle Entrate e indice IPA delle pubbliche amministrazioni. Per gli altri paesi UE, openapi_company_eu_vies_check verifica una partita IVA in VIES e openapi_company_eu_start restituisce i dati di base per i prefissi AT, BE, BG, CY, CZ, DE, DK, EE, EL, ES, FI, FR, GB, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI e SK. openapi_company_ww_start e openapi_company_ww_advanced coprono aziende di qualsiasi paese, con dati avanzati dove le fonti del paese li forniscono. Gli endpoint di Openapi.com specifici per FR, DE, ES, PT, GB, BE, AT, CH e PL non sono inclusi: li sostituiscono i tool mondiali.

Identificativi: una partita IVA italiana ha 11 cifre (12485671007), il codice fiscale di una società di solito le stesse 11 cifre, quello di una ditta individuale 16 caratteri. Le risposte riportano anche un id Openapi che la maggior parte dei tool italiani accetta al posto della partita IVA. openapi_company_eu_vies_check vuole il codice paese a parte (EL per la Grecia), openapi_company_eu_start come prefisso (DE123456789), e i tool mondiali vogliono un codice paese ISO di due lettere più partita IVA, codice fiscale, numero di registro o id Openapi.

Ricerca aziende: openapi_company_it_search filtra per nome (almeno 3 caratteri, * come carattere jolly), provincia, comune, codice ATECO, forma giuridica (codici da openapi_company_it_legal_forms), stato in Camera di Commercio, fatturato, dipendenti, socio, PEC, codice SDI o un raggio attorno a un punto. Senza dataEnrichment restituisce solo gli id; con dataEnrichment i dati delle aziende, addebitati per risultato. Al massimo 1000 risultati per chiamata; si sfoglia con skip e limit.

Fonti lente: quando i registri sono lenti, una chiamata pesante come openapi_company_it_full o openapi_company_it_stakeholders risponde dopo 30 secondi con un id di richiesta e lo stato PENDING. L'AI chiama poi openapi_company_check_request con quell'id poco dopo, invece di pagare di nuovo la ricerca.

Non inclusi: le varianti POST asincrone con callback, i pacchetti AML e marketing e il monitoraggio delle variazioni (/monitor).

Errori frequenti: una chiamata fallita riporta success: false, un codice error e un message. 401 vuol dire che il token manca, è sbagliato o scaduto, oppure è un token sandbox usato in produzione. 402 vuol dire che l'account non ha più credito per quella chiamata: ricarica su console.openapi.com. 403 vuol dire che al token manca lo scope per quell'endpoint. 404 vuol dire che non è stata trovata nessuna azienda, 406 una partita IVA o un codice fiscale non validi nel formato. 429 vuol dire troppe richieste, oppure il registro VIES nazionale occupato: aspetta un momento e riprova.

Cosa legge: per le aziende italiane nome, partita IVA, codice fiscale, indirizzo e stato di attività; codice ATECO, forma giuridica, numero REA, capitale sociale, fatturato e dipendenti degli ultimi bilanci, date di iscrizione e di cessazione; il fascicolo completo con amministratori e oltre 400 voci di bilancio; la PEC con lo storico e il codice SDI per la fattura elettronica; soci sopra il 10 per cento, stakeholder, le società di cui detiene quote e i titolari effettivi; se una partita IVA è cessata, se un'azienda appartiene a un gruppo IVA e se è negli elenchi dello split payment; le pubbliche amministrazioni con i loro uffici IPA e codici SDI; i codici delle forme giuridiche. Per gli altri paesi: la validità VIES con nome e indirizzo, e dati aziendali di base o avanzati in tutto il mondo.

Sola lettura: ogni tool legge e basta. Non viene scritto nulla su Openapi.com né su alcun registro, quindi nessun tool è disattivato all'installazione; ogni chiamata viene comunque addebitata.

Step 2 — Installa l'adapter

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

Step 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 Openapi.com Company.
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.

Tool disponibili

Esempi di prompt

• "Controlla la partita IVA 12485671007 prima che emetta la fattura: ragione sociale, se è ancora attiva, codice SDI e PEC."
• "Chi sono i soci e i titolari effettivi dell'azienda con partita IVA 12485671007?"
• "Prima di fatturare a questo ente pubblico, verifica se è negli elenchi dello split payment e dammi i codici SDI dei suoi uffici."
• "Quante aziende attive con codice ATECO 62.01.00 ci sono in provincia di Milano? Dimmi il prezzo prima di lanciare la ricerca."
• "La partita IVA tedesca DE123456789 è valida in VIES, e quale ragione sociale risulta registrata?"

FAQ

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

• Landing del connettore
• Collegare a Claude