Conecte a base de empresas e o CRM da Oportunidados ao Claude, Cursor ou ChatGPT pelo servidor MCP oficial. Login com a sua conta, sem token de API.
O que é o MCP da Oportunidados
O MCP (Model Context Protocol) é um padrão para conectar assistentes de IA a serviços externos. O servidor MCP oficial da Oportunidados leva a base de empresas e o CRM da sua conta para assistentes de IA. Você pede em linguagem natural e o assistente busca empresas, consulta um CNPJ ou registra um negócio no CRM.
Endereço do servidor:
https://mcp.oportunidados.com.br/mcpCole a URL completa, com /mcp no final.
Quem pode usar
Todos os planos pagos com assinatura ativa. Período de teste e conta sem pagamento confirmado recebem erro 403 ("Account is not active or payment is overdue"). Isso vale para os dados de empresas, para o filtro por IA e para o CRM.
Como funciona o login
- O acesso usa OAuth com a sua conta Oportunidados. Não é preciso token de API nem colar chave em lugar nenhum.
- Na primeira conexão aparece a tela de autorização do MCP da Oportunidados. Se você não estiver logado, o login da sua conta vem em seguida.
- Cada usuário conecta com o próprio login e acessa a conta e o CRM da própria empresa. Um registro de outra empresa não é encontrado.
Permissões
Na autorização, o cliente pede quatro permissões (scopes):
| Permissão | O que libera |
|---|---|
brazilian_companies_read | Buscar e consultar empresas e gerar filtro de busca. |
account_read | Ver a conta e o plano. |
crm_read | Ler o CRM. Só lê. |
crm_write | Criar, editar e excluir no CRM. Também lê. |
Uma conexão feita antes de a permissão crm_write existir continua lendo, mas recebe erro 403 ao tentar escrever no CRM. Remova o conector e conecte de novo para conceder a permissão.
Ferramentas disponíveis
São 24 ferramentas. O assistente escolhe qual usar conforme o seu pedido.
Empresas (4):
- Buscar empresas
- Consultar empresa por CNPJ
- Gerar filtro de empresas (transforma uma descrição em texto em filtro de busca)
- Ver códigos dos filtros de busca
Conta (1):
- Ver conta
CRM (19):
- Organizações: listar, criar, editar e excluir. Também criar ou atualizar organização por CNPJ.
- Contatos: listar, criar, editar e excluir.
- Pipelines: listar, criar, editar e excluir.
- Negócios: listar os negócios do pipeline, criar, editar e excluir. Também criar negócios em lote no pipeline a partir de CNPJs.
- Notas: adicionar nota no CRM.
Cota e limites
- Buscar empresas, consultar empresa por CNPJ e gerar filtro consomem a mesma cota mensal de chamadas da API do seu plano. O mês é o mês calendário e cada chamada conta 1.
- Esgotada a cota, as chamadas dessas ferramentas retornam erro 403 até o mês seguinte.
- As ferramentas do CRM, a de conta e a de códigos dos filtros não consomem cota.
- O filtro por IA tem limite próprio: 20 a cada 10 minutos e 100 por dia por empresa, somado ao uso do mesmo recurso no programa.
Para ver a cota do seu plano, veja limites e boas práticas da API.
O que a ficha da empresa traz
A consulta por CNPJ entrega os mesmos dados da ficha da API, descrita em dados retornados pela API, num JSON com nomes próprios (por exemplo, extra_contacts em vez de contatos_extras) e sem o bloco contexto, que só vem na API por token. A ficha inclui:
- Cadastro da empresa, com natureza jurídica, situação cadastral e datas
- CNAE principal e CNAEs secundários
- Endereço
- Telefones e e-mail da Receita Federal
- Contatos extras de todos os estabelecimentos da mesma raiz de CNPJ, mais os que a sua empresa cadastrou
- Faixa de faturamento, derivada do porte
- Regime tributário e o ano do regime
- Simples Nacional e MEI, com as datas de opção e de exclusão
- Sócios, com CPF mascarado ou nulo, nunca completo
- Número de funcionários, nos planos Black, Diamante, Enterprise e Expansão
A ficha não traz a lista de filiais.
Como conectar
Em todos os clientes, use a URL https://mcp.oportunidados.com.br/mcp, com /mcp no final, e faça login com a sua conta Oportunidados quando o cliente pedir.
Claude (web e app)
Contas Free, Pro e Max:
- Abra Customize > Connectors e clique em "Add custom connector".
- Cole a URL do servidor e clique em Add.
- Clique em Connect e faça login com a sua conta Oportunidados.
A conta Free aceita no máximo 1 conector personalizado.
Contas Team e Enterprise: o Owner adiciona o conector em Organization settings > Connectors > Add > Custom. Depois, cada membro vai em Customize > Connectors e clica em Connect.
Em cada conversa, ligue ou desligue o conector em "+" > Connectors.
Claude Code
No terminal, adicione o servidor:
claude mcp add --transport http oportunidados https://mcp.oportunidados.com.br/mcpPara valer em todos os projetos, acrescente --scope user. Depois, dentro do Claude Code, digite /mcp, escolha oportunidados e faça login no navegador.
Cursor
Adicione o servidor ao arquivo ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (só o projeto atual):
{
"mcpServers": {
"oportunidados": {
"url": "https://mcp.oportunidados.com.br/mcp"
}
}
}O Cursor aceita OAuth em servidores remotos. Na primeira vez, ele pede o login com a sua conta Oportunidados.
ChatGPT
O ChatGPT conecta servidores MCP pelo Developer mode, um recurso em beta que só existe na versão web.
- Business, Enterprise e Edu: MCP completo, com leitura e escrita. Nesses planos quem cria e publica o app é o administrador ou o owner do workspace. No Enterprise e no Edu, o administrador libera o recurso em Permissions & Roles.
- Pro: só leitura e busca no Developer mode.
Passos para uma conta individual:
- Em Settings > Security and login, ligue o Developer mode.
- Abra chatgpt.com/plugins, clique em "+" e crie um app.
- Em Connection, informe a URL
https://mcp.oportunidados.com.br/mcpe escolha autenticação OAuth. - Conclua o login com a sua conta Oportunidados e clique em Create.
- Em cada conversa, escolha o app no menu "+".
Por padrão, o ChatGPT pede confirmação antes de ações de escrita, como criar ou excluir registros no CRM. Leia a confirmação antes de aprovar.
Desconectar e segurança
- Para desconectar, remova o conector no seu cliente de IA.
- Para revogar o acesso de todos os usuários da empresa, fale com o suporte.
- Nunca coloque token ou senha na URL do conector. O login acontece na tela de autorização, não na URL.
- Ações de escrita mudam dados reais do CRM. No ChatGPT elas pedem confirmação por padrão, e a revisão antes de aprovar é sua.
