Plugin ChatGPT et MCP
Des données d’entreprise directement dans ChatGPT, Claude et d’autres agents IA.
Avec le plugin ChatGPT et le serveur MCP, ton agent IA consulte lui-même des données d’entreprise officielles. Tu poses une question dans le chat, l’agent choisit les bons outils et répond avec des données du registre.
Plugin ChatGPT
Le plugin ChatGPT est la voie la plus rapide. Tu n’as pas besoin de clé API, car tu te connectes avec ton compte handelsregister.ai lors de la connexion.
- Ouvre le plugin ChatGPT et ajoute-le dans ChatGPT.
- Connecte-toi avec ton compte handelsregister.ai et confirme l’accès.
- Pose ta question, par exemple « Qui dirige Hetzner Online GmbH et comment son chiffre d’affaires a-t-il évolué ? »
Claude, Cursor et autres clients MCP
MCP, le Model Context Protocol, est un standard ouvert que les agents IA utilisent pour accéder à des outils et des sources de données. Tout client qui se connecte à un serveur MCP par URL peut utiliser notre serveur.
| Quoi | Valeur |
|---|---|
| URL du serveur |
https://mcp.handelsregister.ai/mcp |
| Transport | Streamable HTTP |
| Connexion | OAuth avec ton compte, clé API dans le header x-api-key ou bearer token dans le header Authorization |
Claude
Dans Claude, tu ajoutes le serveur MCP comme connecteur personnalisé. Dans les paramètres des connecteurs, choisis « Ajouter un connecteur personnalisé », saisis un nom et l’URL du serveur, puis connecte-toi avec ton compte handelsregister.ai. Active ensuite le connecteur dans le chat sous « + » › « Connecteurs ».
Dans les espaces Team et Enterprise, un propriétaire ajoute le connecteur pour tout le monde. Chaque membre connecte ensuite son propre compte handelsregister.ai.
Claude Code
Dans Claude Code, tu ajoutes le serveur avec une seule commande. Avec le header, Claude Code utilise ta clé API.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: TA_CLE_API"
Sans le header, tu te connectes plutôt dans le navigateur : démarre une session et sélectionne le serveur sous /mcp.
Cursor
Cursor lit les serveurs MCP dans .cursor/mcp.json du projet ou dans ~/.cursor/mcp.json pour tous les projets. De nombreux autres clients utilisent le même format.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "TA_CLE_API" } } } }
Autres clients MCP
Saisis l’URL du serveur et envoie ta clé API dans le header x-api-key avec chaque requête. Tu peux aussi utiliser un bearer token dans le header Authorization ; Authentification montre comment en créer un.
Outils disponibles
Le serveur MCP propose des outils pour ton compte, les profils d’entreprise, les personnes, les documents, la recherche et Signals. Tous les outils sont en lecture seule : ils ne créent rien et ne modifient aucun réglage. Ils coûtent autant de crédits que la même requête à l’API.
Les outils d’entreprise acceptent dans le paramètre q un entity_id, un nom d’entreprise ou un tribunal du registre avec numéro de registre, par exemple « Ansbach HRB 6089 ». L’entity_id issu d’une recherche est le plus fiable. Pour la plupart des outils d’entreprise, ai_search active le mode IA et realtime le mode temps réel.
Compte
| Outil | Ce qu’il renvoie | Crédits |
|---|---|---|
| get_account_status | Plan, solde, prochaine expiration de crédits et les données que ton plan débloque. | gratuit |
Profil d’entreprise
Chaque outil d’entreprise coûte le prix de base du profil d’entreprise plus le prix de sa fonctionnalité, exactement comme fetch-organization. La fonctionnalité n’est facturée que si elle renvoie des données.
| Outil | Ce qu’il renvoie | Crédits |
|---|---|---|
| get_company_overview | Les données de base : nom, statut, forme juridique, registre, adresse, capital, objet social et secteur. | 5 |
| get_company_snapshot | Données de base, indicateurs financiers et direction actuelle en un seul appel. | 5 + 1 + 2 |
| get_financials | Indicateurs financiers par exercice, comme chiffre d’affaires, résultat net et salariés. | 5 + 1 |
| get_balance_sheet | Le bilan avec tous les postes. | 5 + 3 |
| get_profit_and_loss | Le compte de résultat. | 5 + 3 |
| get_annual_financial_statements | Comptes annuels en texte intégral, en Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Comptes annuels en texte intégral, en HTML. | 5 + 5 |
| get_related_persons | La direction et les autres personnes inscrites, les anciennes aussi si tu les demandes. | 5 + 2 |
| get_shareholders | Les associés avec leurs participations. | 5 + 5 |
| get_ubos | Les bénéficiaires effectifs (UBO). | 5 + 10 |
| get_shareholdings | Les participations de l’entreprise dans d’autres entreprises. | 5 + 5 |
| get_mergers_and_acquisitions | Fusions & acquisitions (M&A) et contrats d’entreprise. | 5 + 20 |
| get_publications | L’historique des publications du registre. | 5 + 1 |
| get_insolvency_publications | Publications d’insolvabilité. | 5 + 5 |
| get_news | Actualités sur l’entreprise issues du web. | 5 + 10 |
| get_website_content | Le contenu du site web de l’entreprise en Markdown. Cet outil utilise toujours le mode IA. | 5 + 20 (mode IA) |
| get_company_features | Plusieurs fonctionnalités en un seul appel, avec un seul prix de base. | 5 + fonctionnalités |
Personnes et documents
| Outil | Ce qu’il renvoie | Crédits |
|---|---|---|
| fetch_person | Le profil de personne : fonctions, participations et parcours d’une personne, recherchée par nom et une entreprise liée. · à partir de Plus | 15, avec participations + 5 |
| fetch_document | Un document du registre : Aktueller Abdruck (AD, extrait actuel), Chronologischer Abdruck (CD, extrait chronologique), Strukturierter Registerinhalt (SI, contenu structuré du registre), Gesellschafterliste (liste des associés) ou statuts. | 15 |
Recherche
Les outils de recherche renvoient jusqu’à 30 résultats par page, chacun avec son entity_id. Ton agent l’utilise ensuite pour récupérer le profil d’entreprise.
| Outil | Ce qu’il renvoie | Crédits |
|---|---|---|
| search_organizations | Trouver des entreprises par nom ou par filtres. | 1 par page |
| search_organizations_advanced | Rechercher avec tous les filtres de l’API et un tri, par exemple par chiffre d’affaires ou date de création. | 1 par page |
| find_companies_by_industry | Entreprises d’un secteur, décrit en mots ou sous forme de code WZ. | 1 par page |
| find_companies_by_financials | Entreprises par chiffre d’affaires, salariés, résultat net, capitaux propres et autres indicateurs. | 1 par page |
| find_companies_near | Entreprises autour d’un lieu, les plus proches en premier. | 1 par page |
| find_newly_registered_companies | Entreprises nouvellement immatriculées sur une période. | 1 par page |
| find_recently_changed_companies | Entreprises avec des modifications récentes, par exemple dans la direction, le siège ou le capital. | 1 par page |
| find_related_companies | Entreprises liées par des participations, des fonctions, des fusions ou des contrats d’entreprise. | 1 par page |
| find_companies_by_person | Entreprises dans lesquelles une personne exerce une fonction. La recherche par associé est disponible avec Pro et Max. | 1 par page |
| find_companies_by_ownership | Entreprises par structure de détention, par exemple dirigées par leur propriétaire ou familiales. · Pro, Max | 1 par page |
| find_companies_by_management | Entreprises par âge et taille de la direction. · Pro, Max | 1 par page |
| find_companies_in_insolvency | Entreprises en procédure d’insolvabilité, par phase et période. · Pro, Max | 1 par page |
| get_search_filter_reference | Les valeurs autorisées des filtres de recherche. | gratuit |
| find_industry_codes | Codes WZ pour un secteur décrit en mots, par exemple « développement de logiciels ». | gratuit |
Signals
Les outils Signals renvoient les modifications au registre sur toutes les entreprises, jusqu’à 20 par page. Une page est facturée même si elle est vide.
| Outil | Ce qu’il renvoie | Crédits |
|---|---|---|
| get_recent_new_registrations | Immatriculations. | 20 par page |
| get_recent_management_changes | Changements de direction. | 20 par page |
| get_recent_capital_changes | Modifications de capital. | 20 par page |
| get_recent_master_data_changes | Modifications des données de base comme le nom, le siège ou l’adresse. | 20 par page |
| get_recent_company_closures | Fermetures & dissolutions. | 20 par page |
| get_recent_insolvency_events | Insolvabilités. · Pro, Max | 20 par page |
| get_recent_mergers_and_transformations | Transformations & fusions-acquisitions. · Max | 20 par page |
| get_recent_company_changes | Toutes les modifications pour jusqu’à cinq entreprises précises. | 20 par page |
| get_signal_details | Un signal unique avec tous les détails. | 20 |
Coûts
Chaque appel d’outil coûte autant de crédits que la même requête à l’API. Il n’y a pas de frais spécifiques pour MCP. Les crédits sont débités du compte avec lequel tu t’es connecté ou auquel appartient la clé API.
Les mêmes règles que dans l’API s’appliquent : les fonctionnalités sans données ne coûtent rien, et un appel échoué ne coûte rien. Le mode IA est facturé même sans correspondance, le mode temps réel pour chaque récupération en direct réussie. Chaque résultat indique les crédits facturés dans meta.request_credit_cost et ton solde dans meta.credits_remaining.
Les limites sont aussi les mêmes que dans l’API, pour les documents par exemple 5 requêtes par minute. Plus d’informations sous Facturation et Limites.