Plugin ChatGPT e MCP
Dati aziendali direttamente in ChatGPT, Claude e altri agenti AI.
Con il plugin ChatGPT e il server MCP il tuo agente AI consulta da solo i dati aziendali ufficiali. Fai una domanda in chat, l’agente sceglie gli strumenti giusti e risponde con i dati del registro.
Plugin ChatGPT
Il plugin ChatGPT è la via più veloce. Non ti serve una chiave API, perché al collegamento accedi con il tuo account handelsregister.ai.
- Apri il plugin ChatGPT e aggiungilo in ChatGPT.
- Accedi con il tuo account handelsregister.ai e conferma l’accesso.
- Fai la tua domanda, ad esempio “Chi dirige Hetzner Online GmbH e come si è sviluppato il suo fatturato?”
Claude, Cursor e altri client MCP
MCP, il Model Context Protocol, è uno standard aperto con cui gli agenti AI accedono a strumenti e fonti di dati. Ogni client che si collega a un server MCP tramite URL può usare il nostro server.
| Cosa | Valore |
|---|---|
| URL del server |
https://mcp.handelsregister.ai/mcp |
| Trasporto | Streamable HTTP |
| Accesso | OAuth con il tuo account, chiave API nell’header x-api-key o bearer token nell’header Authorization |
Claude
In Claude aggiungi il server MCP come connettore personalizzato. Nelle impostazioni dei connettori scegli “Aggiungi connettore personalizzato”, inserisci un nome e l’URL del server e accedi con il tuo account handelsregister.ai. Poi attiva il connettore in chat in “+” › “Connettori”.
Nei workspace Team ed Enterprise un owner aggiunge il connettore per tutti. Ogni membro collega poi il proprio account handelsregister.ai.
Claude Code
In Claude Code aggiungi il server con un comando. Con l’header, Claude Code usa la tua chiave API.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: LA_TUA_CHIAVE_API"
Senza l’header accedi invece nel browser: avvia una sessione e seleziona il server in /mcp.
Cursor
Cursor legge i server MCP da .cursor/mcp.json nel progetto o da ~/.cursor/mcp.json per tutti i progetti. Molti altri client usano lo stesso formato.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "LA_TUA_CHIAVE_API" } } } }
Altri client MCP
Inserisci l’URL del server e invia la tua chiave API nell’header x-api-key con ogni richiesta. In alternativa usa un bearer token nell’header Authorization; Autenticazione mostra come crearne uno.
Strumenti disponibili
Il server MCP offre strumenti per il tuo account, profili aziendali, persone, documenti, ricerca e Signals. Tutti gli strumenti leggono soltanto: non creano nulla e non cambiano impostazioni. Costano tanti crediti quanti la stessa richiesta all’API.
Gli strumenti aziendali accettano nel parametro q un entity_id, un nome di azienda o tribunale del registro con numero di registro, ad esempio “Ansbach HRB 6089”. L’entity_id da una ricerca è il più affidabile. Per la maggior parte degli strumenti aziendali ai_search attiva la Modalità AI e realtime attiva Tempo reale.
Account
| Strumento | Cosa restituisce | Crediti |
|---|---|---|
| get_account_status | Piano, saldo, prossima scadenza dei crediti e i dati che il tuo piano sblocca. | gratis |
Profilo aziendale
Ogni strumento aziendale costa il prezzo base del profilo aziendale più il prezzo della sua feature, proprio come fetch-organization. La feature viene addebitata solo se restituisce dati.
| Strumento | Cosa restituisce | Crediti |
|---|---|---|
| get_company_overview | I dati di base: nome, stato, forma giuridica, registro, indirizzo, capitale, oggetto sociale e settore. | 5 |
| get_company_snapshot | Dati di base, KPI finanziari e la direzione attuale in una sola chiamata. | 5 + 1 + 2 |
| get_financials | KPI finanziari per esercizio, come fatturato, utile netto e dipendenti. | 5 + 1 |
| get_balance_sheet | Lo stato patrimoniale con tutte le voci. | 5 + 3 |
| get_profit_and_loss | Il conto economico. | 5 + 3 |
| get_annual_financial_statements | Bilanci d’esercizio come testo integrale in Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Bilanci d’esercizio come testo integrale in HTML. | 5 + 5 |
| get_related_persons | La direzione e le altre persone iscritte, anche quelle passate se le chiedi. | 5 + 2 |
| get_shareholders | I soci con le loro quote. | 5 + 5 |
| get_ubos | I titolari effettivi (UBO). | 5 + 10 |
| get_shareholdings | Le partecipazioni dell’azienda in altre aziende. | 5 + 5 |
| get_mergers_and_acquisitions | Fusioni e acquisizioni (M&A) e contratti di dominio. | 5 + 20 |
| get_publications | Lo storico delle pubblicazioni del registro. | 5 + 1 |
| get_insolvency_publications | Pubblicazioni sulle insolvenze. | 5 + 5 |
| get_news | Notizie sull’azienda dal web. | 5 + 10 |
| get_website_content | Il contenuto del sito web aziendale come Markdown. Questo strumento usa sempre la Modalità AI. | 5 + 20 (Modalità AI) |
| get_company_features | Più feature in una sola chiamata, con un solo prezzo base. | 5 + feature |
Persone e documenti
| Strumento | Cosa restituisce | Crediti |
|---|---|---|
| fetch_person | Il profilo persona: cariche, partecipazioni e carriera di una persona, cercata per nome e un’azienda collegata. · da Plus | 15, con partecipazioni + 5 |
| fetch_document | Un documento dal registro: Aktueller Abdruck (AD, estratto attuale), Chronologischer Abdruck (CD, estratto cronologico), Strukturierter Registerinhalt (SI, contenuto strutturato del registro), Gesellschafterliste (elenco soci) o statuto. | 15 |
Ricerca
Gli strumenti di ricerca restituiscono fino a 30 risultati per pagina, ciascuno con il suo entity_id. Il tuo agente lo usa poi per recuperare il profilo aziendale.
| Strumento | Cosa restituisce | Crediti |
|---|---|---|
| search_organizations | Trovare aziende per nome o filtri. | 1 per pagina |
| search_organizations_advanced | Ricerca con tutti i filtri dell’API e ordinamento, ad esempio per fatturato o data di fondazione. | 1 per pagina |
| find_companies_by_industry | Aziende di un settore, descritto a parole o come codice WZ. | 1 per pagina |
| find_companies_by_financials | Aziende per fatturato, dipendenti, utile netto, patrimonio netto e altri KPI. | 1 per pagina |
| find_companies_near | Aziende intorno a un luogo, le più vicine per prime. | 1 per pagina |
| find_newly_registered_companies | Aziende iscritte di recente in un periodo. | 1 per pagina |
| find_recently_changed_companies | Aziende con modifiche recenti, ad esempio nella direzione, nella sede legale o nel capitale. | 1 per pagina |
| find_related_companies | Aziende collegate tramite partecipazioni, cariche, fusioni o contratti di dominio. | 1 per pagina |
| find_companies_by_person | Aziende in cui una persona ricopre una carica. La ricerca per socio è disponibile con Pro e Max. | 1 per pagina |
| find_companies_by_ownership | Aziende per struttura proprietaria, ad esempio gestite dal proprietario o a conduzione familiare. · Pro, Max | 1 per pagina |
| find_companies_by_management | Aziende per età e dimensione della direzione. · Pro, Max | 1 per pagina |
| find_companies_in_insolvency | Aziende in procedura di insolvenza, per fase e periodo. · Pro, Max | 1 per pagina |
| get_search_filter_reference | I valori ammessi dei filtri di ricerca. | gratis |
| find_industry_codes | Codici WZ per un settore descritto a parole, ad esempio “sviluppo software”. | gratis |
Signals
Gli strumenti Signals restituiscono le modifiche nel registro su tutte le aziende, fino a 20 per pagina. Una pagina viene addebitata anche se è vuota.
| Strumento | Cosa restituisce | Crediti |
|---|---|---|
| get_recent_new_registrations | Nuove iscrizioni. | 20 per pagina |
| get_recent_management_changes | Cambi nella direzione. | 20 per pagina |
| get_recent_capital_changes | Variazioni di capitale. | 20 per pagina |
| get_recent_master_data_changes | Modifiche ai dati anagrafici come nome, sede legale o indirizzo. | 20 per pagina |
| get_recent_company_closures | Chiusure e scioglimenti. | 20 per pagina |
| get_recent_insolvency_events | Insolvenze. · Pro, Max | 20 per pagina |
| get_recent_mergers_and_transformations | Trasformazioni & M&A. · Max | 20 per pagina |
| get_recent_company_changes | Tutte le modifiche per fino a cinque aziende specifiche. | 20 per pagina |
| get_signal_details | Un singolo segnale con tutti i dettagli. | 20 |
Costi
Ogni chiamata a uno strumento costa tanti crediti quanti la stessa richiesta all’API. Non c’è un costo separato per MCP. I crediti vengono scalati dall’account con cui hai effettuato l’accesso o a cui appartiene la chiave API.
Valgono le stesse regole dell’API: le feature senza dati non costano nulla e una chiamata non riuscita non costa nulla. La Modalità AI viene addebitata anche senza risultato, Tempo reale per ogni recupero in diretta riuscito. Ogni risultato indica i crediti addebitati in meta.request_credit_cost e il tuo saldo in meta.credits_remaining.
Anche i limiti sono gli stessi dell’API, per i documenti ad esempio 5 richieste al minuto. Maggiori dettagli in Fatturazione e Limiti.