Collegare Openapi.com MCP a Claude

💡 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 + Claude

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 Claude

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.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Openapi.com Company, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

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

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot