MCP da Oportunidados

O que é

O MCP (Model Context Protocol) é um padrão para conectar assistentes de IA a serviços externos. O endereço do servidor da Oportunidados é este, com /mcp no final:

https://mcp.oportunidados.com.br/mcp

O servidor usa HTTP com streaming e só aceita login por OAuth.

Quem pode usar

O MCP funciona nos planos pagos com assinatura ativa, sem custo à parte. Período de teste e conta sem pagamento confirmado recebem erro 403 com a mensagem Account is not active or payment is overdue, também nas ferramentas de CRM.

Login

• O acesso usa OAuth com a sua conta Oportunidados. Não há token de API nem chave para colar.
• Na primeira conexão aparece a tela de autorização do MCP da Oportunidados. Se você não estiver logado, o login vem em seguida.
• Cada usuário conecta com o próprio login e acessa a conta e o CRM da própria empresa. Registro de outra empresa não é encontrado.

Permissões

Na autorização, o assistente pede quatro permissões:

Uma conexão feita antes de a permissão crm_write existir continua lendo, mas recebe 403 ao tentar escrever no CRM. Remova o conector e conecte de novo para conceder a permissão.

Ferramentas

São 24 ferramentas. O assistente escolhe qual usar conforme o seu pedido.

Empresas

• Buscar empresas com filtros: search_brazilian_companies
• Consultar uma empresa por CNPJ: get_brazilian_company
• Gerar filtro de busca a partir de uma descrição em texto: generate_brazilian_companies_filter
• Ver os códigos dos filtros de busca: get_search_metadata

O filtro por número de funcionários vale nos planos Prata, Ouro, Diamante e Black. Nos outros, a busca com esse filtro recebe 403 filter_not_in_plan.

Conta

• Ver a conta e o plano: get_account

CRM

• Organizações: listar, criar, editar, excluir e criar ou atualizar por CNPJ (upsert_crm_organization_by_cnpj).
• Contatos: listar, criar, editar e excluir.
• Pipelines: listar, criar, editar e excluir.
• Negócios: listar os do pipeline, criar, editar, excluir e criar em lote a partir de CNPJs (bulk_create_crm_items_from_list).
• Notas: adicionar uma nota (create_crm_note).

Cota e limites

• Buscar empresas, consultar uma empresa por CNPJ e gerar filtro usam a mesma cota mensal de chamadas da API do seu plano. Cada chamada dessas ferramentas conta 1, no mês calendário. Esgotada a cota, elas recebem 403 Monthly Quota Exceeded até o mês seguinte.
• As ferramentas de CRM, a de conta e a de códigos dos filtros não usam cota.
• O filtro por IA tem dois limites próprios por empresa, somados ao uso do mesmo recurso na plataforma: um curto, de alguns minutos, e um diário. Passou do curto, espere alguns minutos; esgotou o diário, espere o dia seguinte.

A cota de cada plano está em Cota e limites.

Garantia por ferramenta

Encerram a garantia da primeira assinatura:

• buscar empresas;
• consultar uma empresa por CNPJ.

Fazer isso nos primeiros 8 dias encerra a garantia da primeira assinatura. Ver regra

Não encerram:

• gerar filtro;
• ver os códigos dos filtros;
• ver a conta;
• todas as ferramentas de CRM.

O que a ficha traz

A consulta por CNPJ entrega quase os mesmos campos da ficha da API, descrita em Campos da ficha. O JSON tem as chaves company, socios e extra_contacts (no lugar de contatos_extras) e não traz o bloco contexto, que só vem na API por token. Os sócios vêm com CPF mascarado ou nulo, nunca completo, e a ficha não traz a lista de filiais.

Como conectar

Em todos os assistentes, use a URL https://mcp.oportunidados.com.br/mcp e faça login com a sua conta Oportunidados quando ele pedir. Menus, planos e limites dos assistentes mudam com o tempo: confira na versão do seu.

Claude

Contas Free, Pro e Max, na web e no app:

1. Abra Customize › Connectors e clique em Add custom connector.
2. Cole a URL do servidor e clique em Add.
3. Clique em Connect e faça login com a sua conta Oportunidados.

A conta Free aceita um conector personalizado. Em Team e Enterprise, o Owner adiciona o conector em Organization settings › Connectors › Add › Custom, e depois cada membro clica em Connect em Customize › Connectors. Em cada conversa, ligue ou desligue o conector no menu "+".

Claude Code

No terminal:

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

Para 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 em ~/.cursor/mcp.json (todos os projetos) ou em .cursor/mcp.json (só o projeto atual):

{
  "mcpServers": {
    "oportunidados": {
      "url": "https://mcp.oportunidados.com.br/mcp"
    }
  }
}

Na primeira vez, o Cursor pede o login com a sua conta Oportunidados.

ChatGPT

O ChatGPT conecta servidores MCP pelo Developer mode, na versão web.

1. Em Settings › Security and login, ligue o Developer mode.
2. Abra chatgpt.com/plugins, clique em "+" e crie um app.
3. Em Connection, informe a URL do servidor e escolha autenticação OAuth.
4. Conclua o login com a sua conta Oportunidados e clique em Create.
5. Em cada conversa, escolha o app no menu "+".

Nos planos Business, Enterprise e Edu, quem cria e publica o app é o administrador do workspace. No Pro, o Developer mode faz só leitura e busca. No Plus e no Free, conte com leitura e busca. Por padrão, o ChatGPT pede confirmação antes de ações de escrita no CRM: leia antes de aprovar.

Desconectar e segurança

• Para revogar o seu acesso, remova o conector no seu assistente de IA.
• Para revogar o acesso de toda a empresa, fale com o suporte.
• Nunca coloque token ou senha na URL do conector. O login acontece na tela de autorização.
• Ações de escrita mudam dados reais do CRM. A revisão antes de aprovar é sua.