BitBusca › Desenvolvedores › Conectores de IA

A BitBusca dentro da sua IA: pergunte em português, receba o dado oficial

Conecte o Claude, o ChatGPT, o Cursor, o VS Code, o Gemini ou o Copilot Studio às bases da BitBusca. A IA consulta CNPJ, publicações do DJEN, prazos e editais por você, com a sua chave, o seu saldo e os seus limites.

Pegar chave de teste grátis — sem cartão. Planos a partir de R$ 19,90/mês.

A BitBusca ainda não está nos diretórios de conectores dessas plataformas: hoje você conecta manualmente, colando a URL e a sua chave.

Dois endereços

Perfil Completo (no ar)

Ferramentas de desenvolvedor em que você cola a sua própria chave: Claude Code, Cursor, VS Code, Gemini CLI, Windsurf, n8n.

https://api.bitbusca.net/api/v1/mcp

• Empresas por CNPJ e em lista, endereço por CEP
• DJEN: publicações, processo, prazos e monitores
• Licitações: editais, leitura, análise e alertas
• Advogados por OAB e por nome
• Imóveis (cobertura parcial: só as cidades atendidas)
• Pessoa física (CPF, nome, telefone), veículo e leads de pessoas

Dado de pessoa física só com finalidade legítima (LGPD). Consultas em sequência pausam a chave.

Perfil Empresas (em preparação)

Assistentes de conversa, como Claude e ChatGPT, em que o dado de pessoa física não deve circular.

https://api.bitbusca.net/api/v1/mcp/empresas

• Empresas por CNPJ e em lista, endereço por CEP
• DJEN: publicações, processo, prazos e monitores
• Licitações: editais, leitura, análise e alertas
• Advogado pela inscrição na OAB
• Imóveis sem dado do proprietário (cobertura parcial)
• Saldo da conta

Fora deste perfil:

• CPF, nome e telefone de pessoa
• Placa e motor
• Leads de pessoas
• Lista de advogados por nome

Em preparação. Até entrar no ar, use o endereço Completo com uma chave que só tenha os escopos de empresa, jurídico, licitações, advogados, imóveis e conta.

Passo a passo

Claude

Conversa · conecte manualmente pela URL. Conector personalizado no claude.ai (vale também no app de desktop). Funciona do plano Free (1 conector personalizado) ao Enterprise.

1. Pro ou Max: Customize → Connectors → + Add → Add custom connector. Team ou Enterprise: Organization settings → Connectors → Add → Custom → Web (só o Owner).
2. Nome: BitBusca. URL: o endereço do servidor MCP abaixo.
3. Autenticação: "No sign in". Em "Request headers", adicione o cabeçalho com a sua chave.
4. Se o seu plano não mostrar o campo de cabeçalho, use a URL com a chave e deixe sem cabeçalho.
5. Numa conversa, ligue o conector BitBusca no menu de ferramentas e peça: "Qual é o meu saldo na BitBusca?"

URL do servidor:

https://api.bitbusca.net/api/v1/mcp

Request header:

Authorization: Bearer SUA_CHAVE

URL com a chave (sem cabeçalho):

https://api.bitbusca.net/api/v1/mcp?token=SUA_CHAVE

A chave na URL vale como senha: use uma chave só para isso, com teto diário, e gire-a se a URL vazar.

Claude Code (terminal)

1. Rode o comando abaixo; --scope user vale em todos os projetos.
2. Confira com /mcp dentro do Claude Code.

claude mcp add --transport http bitbusca https://api.bitbusca.net/api/v1/mcp --header "Authorization: Bearer SUA_CHAVE" --scope user

ChatGPT

Conversa · conecte manualmente pela URL. Pelo modo desenvolvedor, que aceita servidor MCP personalizado. Como o ChatGPT não tem campo de cabeçalho, a chave vai na URL.

1. Settings → Apps → Advanced settings → ligue o Developer mode. Nas versões novas: chatgpt.com/plugins → + → Add custom MCP server. Se a opção não aparecer, o seu plano ou espaço de trabalho ainda não a libera.
2. Crie o conector com a URL abaixo (troque SUA_CHAVE pela sua chave).
3. Autenticação: "No authentication".
4. Na conversa, escolha o conector BitBusca e faça o pedido.

URL com a chave:

https://api.bitbusca.net/api/v1/mcp?token=SUA_CHAVE

Use uma chave separada, só com os escopos que a conversa precisa e com teto diário de créditos.

Cursor

Editor de código · conecte manualmente pela URL. Um arquivo de configuração no projeto ou na sua pasta de usuário. A chave fica numa variável de ambiente, fora do git.

1. Crie .cursor/mcp.json no projeto (ou ~/.cursor/mcp.json para todos os projetos) com o bloco abaixo.
2. Defina a variável de ambiente BITBUSCA_API_KEY com a sua chave.
3. Reinicie o Cursor e confira as ferramentas da BitBusca em Settings → MCP.

.cursor/mcp.json:

{
  "mcpServers": {
    "bitbusca": {
      "url": "https://api.bitbusca.net/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BITBUSCA_API_KEY}"
      }
    }
  }
}

VS Code (GitHub Copilot)

Editor de código · conecte manualmente pela URL. O VS Code pede a chave na primeira vez e a guarda como segredo. As ferramentas aparecem no chat do Copilot em modo Agent.

1. Crie .vscode/mcp.json no projeto com o bloco abaixo.
2. Clique em Start sobre o servidor bitbusca e cole a sua chave quando o VS Code pedir.
3. No chat do Copilot, escolha o modo Agent: as ferramentas da BitBusca entram na lista.

.vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "bitbusca-key",
      "description": "Chave da BitBusca",
      "password": true
    }
  ],
  "servers": {
    "bitbusca": {
      "type": "http",
      "url": "https://api.bitbusca.net/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:bitbusca-key}"
      }
    }
  }
}

Gemini CLI

Terminal · conecte manualmente pela URL. O Gemini no terminal lê servidores MCP do arquivo de configuração. A chave sai de uma variável de ambiente.

1. Abra ~/.gemini/settings.json (ou .gemini/settings.json no projeto) e junte o bloco abaixo.
2. Defina a variável de ambiente BITBUSCA_API_KEY com a sua chave.
3. Abra o Gemini CLI e rode /mcp para ver as ferramentas da BitBusca.

settings.json:

{
  "mcpServers": {
    "bitbusca": {
      "httpUrl": "https://api.bitbusca.net/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${BITBUSCA_API_KEY}"
      },
      "timeout": 60000
    }
  }
}

Este passo a passo é do Gemini no terminal. O app Gemini de conversa ainda não aceita conector com chave.

Microsoft Copilot Studio

Agentes corporativos · conecte manualmente pela URL. Para o agente da sua empresa no Microsoft 365: a BitBusca entra como ferramenta MCP, com a chave num cabeçalho.

1. Abra o agente → Tools (Ferramentas) → Add a tool → New tool → Model Context Protocol.
2. Nome: BitBusca. Descrição: "Empresas, publicações do DJEN, prazos e licitações do Brasil". URL: o endereço do servidor.
3. Authentication: API key → tipo Header → nome do cabeçalho Authorization.
4. Crie a conexão colando "Bearer SUA_CHAVE" como valor e adicione a ferramenta ao agente.

URL do servidor:

https://api.bitbusca.net/api/v1/mcp

Valor do cabeçalho Authorization:

Bearer SUA_CHAVE

A Microsoft muda os nomes dos menus com frequência; se algo estiver diferente, procure por "Model Context Protocol" ao adicionar ferramenta.

O que pedir

• “Qual é a situação cadastral do CNPJ 00.000.000/0001-91 e quem são os sócios?” (consultar_cnpj)
• “Liste empresas de tecnologia (CNAE 6201-5/01) abertas este mês em Campo Grande/MS.” (buscar_empresas)
• “Tem publicação nova no DJEN para a OAB MS 12345 nos últimos 7 dias? Resuma cada uma.” (buscar_publicacoes_djen)
• “Uma intimação saiu em 20/10/2026 no TJMS com prazo de 15 dias úteis. Até quando vai o prazo?” (calcular_prazo)
• “Quais editais de merenda escolar abertos em MS encerram nos próximos 10 dias?” (buscar_editais)
• “Leia este edital e me diga os itens, o valor estimado e os documentos de habilitação.” (ler_edital)
• “Crie um alerta de licitação para "material de limpeza" em MS e MT.” (criar_alerta_licitacao)
• “Quais cidades têm cadastro de imóveis na BitBusca?” (cidades_imovel)
• “Quanto custa o Bitinho resumir este edital? Se for até 1 crédito, pode executar.” (resumo_edital)
• “Qual é o meu saldo de créditos na BitBusca?” (meu_saldo)

Para quem programa

• “Use a ferramenta consultar_cnpj com a chave de teste e gere o tipo TypeScript da resposta.” (consultar_cnpj)
• “Monte uma tela que lista os editais abertos de MS com valor acima de R$ 100 mil, chamando a API pelo back-end.” (buscar_editais)
• “Crie um monitor do DJEN para a OAB do meu cliente e um webhook que avise o meu sistema.” (criar_monitor_djen)

Perguntas frequentes

A BitBusca já está no diretório de conectores do Claude ou do ChatGPT?

Ainda não. Hoje você conecta manualmente, colando a URL do servidor MCP e a sua chave, como mostra esta página. Quando um diretório aprovar a BitBusca, avisaremos aqui.

Preciso pagar a plataforma de IA para usar a BitBusca?

A BitBusca não cobra nada pela plataforma de IA. Você usa os créditos da sua conta BitBusca; cada ferramenta informa o custo antes de rodar e consulta sem resultado não é cobrada. Cada plataforma de IA tem os próprios planos e regras para conectores personalizados.

A BitBusca lê a minha conversa com a IA?

Não. A BitBusca só recebe a chamada da ferramenta que a IA decidiu usar, com os argumentos dela (por exemplo, o CNPJ). O resto da conversa fica com a plataforma de IA. Detalhes na Privacidade da API.

Como evito gasto inesperado se a IA chamar muitas ferramentas?

Crie uma chave só para a IA, com os escopos que ela precisa e um teto diário de créditos. Se passar do teto, a ferramenta para de responder até o dia seguinte. Para montar e testar, use a chave de teste: devolve dados fictícios e não gasta nada.

Qual endereço eu uso: Completo ou Empresas?

Em ferramentas de desenvolvedor, o Completo. Em assistentes de conversa, o Empresas, que não tem dado de pessoa física — ele está em preparação; até lá, use o Completo com uma chave sem o escopo de consultas de pessoa.

Funciona com imóveis de qualquer cidade?

Não. O cadastro de imóveis tem cobertura parcial: só as cidades atendidas, que a própria ferramenta lista. Outras em breve.

Desenvolvedores · Conectores de IA · Privacidade da API · Termos da API · Privacidade geral · Suporte