Plugin do ChatGPT e MCP
Dados de empresas direto no ChatGPT, no Claude e em outros agentes de IA.
Com o plugin do ChatGPT e o servidor MCP, seu agente de IA consulta dados oficiais de empresas por conta própria. Você faz uma pergunta no chat, o agente escolhe as ferramentas certas e responde com dados do registro.
Plugin do ChatGPT
O plugin do ChatGPT é o caminho mais rápido. Você não precisa de chave de API, porque entra com sua conta do handelsregister.ai ao conectar.
- Abra o plugin do ChatGPT e adicione-o no ChatGPT.
- Entre com sua conta do handelsregister.ai e confirme o acesso.
- Faça sua pergunta, por exemplo “Quem dirige a Hetzner Online GmbH e como evoluiu o faturamento dela?”
Claude, Cursor e outros clientes MCP
MCP, o Model Context Protocol, é um padrão aberto que agentes de IA usam para acessar ferramentas e fontes de dados. Qualquer cliente que se conecta a um servidor MCP por URL pode usar o nosso servidor.
| O quê | Valor |
|---|---|
| URL do servidor |
https://mcp.handelsregister.ai/mcp |
| Transporte | Streamable HTTP |
| Login | OAuth com sua conta, chave de API no header x-api-key ou bearer token no header Authorization |
Claude
No Claude, você adiciona o servidor MCP como conector personalizado. Nas configurações de conectores, escolha “Add custom connector”, informe um nome e a URL do servidor e entre com sua conta do handelsregister.ai. Depois, ative o conector no chat em “+” › “Connectors”.
Em workspaces Team e Enterprise, um owner adiciona o conector para todos. Cada membro então conecta sua própria conta do handelsregister.ai.
Claude Code
No Claude Code, você adiciona o servidor com um comando. Com o header, o Claude Code usa sua chave de API.
claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \ --header "x-api-key: SUA_CHAVE_DE_API"
Sem o header, você entra pelo navegador: inicie uma sessão e selecione o servidor em /mcp.
Cursor
O Cursor lê servidores MCP de .cursor/mcp.json no projeto ou de ~/.cursor/mcp.json para todos os projetos. Muitos outros clientes usam o mesmo formato.
{ "mcpServers": { "handelsregister": { "url": "https://mcp.handelsregister.ai/mcp", "headers": { "x-api-key": "SUA_CHAVE_DE_API" } } } }
Outros clientes MCP
Informe a URL do servidor e envie sua chave de API no header x-api-key em cada requisição. Como alternativa, use um bearer token no header Authorization; Autenticação mostra como criar um.
Ferramentas disponíveis
O servidor MCP oferece ferramentas para sua conta, perfis de empresas, pessoas, documentos, busca e Signals. Todas as ferramentas só leem: não criam nada e não alteram configurações. Elas custam tantos créditos quanto a mesma requisição à API.
As ferramentas de empresa recebem um entity_id, um nome de empresa ou tribunal de registro com número de registro no parâmetro q, por exemplo “Ansbach HRB 6089”. O entity_id de uma busca é o mais confiável. Na maioria das ferramentas de empresa, ai_search ativa o Modo IA e realtime ativa o Tempo real.
Conta
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| get_account_status | Plano, saldo, próximo vencimento de créditos e os dados que o seu plano libera. | grátis |
Perfil da empresa
Cada ferramenta de empresa custa o preço base do perfil da empresa mais o preço do seu recurso, assim como fetch-organization. O recurso só é cobrado quando retorna dados.
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| get_company_overview | Os dados básicos: nome, situação, forma jurídica, registro, endereço, capital, objeto social e setor. | 5 |
| get_company_snapshot | Dados básicos, KPIs financeiros e a administração atual numa só chamada. | 5 + 1 + 2 |
| get_financials | KPIs financeiros por exercício, como faturamento, lucro líquido e funcionários. | 5 + 1 |
| get_balance_sheet | O balanço com todas as contas. | 5 + 3 |
| get_profit_and_loss | A demonstração de resultados (DRE). | 5 + 3 |
| get_annual_financial_statements | Demonstrações financeiras anuais em texto completo como Markdown. | 5 + 5 |
| get_annual_financial_statements_html | Demonstrações financeiras anuais em texto completo como HTML. | 5 + 5 |
| get_related_persons | A administração e outras pessoas registradas, também as anteriores, se você pedir. | 5 + 2 |
| get_shareholders | Os sócios com suas participações. | 5 + 5 |
| get_ubos | Os beneficiários finais (UBO). | 5 + 10 |
| get_shareholdings | As participações da empresa em outras empresas. | 5 + 5 |
| get_mergers_and_acquisitions | Fusões e aquisições (M&A) e contratos de empresa. | 5 + 20 |
| get_publications | O histórico de publicações do registro. | 5 + 1 |
| get_insolvency_publications | Publicações de insolvência. | 5 + 5 |
| get_news | Notícias sobre a empresa na web. | 5 + 10 |
| get_website_content | O conteúdo do site da empresa como Markdown. Esta ferramenta sempre usa o Modo IA. | 5 + 20 (Modo IA) |
| get_company_features | Vários recursos numa só chamada, com um único preço base. | 5 + recursos |
Pessoas e documentos
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| fetch_person | O perfil de pessoa: cargos, participações e trajetória de uma pessoa, buscada pelo nome e por uma empresa relacionada. · a partir do Plus | 15, com shareholdings + 5 |
| fetch_document | Um documento do registro: Aktueller Abdruck (AD, extrato atual), Chronologischer Abdruck (CD, extrato cronológico), Strukturierter Registerinhalt (SI, conteúdo estruturado do registro), Gesellschafterliste (lista de sócios) ou contrato social. | 15 |
Busca
As ferramentas de busca retornam até 30 resultados por página, cada um com seu entity_id. Seu agente então o usa para obter o perfil da empresa.
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| search_organizations | Encontrar empresas por nome ou filtros. | 1 por página |
| search_organizations_advanced | Busca com todos os filtros da API e ordenação, por exemplo por faturamento ou data de constituição. | 1 por página |
| find_companies_by_industry | Empresas de um setor, descrito em palavras ou como código WZ. | 1 por página |
| find_companies_by_financials | Empresas por faturamento, funcionários, lucro líquido, patrimônio líquido e outros indicadores. | 1 por página |
| find_companies_near | Empresas em torno de um local, as mais próximas primeiro. | 1 por página |
| find_newly_registered_companies | Empresas recém-registradas num período. | 1 por página |
| find_recently_changed_companies | Empresas com alterações recentes, por exemplo na administração, na sede ou no capital. | 1 por página |
| find_related_companies | Empresas ligadas por participações, cargos, fusões ou contratos de empresa. | 1 por página |
| find_companies_by_person | Empresas em que uma pessoa ocupa um cargo. A busca por sócio está disponível com Pro e Max. | 1 por página |
| find_companies_by_ownership | Empresas por estrutura de propriedade, por exemplo geridas pelo dono ou familiares. · Pro, Max | 1 por página |
| find_companies_by_management | Empresas por idade e tamanho da administração. · Pro, Max | 1 por página |
| find_companies_in_insolvency | Empresas em processo de insolvência, por fase e período. · Pro, Max | 1 por página |
| get_search_filter_reference | Os valores permitidos dos filtros de busca. | grátis |
| find_industry_codes | Códigos WZ para um setor descrito em palavras, por exemplo “desenvolvimento de software”. | grátis |
Signals
As ferramentas de Signals retornam alterações no registro em todas as empresas, até 20 por página. Uma página é cobrada mesmo quando está vazia.
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| get_recent_new_registrations | Novos registros. | 20 por página |
| get_recent_management_changes | Mudanças na administração. | 20 por página |
| get_recent_capital_changes | Alterações de capital. | 20 por página |
| get_recent_master_data_changes | Alterações de dados cadastrais como nome, sede ou endereço. | 20 por página |
| get_recent_company_closures | Encerramentos e dissoluções. | 20 por página |
| get_recent_insolvency_events | Insolvências. · Pro, Max | 20 por página |
| get_recent_mergers_and_transformations | Transformações & M&A. · Max | 20 por página |
| get_recent_company_changes | Todas as alterações de até cinco empresas específicas. | 20 por página |
| get_signal_details | Um único sinal com todos os detalhes. | 20 |
Custos
Cada chamada de ferramenta custa tantos créditos quanto a mesma requisição à API. Não há taxa separada para MCP. Os créditos são descontados da conta com que você entrou ou à qual a chave de API pertence.
Valem as mesmas regras da API: recursos sem dados não custam nada, e uma chamada que falha não custa nada. O Modo IA é cobrado mesmo sem correspondência; o Tempo real, a cada consulta ao vivo bem-sucedida. Todo resultado informa os créditos cobrados em meta.request_credit_cost e o seu saldo em meta.credits_remaining.
Os limites também são os mesmos da API, para documentos, por exemplo, 5 requisições por minuto. Mais em Cobrança e Limites.