Conecte o Base Empresarial à sua IA

O que é o MCP

MCP é a sigla de Model Context Protocol, um padrão que permite conectar assistentes de IA a ferramentas e fontes de dados. Com o MCP do Base Empresarial, seu assistente pode consultar dados de empresas durante a conversa, sem que você precise copiar cada resultado do site.

Por exemplo: você pode pesquisar empresas de uma atividade em Fortaleza, abrir uma busca salva e pedir ao assistente que organize os resultados em uma tabela. Se também fornecer uma planilha sua, ele pode comparar os dois conjuntos dentro da conversa.

Os dados cadastrais vêm da base pública da Receita Federal. As análises e conclusões são produzidas pelo assistente. Confira os dados usados e a cobertura dos resultados antes de tomar decisões.

O que você pode fazer

Com a autorização padrão de leitura, seu assistente pode:

• Consultar uma empresa pelo CNPJ.
• Pesquisar empresas usando os filtros disponíveis no Base Empresarial.
• Listar suas buscas salvas e consultar os filtros de cada uma.
• Executar uma busca salva e percorrer seus resultados em páginas.

Você pode preparar um recorte no site e encontrá-lo em suas buscas salvas antes de continuar a análise no assistente. Também é possível criar, renomear e excluir buscas pelo MCP, mas essas ações exigem permissões adicionais.

Para exportar resultados de buscas pessoais, use a área de exportações. Pesquisas na web e enriquecimento com outras fontes dependem das ferramentas do seu assistente; não são dados fornecidos pelo MCP do Base Empresarial.

Antes de começar

Você precisa de uma conta no Base Empresarial, com o e-mail verificado, e de um cliente compatível com MCP remoto por HTTP e autenticação OAuth. Os passos abaixo atendem ao Claude Code e ao Codex CLI instalados no seu computador.

O login acontece no navegador, com a mesma conta usada no site. Você revisa a autorização antes de conceder acesso. Não é necessário criar um token de API para conectar por OAuth.

Acesse sua conta para verificar suas conexões.

Como conectar

O endereço do servidor MCP é:

https://app.baseempresarial.com.br/mcp

Esse endereço é usado na configuração do assistente. A página que você está lendo é o guia público; o servidor exige autenticação para responder às consultas.

Claude Code

No terminal, adicione o servidor e inicie o login:

claude mcp add --transport http baseempresarial https://app.baseempresarial.com.br/mcp
claude mcp login baseempresarial

No navegador, entre na sua conta, confira as permissões e autorize. Depois, abra o Claude Code e use /mcp para conferir o estado da conexão. Se a sessão já estava aberta, reconecte o servidor para atualizar as ferramentas disponíveis. Se você já adicionou o servidor, execute apenas o comando de login.

Você também pode iniciar a autorização pelo menu /mcp dentro do Claude Code. Veja a documentação de MCP do Claude Code para opções do cliente.

Codex

No terminal, adicione o servidor e inicie o login:

codex mcp add baseempresarial --url https://app.baseempresarial.com.br/mcp
codex mcp login baseempresarial

Conclua a autorização no navegador e abra uma nova sessão do Codex para usar as ferramentas. Se você já adicionou o servidor, execute apenas o comando de login. Veja também a documentação de MCP do Codex.

Outros clientes

Na configuração de servidores MCP do seu cliente, escolha uma conexão remota por HTTP (Streamable HTTP), informe o endereço acima e siga o fluxo de OAuth. Os nomes das opções variam entre aplicativos. O cliente precisa oferecer suporte a esse transporte e à autorização pelo navegador.

Experimente na conversa

Depois de conectar, comece com um pedido pequeno:

Quais buscas salvas tenho no Base Empresarial? Mostre o nome e os filtros de cada uma.

Para consultar um cadastro, substitua o campo entre colchetes pelo CNPJ desejado:

Consulte o CNPJ [CNPJ da empresa] no Base Empresarial e resuma a situação cadastral, a atividade principal e o município.

Para uma pesquisa:

Pesquise empresas ativas de desenvolvimento de software em Fortaleza. Mostre a primeira página de resultados em uma tabela com CNPJ, nome e município.

Para continuar um trabalho que você já preparou no site:

Abra minha busca salva [nome da busca] e organize os resultados por município. Informe quantas páginas você consultou e se ainda há resultados pendentes.

Os resultados são paginados. Uma página de empresas não representa necessariamente o recorte inteiro: peça ao assistente que deixe claro o que consultou antes de apresentar totais ou comparações.

Permissões e controle de acesso

A conexão padrão permite leitura. As buscas pessoais acessíveis são as da conta que autorizou a conexão. As consultas seguem as mesmas regras de privacidade e os limites aplicáveis aos dados no Base Empresarial.

Criar, renomear e excluir buscas exige, respectivamente, as permissões create, update e delete. Solicite apenas o necessário. Por exemplo, no Codex, para acrescentar a criação de buscas à leitura:

codex mcp login baseempresarial --scopes mcp:use,create

Revise a nova autorização no navegador e reconecte o cliente. Antes de excluir uma busca, confira qual busca será removida e peça ao assistente que aguarde sua confirmação.

Rotinas administrativas

Administradores podem autorizar as consultas e ações disponíveis no painel: atender mensagens, registrar observações, atualizar status, responder solicitações, preparar remoções, administrar modelos, exportar registros e operar o cache. Na autorização, use Incluir consultas administrativas para leitura ou Escolher ações administrativas para selecionar as operações necessárias. Tokens já emitidos conservam suas permissões; refaça o login e reconecte para usar uma autorização ampliada.

Exemplos para uma conta autorizada:

Para estes CNPJs, registre a remoção total das páginas.

Para estes CNPJs, remova apenas as páginas de sócios.

O assistente prepara a lista, consulta os dados e o impacto e executa a seleção autorizada. A remoção somente de sócios preserva a página da empresa e oculta os dados identificadores dos sócios e suas páginas, como no painel. Filiais e envio de notificações dependem de um pedido explícito. Se a prévia indicar um impacto maior que o solicitado, o assistente deve pedir esclarecimento.

Operações em lote mostram o resultado por item; acompanhe a conclusão e eventuais falhas. Alterações permanecem auditáveis e respeitam as permissões da sua conta. Documentos, anexos e exportações administrativas usam links temporários e privados.

Alternativa com token pessoal

Se o seu cliente usa token Bearer em vez de OAuth, crie um token em Tokens de API com apenas as permissões necessárias. No Codex, você pode indicar uma variável de ambiente que já contenha o token:

codex mcp add baseempresarial-token --url https://app.baseempresarial.com.br/mcp --bearer-token-env-var BASE_EMPRESARIAL_TOKEN

Configure BASE_EMPRESARIAL_TOKEN no ambiente em que o Codex será iniciado. Não cole o token na conversa nem em arquivos compartilhados. Essa é uma alternativa à conexão OAuth; não é preciso configurar as duas.

Como desconectar

Abra Tokens de API → Conexões MCP, localize o aplicativo e clique em Revogar. A conexão perde o acesso e não pode renovar a autorização. Para voltar a usar, faça um novo login pelo cliente.

Se você conectou com um token pessoal, revogue esse token na seção de tokens da mesma página. Os dados já obtidos pelo assistente não são apagados pela revogação.

Se algo não funcionar

• O navegador não abriu: copie a URL de autorização exibida pelo cliente e abra no navegador. Conclua o retorno seguindo as instruções do terminal.
• O cliente pede autenticação novamente: refaça o comando de login. A autorização pode ter expirado ou sido revogada.
• O acesso foi negado: verifique seu e-mail no site e confira as permissões autorizadas para a operação.
• Uma ferramenta não aparece: conexões de leitura não incluem criação, edição ou exclusão. Após autorizar novas permissões, reconecte o servidor ou abra uma nova sessão do cliente.
• O limite de uso foi atingido: aguarde o período indicado na resposta e reduza a frequência das consultas.

Se precisar de ajuda, fale com o Base Empresarial. Informe o cliente utilizado e a mensagem de erro, sem enviar senhas ou tokens.