Conectar o Nectar a uma IA externa (MCP)

O conector MCP deixa você consultar o Nectar direto do Claude, do ChatGPT, do Cursor e de outros assistentes de IA compatíveis com MCP. Você pergunta em linguagem natural, como "Quais oportunidades abertas fecham ainda este mês?", e o assistente busca a resposta nos dados do seu CRM, sem você sair da conversa.

Onde fica

1. No menu do seu perfil, na seção "Conta", clique em "Central de Integrações".
2. A tela abre direto na aba "IA". Para voltar a ela de outra aba, clique em "IA".

No topo da aba ficam as três garantias do conector:

• "Somente leitura": a IA consulta; não cria, altera nem exclui.
• "Suas permissões": equipes e carteiras valem igual à tela. A IA só enxerga o que você já enxerga no Nectar.
• "Revogável": você desconecta a qualquer momento, na própria aba.

O que a IA externa pode ler e fazer

O bloco "O que a IA pode ler" lista as áreas liberadas:

• Contatos e empresas
• Oportunidades
• Tarefas
• Funis e etapas
• Campos personalizados
• Nomes dos usuários

Nada é gravado pela IA. Registros fora da sua equipe ou da sua carteira não aparecem, como na tela.

Em "O que você pode perguntar", a tela mostra as 7 ferramentas, todas de leitura, com uma pergunta de exemplo:

• "Oportunidades": "Quais negócios abertos fecham este mês?"
• "Tarefas": "O que está atrasado para mim?"
• "Contatos": "Ache a empresa com este CNPJ."
• "Funis": "Quais são as etapas do funil comercial?"
• "Campos personalizados": "Filtre pelo campo Segmento = Varejo."
• "Usuários": "Mostre as tarefas da Ana."
• "Quem sou eu": "Com qual usuário você está conectado?"

Conectar a sua IA

No bloco "Conectar sua IA", escolha primeiro como a IA vai falar com o Nectar:

• "Conector na nuvem" (Login pelo Nectar, recomendado): você cadastra o endereço do Nectar no assistente e entra com o seu usuário.
• "No seu computador" (Com login pelo navegador): o conector roda na sua máquina.

No "Conector na nuvem", escolha o assistente: "Claude (web e app)", "Claude Code", "ChatGPT", "Cursor" ou "Outros assistentes". Todos usam o "Endereço do conector", https://mcp.nectarcrm.com.br/mcp, que você copia pelo botão "Copiar".

Claude (web e app)

1. No Claude, abra "Configurações › Conectores" e clique em "Adicionar conector personalizado". Em planos Team e Enterprise, quem faz isso é o administrador da organização.
2. Dê o nome "Nectar" e cole o endereço do conector.
3. Em "Configurações avançadas", marque "Use seu próprio cliente OAuth", informe o Client ID ncrm_mcp e deixe o segredo em branco. Clique em "Adicionar".
4. Clique em "Vincular". O Nectar abre: entre com o seu usuário e autorize. Numa conversa, ligue o Nectar no menu de ferramentas. A conexão passa a aparecer em "Conexões autorizadas".

Clique em "Abrir guia" no cartão "Primeira vez? Veja o passo a passo com imagens" para ver o passo a passo ilustrado. Para voltar, clique em "Integrações › IA", no topo do guia. O guia traz o quadro "Claude Team e Enterprise": um proprietário da organização adiciona o Nectar uma vez, em "Configurações da organização › Conectores", e cada pessoa só clica em "Vincular" com o próprio login do Nectar.

Claude Code

No terminal, adicione o conector com o comando que a tela mostra (botão "Copiar comando"):

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

Depois, dentro do Claude Code, rode /mcp e escolha "Autenticar": o Nectar abre no navegador para você autorizar. Para rodar o servidor do Nectar no seu computador, use a opção "No seu computador".

ChatGPT

Disponível no ChatGPT web nos planos Plus, Pro, Business, Enterprise e Edu. Em Business, Enterprise e Edu, o administrador do workspace precisa liberar o "Modo desenvolvedor".

1. No ChatGPT, abra "Configurações" e ative o "Modo desenvolvedor", em "Aplicativos › Configurações avançadas".
2. Clique em "Criar app". Dê o nome "Nectar" e cole o endereço do conector em "URL do servidor MCP".
3. Em "Autenticação", escolha "OAuth". Nas configurações avançadas de OAuth, informe o Client ID ncrm_mcp e deixe o segredo em branco. Confirme que confia no app e clique em "Criar".
4. O Nectar abre: entre com o seu usuário e autorize. A conexão passa a aparecer em "Conexões autorizadas".
5. Numa conversa, clique em "+", escolha "Modo desenvolvedor" e selecione o "Nectar".

O ChatGPT muda os nomes desses menus com frequência. Se não encontrar, procure por "Modo desenvolvedor" nas configurações dele.

Cursor

1. No Cursor, abra o arquivo ~/.cursor/mcp.json (ou .cursor/mcp.json, no projeto) e cole a configuração que a tela mostra, pelo botão "Copiar".
2. Na lista de servidores MCP do Cursor, o "Nectar" aparece pedindo login. Clique para entrar: o Nectar abre, você entra com o seu usuário e autoriza. A conexão passa a aparecer em "Conexões autorizadas".
3. No chat do Cursor, no modo "Agent", pergunte normalmente. O Cursor usa as ferramentas do Nectar quando precisa e pede a sua aprovação antes de cada uso.

É preciso uma versão recente do Cursor, com login OAuth para MCP.

Outros assistentes

Qualquer assistente compatível com MCP remoto (HTTP) pode se conectar. Informe na tela de conectores dele:

• "Transporte": HTTP (Streamable)
• "Autenticação": OAuth 2.1 com PKCE
• "Client ID": ncrm_mcp, sem segredo

No seu computador

1. Copie o comando do passo 1 pelo botão "Copiar comando" e rode no terminal do macOS ou do Linux. Ele abre o navegador para você autorizar, como no conector na nuvem.
2. Copie a configuração do passo 2 e cole no arquivo ~/.claude/settings.json, ou no arquivo de MCP do seu assistente.

A credencial fica salva só no computador em que você rodou o comando. A conexão aparece em "Conexões autorizadas" e pode ser desconectada por lá.

Autorizar no Nectar

Em todos os assistentes, o último passo é o mesmo: abre uma página do Nectar, você entra com o seu usuário, confere o que a IA vai poder ler e clica em "Autorizar".

• A autorização vale por alguns minutos. Se aparecer "Sessão expirada", clique em "Recarregar" na própria página ou volte ao assistente e peça para vincular outra vez.
• Se você entrou no Nectar e nada aconteceu, volte ao assistente e clique em "Vincular" outra vez. Com o Nectar já aberto, a tela de autorização aparece direto.
• Se o assistente não encontra um registro, confira se você vê esse registro no Nectar e se o Nectar está ligado na conversa.

Ver e desconectar as conexões

O bloco "Conexões autorizadas", no fim da aba, lista os assistentes que entraram pelo login do Nectar, com as colunas "Aplicativo", "Usuário", "Acesso", "Autorizado em" e "Último uso". Conexões feitas por este conector levam a marca "via Nectar MCP", e o acesso aparece como "Somente leitura", com o número de áreas liberadas.

Na linha da conexão, clique em "Desconectar" e confirme. A IA perde o acesso ao Nectar até ser autorizada outra vez, e a tela avisa "Conexão desconectada.". Se der errado, aparece "Não foi possível desconectar. Tente de novo."

• "Nenhuma IA conectada ainda": ninguém conectou o Claude ou outro assistente pelo login do Nectar.
• "Não foi possível carregar as conexões.": a lista não carregou. Saia da aba e volte para tentar outra vez.

Quem pode conectar

• Qualquer usuário do Nectar pode conectar a própria IA. Não depende de cargo.
• Cada pessoa autoriza com o próprio login, então cada uma vê pela IA só o que já vê no CRM.
• Administradores veem em "Conexões autorizadas" as conexões de toda a conta; os demais veem as próprias.

Veja também

• "O que é o Nectar AI e quem tem acesso"