DoubleX AgentesDocs

Guias › Integração

ChatGPT e Claude (MCP)

Conecte o ChatGPT, o Claude e outros apps compatíveis com MCP para migrar e usar seus agentes direto da conversa.

O DoubleX Agentes tem um servidor MCP. Depois de conectado, o ChatGPT, o Claude ou outro app compatível consegue criar agentes aqui, subir o conhecimento deles para o Brain e conversar com eles, tudo a partir da conversa.

O uso mais comum é a migração: a IA lê as instruções e os arquivos do seu assistente (um Projeto do Claude, um GPT personalizado) e recria tudo no DoubleX Agentes, organizado em pastas.

ItemValor
Endereço do servidorhttps://doublex.ai/api/mcp
LoginOAuth: você entra com a sua conta DoubleX e clica em Permitir.
PermissõesAs suas. O app vê e altera só o que você vê e altera na tela.

O endereço também aparece em Configurações › Perfil › Apps conectados, com um botão para copiar.

Conectar no Claude#

  1. No Claude, abra Configurações › Conectores e clique em Adicionar conector personalizado.
  2. Dê um nome (por exemplo, DoubleX Agentes) e cole o endereço https://doublex.ai/api/mcp.
  3. Clique em Conectar. Uma janela do DoubleX Agentes abre: entre, se ainda não entrou, e clique em Permitir.
  4. Numa conversa, ligue o conector no menu de ferramentas.

Nos planos Team e Enterprise do Claude, quem administra a conta adiciona o conector primeiro. Depois, cada pessoa conecta a própria conta.

No Claude Code, adicione pelo terminal e autorize com /mcp:

Terminal
claude mcp add --transport http doublex https://doublex.ai/api/mcp

Conectar no ChatGPT#

  1. No ChatGPT, abra Configurações › Apps › Configurações avançadas e ligue o modo desenvolvedor.
  2. Clique em Criar app (ou Criar conector), dê um nome e cole o endereço https://doublex.ai/api/mcp.
  3. Escolha a autenticação OAuth e confirme.
  4. Na janela do DoubleX Agentes, entre e clique em Permitir.
  5. Numa conversa, escolha o app no menu +.

Outros apps#

Qualquer cliente MCP com transporte HTTP funciona (Cursor, VS Code e outros). Use o endereço https://doublex.ai/api/mcp com OAuth. Se o app não tiver OAuth, mande a chave pessoal no cabeçalho:

mcp.json
{
  "mcpServers": {
    "doublex": {
      "url": "https://doublex.ai/api/mcp",
      "headers": { "Authorization": "Bearer dbx_SUA_CHAVE" }
    }
  }
}

Migrar um agente#

De um Projeto do Claude. Abra o projeto, comece uma conversa com o conector ligado e peça:

Migre este projeto para o DoubleX Agentes, com as instruções e todos os arquivos.

Dentro do projeto, o Claude enxerga as instruções e os arquivos. No Claude, o pedido pronto migrate_assistant do conector faz o mesmo.

De um GPT personalizado. O ChatGPT não lê a configuração dos seus GPTs. Abra o GPT em Editar › Configurar, copie as instruções e baixe os arquivos de conhecimento. Depois, numa conversa comum com o app do DoubleX Agentes, cole as instruções, anexe os arquivos e peça a migração.

De qualquer outro assistente. Cole as instruções (o "prompt de sistema") e anexe os arquivos. A IA nunca inventa instruções: se faltar algo, ela pergunta.

O que a migração cria:

No assistente antigoNo DoubleX Agentes
InstruçõesAs instruções do agente, copiadas sem resumo nem tradução.
Arquivos de conhecimentoUma nota por arquivo no Brain, na pasta Importados/<nome do agente>, ligadas ao agente.
Procedimentos reutilizáveisSkills ligadas ao agente.
Sugestões de conversaAs sugestões que aparecem no chat do agente.
Apps usadosOs conectores que você já tem são ligados. Os que faltam aparecem com o link para conectar.
Rotina recorrenteUm gatilho agendado, criado desligado para você revisar e ligar.

Se já existir um agente com o mesmo nome, a IA pergunta se deve atualizar o existente ou criar uma cópia.

Ferramentas#

FerramentaO que faz
get_accountMostra a conta, a empresa, os times e o saldo de créditos.
list_agents / get_agentLista os agentes e mostra a configuração completa de um.
import_agentCria o agente com instruções, notas, skills, conectores e rotina, numa chamada.
update_agentMuda o agente e liga mais notas, skills ou conectores.
list_brain / search_brain / read_brain_noteLista, busca e lê o Brain.
save_brain_noteCria ou atualiza uma nota, opcionalmente ligando a um agente.
list_skills / create_skillLista e cria skills.
list_connectorsMostra os apps conectados e o catálogo, com os IDs usados na migração.
create_triggerCria um gatilho agendado, único ou por webhook.
run_agent / get_agent_runConversa com um agente e acompanha a resposta.
list_radar_alertsLê os avisos recentes (tela Avisos).
list_monitor_tools / create_monitorMostra as consultas de leitura de uma conexão e cria um monitor em Avisos.

Ferramentas que gravam dados vêm marcadas como escrita: o ChatGPT e o Claude pedem a sua confirmação antes de usá-las.

Limites#

  • Arquivos passam como texto. A IA envia o conteúdo de cada arquivo como Markdown. PDFs escaneados, planilhas grandes e arquivos binários sobem melhor pela tela do Brain, direto na pasta do agente.
  • Instruções têm até 20.000 caracteres. Material de referência longo vai para notas do Brain.
  • Até 50 notas e 20 skills por migração. Para mais, a IA chama save_brain_note em seguida.
  • Conectar um app exige o seu login nele, na tela de Conectores. A IA só liga os que já estão conectados.
  • run_agent usa créditos e espera até 45 segundos (até 120, se pedido). Conversas mais longas continuam rodando e a IA acompanha com get_agent_run.

Segurança e desconexão#

  • O login usa OAuth 2.1 com PKCE. O app recebe um token que vale uma hora e é renovado sozinho, nunca a sua senha.
  • Para cortar o acesso, abra Configurações › Perfil › Apps conectados e clique em Desconectar. Os tokens daquele app param de valer na hora.
  • Trocar ou redefinir a senha desconecta todos os apps.