Servidor MCP

O Captário dentro do seu assistente de IA.

Conecte o Captário ao Claude, ao ChatGPT ou ao seu editor colando um endereço e entrando com a sua conta, sem chave para copiar. O assistente busca sinais de compra, abre fichas, cria alertas e exporta listas, sempre com o link do registro oficial, e nunca mostra mais do que a página do seu plano mostraria.

Assinar o Pro Planos Pro e Equipe

Disponível nos planos Pro e Equipe.

O endereço

É o único dado que o app pede. O login acontece na sua conta do Captário, e você vê o nome do app e o que ele vai poder fazer antes de permitir.

Endereço: https://captario.com.br/api/mcp
Transporte: Streamable HTTP
Autenticação: OAuth 2.1 com login na sua conta (ou chave de API no cabeçalho Authorization)

As ferramentas

Ferramenta	O que faz	Tipo
Buscar sinais buscar_sinais	Empresas com sinal de compra recente nas fontes oficiais (licitação homologada, contrato assinado, contrato perto do fim, sanção CEIS/CNEP). Cada resultado traz a data, o valor, o órgão e o link da fonte oficial. Conta na cota mensal de linhas do plano.	Leitura
Ficha da empresa ficha_empresa	Cadastro público da empresa (Receita), compras públicas dos últimos 12 meses, sócios (só nome e qualificação), contato cadastrado conforme o plano e os sinais recentes com links.	Leitura
Criar alerta criar_alerta	Cria um alerta por e-mail na conta do usuário com estes filtros. Peça confirmação ao usuário antes de chamar.	Altera a conta
Buscar empresas na base completa buscar_empresas	Empresas ativas do Brasil inteiro pelo cadastro da Receita (não só as que têm sinal): filtre por atividade (CNAE), UF, município (IBGE), porte, abertura, capital social, Simples e contato informado. Traz telefone e e-mail cadastrados quando o plano mostra (nunca de MEI). Conta na cota mensal de linhas.	Leitura
Exportar lista exportar_lista	Lista de até 200 sinais com os filtros, no formato de exportação (inclui telefone e e-mail cadastrados quando o plano mostra). Conta na cota mensal de linhas.	Leitura

Exemplos de pergunta

Quem ganhou licitação de obra em Goiás nesta semana, acima de R$ 1 milhão?
Quais contratos de limpeza com prefeituras de MG terminam nos próximos 90 dias?
Abra a ficha do CNPJ 00.000.000/0001-91 e diga se há sanção.
Crie um alerta diário para construtoras de SP que vencerem pregão.

Como conectar

Os nomes dos menus mudam de vez em quando em cada app; o caminho é este.

Claude (claude.ai e Claude Desktop)

Abra Configurações › Conectores › Adicionar conector personalizado.
Nome: Captário. URL: https://captario.com.br/api/mcp. Adicione.
Clique em Conectar, entre com a sua conta do Captário e clique em Permitir.
Numa conversa, ligue o Captário no menu de ferramentas e pergunte.

ChatGPT

Em Configurações › Apps e conectores › Configurações avançadas, ligue o modo desenvolvedor.
Volte a Apps e conectores e crie um conector: nome Captário, o endereço acima e autenticação OAuth.
Entre com a sua conta do Captário e clique em Permitir.
Numa conversa, escolha o Captário nas ferramentas.

Claude Code

claude mcp add --transport http captario https://captario.com.br/api/mcp

Depois, dentro do Claude Code, rode /mcp, escolha o captario e faça o login: o navegador abre na tela de permissão do Captário.

VS Code

Pelo comando MCP: Add Server (servidor HTTP, com o endereço) ou no arquivo .vscode/mcp.json. Na primeira chamada, o VS Code abre o login no navegador.

{
  "servers": {
    "captario": { "type": "http", "url": "https://captario.com.br/api/mcp" }
  }
}

Cursor

No Cursor, use a chave de API (crie uma completa em Integrações) no arquivo ~/.cursor/mcp.json:

{
  "mcpServers": {
    "captario": {
      "url": "https://captario.com.br/api/mcp",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

O mesmo cabeçalho serve para qualquer outro cliente MCP que não faça login por OAuth.

Plano e limites

Planos Pro e Equipe. Sem um deles, a tela de login mostra o que falta e o app não recebe acesso.
Membro de conta Equipe usa o plano do titular, com os filtros, os alertas e a cota da conta.
As linhas entregues contam na cota mensal de exportação, a mesma do CSV e da API.
Até 120 chamadas por minuto por conta.

Privacidade

Nenhuma ferramenta mostra CPF.
MEI e pessoa física ficam de fora: nunca saem com o nome da pessoa nem com contato.
Telefone e e-mail cadastrados só aparecem se o seu plano os mostra no site.
O que o app recebe passa a ser tratado também pela empresa dele, conforme os termos dela. Veja a política de privacidade.

Perguntas frequentes

O que é o MCP do Captário?

É o servidor do Captário no Model Context Protocol, o padrão que os assistentes de IA usam para chamar ferramentas externas. Conectado, o Claude, o ChatGPT ou o seu editor buscam sinais de compra, abrem a ficha de uma empresa, criam alertas e exportam listas na sua conta, e cada resposta traz o link do registro oficial.

Preciso copiar uma chave de API?

Não. Cole o endereço https://captario.com.br/api/mcp no app, entre com a sua conta do Captário e clique em Permitir. A chave de API continua existindo para clientes que não fazem login por OAuth, como o Cursor, e para a API REST.

Qual plano preciso ter?

Pro ou Equipe. Quem é membro de uma conta Equipe usa o plano do titular. As linhas entregues pelo MCP contam na mesma cota mensal da exportação em CSV, e o limite é de 120 chamadas por minuto por conta.

O assistente vê CPF ou dados de pessoa física?

Não. Nenhuma ferramenta devolve CPF, e sócios aparecem só com nome e qualificação. MEI e empresa de pessoa física ficam de fora: nunca saem com o nome da pessoa nem com telefone ou e-mail, e nos sinais o MEI nem entra na lista. O contato cadastrado das demais empresas só aparece se o seu plano o mostra no site.

Como desconecto um app?

Em Integrações › Apps conectados, clique em Revogar. O acesso para na hora e o app passa a pedir login de novo. Cada consentimento e cada revogação ficam registrados.

O que fica registrado?

Cada chamada fica no histórico da sua conta: a ferramenta, os filtros, quantos resultados voltaram e se deu certo. O Captário recebe só os pedidos das ferramentas, não a conversa com o assistente.

Para desenvolvedores

JSON-RPC 2.0 por HTTP (Streamable HTTP, respostas JSON), sem sessão. OAuth 2.1 com PKCE (S256) obrigatório, registro dinâmico de cliente (RFC 7591), token amarrado ao recurso (RFC 8707), refresh com rotação e revogação (RFC 7009). Sem credencial, o servidor responde 401 com WWW-Authenticate apontando o metadata do recurso.

https://captario.com.br/.well-known/oauth-protected-resource/api/mcp
https://captario.com.br/.well-known/oauth-authorization-server

A mesma base está na API REST. Dúvidas: [email protected].