Ir para conteúdo principal

Conecte o Conexa a ferramentas como ChatGPT e Claude via MCP

P
Escrito por Produto Conexa

Leve as informações da sua conta Conexa direto para dentro das suas conversas com IA.

✓ Conecte o Conexa aos principais agentes de IA do mercado, como ChatGPT e Claude

✓ Consulte clientes, contratos, vendas e cobranças sem precisar abrir o Conexa

✓ Automatize rotinas, crie relatórios personalizados e realize ações direto pela sua IA favorita

💡 Não tem costume de usar IA no dia a dia? Antes de seguir o passo a passo abaixo, vale assistir a alguns vídeos gratuitos no YouTube, buscando por algo como "como usar o ChatGPT" ou "como usar o Claude", para já pegar o jeito da ferramenta.

Este artigo mostra como conectar ao Claude e ao ChatGPT. O processo é parecido em qualquer outra IA que suporte MCP.

O que você vai precisar

  • O subdomínio da sua conta Conexa: é o nome que aparece na URL quando você acessa o sistema (por exemplo, se você acessa https://minhaempresa.conexa.app, o seu subdomínio é minhaempresa).

  • A configuração precisa ser feita pelo computador. Depois de pronta, o conector funciona também nos aplicativos de celular (iPhone e Android).

  • Uma conta em uma IA compatível com MCP:

    • Claude: funciona em todos os planos, inclusive no gratuito. No plano gratuito, porém, você só pode ter um conector personalizado ativo por vez, então, se já usa o Claude free com outra integração, vai precisar remover ela antes de adicionar o Conexa (ou assinar um plano pago).

    • ChatGPT: exige plano pago (Plus, Pro, Business, Enterprise ou Edu). O plano gratuito do ChatGPT não tem a opção de conector personalizado.

    • Gemini: ainda não é possível conectar no Brasil. Hoje o recurso de conectores MCP personalizados existe apenas dentro do Gemini Spark, restrito a contas pessoais do Google nos Estados Unidos e em inglês. Assim que a Google liberar por aqui, atualizamos este artigo. Enquanto isso, recomendamos usar o Claude.


Conectando ao Claude

Passo 1: adicionar o conector personalizado

  1. No Claude, clique em Personalizar e depois em Conectores.

  2. Clique em Adicionar e, em seguida, em Adicionar conector personalizado.

  3. No campo Nome, escreva "Conexa" e, no campo de URL do servidor MCP remoto, cole a URL abaixo, substituindo por seu subdomínio.

    https://mcp.conexa.app/mcp/SEUSUBDOMINIO

    Por exemplo, no caso do print abaixo o subdomínio é workspace.

    Ou seja, a url, neste exemplo, ficaria: https://mcp.conexa.app/mcp/workspace

    Monte a sua URL e cole no Claude, como no exemplo abaixo:

    Depois disso, basta clicar em Continuar

  4. Nesta tela, deixe as configurações padrões, role para baixo e clique em Adicionar

Passo 2: fazer login e autorizar

  1. O Conexa aparece na lista de conectores. Clique em Conectar.

  2. Depois clique em Continuar conectando

  3. Vai abrir a tela de login do Conexa. Faça login normalmente.

  4. Aceite as permissões solicitadas.

    No campo de expiração (ou duração do acesso) na tela de autorização, deixe em branco para que o login fique salvo até você desconectar manualmente. Depois, basta clicar em Autorizar, que você será redirecionado de volta ao Claude com o MCP já conectado


Conectando ao ChatGPT

No ChatGPT, conectores personalizados via MCP ficam dentro do Modo Desenvolvedor, que precisa ser ativado uma única vez antes de criar a conexão.

Passo 1: ativar o Modo Desenvolvedor

  1. Clique no seu perfil (canto inferior esquerdo) e vá em Configurações.

  2. Acesse a aba Segurança e Login

  3. Role para baixo e ative a opção Modo Desenvolvedor.

Passo 2: criar o conector do Conexa

  1. De volta à tela inicial, clique em Personalizar e depois em +

  2. Preencha os campos do conector:

    No campo Nome, escreva "Conexa" e, no campo de URL do servidor MCP remoto, cole a URL abaixo, substituindo por seu subdomínio.

    https://mcp.conexa.app/mcp/SEUSUBDOMINIO

    Por exemplo, no caso do print abaixo o subdomínio é workspace.

    Ou seja, a url, neste exemplo, ficaria: https://mcp.conexa.app/mcp/workspace

  3. Monte a sua URL e cole no ChatGPT, como no exemplo abaixo. No campo autenticação, mantenha OAuth marcado.

  4. Marque a caixa confirmando que você confia neste conector.

  5. Clique em Criar.

Passo 3: fazer login e autorizar

Passo 2: fazer login e autorizar

  1. O Conexa aparece na lista de conectores. Clique em Conectar.

  2. Depois clique em Continuar conectando

  3. Vai abrir a tela de login do Conexa. Faça login normalmente.

  4. Aceite as permissões solicitadas.

    No campo de expiração (ou duração do acesso) na tela de autorização, deixe em branco para que o login fique salvo até você desconectar manualmente. Depois, basta clicar em Autorizar, que você será redirecionado de volta ao Claude com o MCP já conectado

Passo 4: usar o conector nas conversas

  1. Em uma conversa, clique no ícone "+" (ou no menu de ferramentas) na caixa de mensagem.

  2. Selecione o conector Conexa para ativá-lo na conversa (ou digite @Conexa para chamá-lo diretamente).

  3. Peça o que precisar. O ChatGPT vai usar as ferramentas do Conexa para responder.

⚠️ O conector fica ativo só para a conversa em que ele foi habilitado. Em uma conversa nova, é preciso selecioná-lo (ou usar @Conexa) de novo.

⚠️ Em contas Business, Enterprise ou Edu, o administrador precisa liberar a criação de conectores antes. Se o botão de criar estiver desativado, é provavelmente por isso.


Teste se funcionou

Depois de conectar tanto no Claude quanto no ChatGPT, o jeito mais rápido de confirmar que deu tudo certo é pedir alguma informação real da sua conta, por exemplo:

Quantos clientes ativos eu tenho no Conexa?
Liste minhas cobranças em aberto no Conexa

Se a IA responder com dados reais da sua conta, está tudo certo.


E as outras IAs?

O MCP é um padrão aberto, então a mesma URL (https://mcp.conexa.app/mcp/SEUSUBDOMINIO) funciona em qualquer outra ferramenta compatível, além de Claude e ChatGPT. O caminho muda de nome de tela para tela, mas a lógica é sempre a mesma: adicionar um conector/servidor MCP personalizado, colar a URL, autenticar com o login do Conexa.

Casos de uso: o que fazer com o Conexa conectado

Alguns exemplos práticos do que dá para pedir para a IA depois que o conector estiver ativo.

Lançar despesas a partir de um PDF

Anexe a nota fiscal, o boleto ou o recibo em PDF na conversa e peça para a IA cadastrar a despesa no Conexa. Ela lê o documento, identifica valor, vencimento, fornecedor e outros dados, e cria o lançamento direto, sem digitação manual.

Aqui está a nota do aluguel deste mês. Cadastra essa despesa no Conexa pra mim.

Cadastrar clientes a partir de um print ou de uma lista

Recebeu os dados de um cliente novo em uma conversa de WhatsApp? Cole o print na conversa com a IA e peça para cadastrar no Conexa. Funciona também para importações maiores: cole uma lista (ou uma planilha) com vários contatos de uma vez e peça para cadastrar todos.

Segue o print da conversa com esse cliente novo. Cadastra ele no Conexa com esses dados.

Relatórios personalizados de inadimplência

Peça relatórios com parâmetros específicos, como o NPL90 (o percentual das cobranças em aberto há mais de 90 dias em relação ao total da carteira). A IA busca os dados de cobranças no Conexa, faz o cálculo e devolve o relatório em PDF, já formatado.

Monta um relatório em PDF da inadimplência dos últimos 3 meses, com o NPL90 por unidade.

💡 Nesses três casos, a IA está lendo, calculando ou cadastrando dados reais da sua conta. Vale sempre dar uma olhada no que ela extraiu ou calculou antes de confirmar um cadastro ou compartilhar um relatório.

FAQ

Quais permissões o agente de IA vai ter no Conexa?

Depende de três coisas juntas. A primeira é a sua permissão de usuário dentro do Conexa: como o acesso é feito com a sua própria conta, a IA só enxerga e só consegue fazer o que você já tem permissão de ver ou fazer no sistema, nada além disso. A segunda são as permissões concedidas na tela de login, no momento em que você autoriza o conector: é ali que o Conexa mostra o que está sendo liberado para aquela IA. A terceira é o que o próprio agente de IA permite fazer: no caso do Claude, por exemplo, mesmo com o acesso liberado, ele pode ter travas próprias sobre quais ações de escrita executa sem confirmação sua.

A URL não funciona ou aparece "URL inválida", o que eu faço?

Confira se o subdomínio está correto e sem espaços, é o mesmo que aparece quando você acessa o Conexa pelo navegador. Não inclua .conexa.app no final da URL de conexão.

Conectei, mas a IA diz que não tem acesso ao Conexa, por quê?

O conector está desligado naquela conversa. Ative no menu de ferramentas (ou no "+") ao lado da caixa de mensagem.

Por que não aparece a opção de conector personalizado no ChatGPT?

Confirme se o Modo Desenvolvedor está ativado em Configurações > Conectores > Configurações avançadas, e se o seu plano oferece essa opção. No plano gratuito do ChatGPT essa opção não existe.

Por que o botão de adicionar conector não aparece?

Pode ser plano gratuito no ChatGPT, o limite de um conector no Claude gratuito, ou falta de liberação do administrador da conta (nos planos Team, Enterprise ou Edu).

Funcionava e parou depois de um tempo, o que aconteceu?

A sessão pode ter expirado. Volte nas configurações de conectores e clique em Conectar novamente.

No ChatGPT, a IA só consulta e não consegue criar ou alterar nada, isso é normal?

Sim. Em planos individuais, o ChatGPT pode liberar apenas leitura e limitar ações de escrita (cadastros e alterações podem não funcionar). Além disso, confirme que no login no Conexa você marcou a opção de Edição/Criação.

Isto respondeu à sua pergunta?