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.
| Item | Valor |
|---|---|
| Endereço do servidor | https://doublex.ai/api/mcp |
| Login | OAuth: você entra com a sua conta DoubleX e clica em Permitir. |
| Permissões | As 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#
- No Claude, abra Configurações › Conectores e clique em Adicionar conector personalizado.
- Dê um nome (por exemplo,
DoubleX Agentes) e cole o endereçohttps://doublex.ai/api/mcp. - Clique em Conectar. Uma janela do DoubleX Agentes abre: entre, se ainda não entrou, e clique em Permitir.
- 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:
claude mcp add --transport http doublex https://doublex.ai/api/mcpConectar no ChatGPT#
- No ChatGPT, abra Configurações › Apps › Configurações avançadas e ligue o modo desenvolvedor.
- Clique em Criar app (ou Criar conector), dê um nome e cole o endereço
https://doublex.ai/api/mcp. - Escolha a autenticação OAuth e confirme.
- Na janela do DoubleX Agentes, entre e clique em Permitir.
- 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:
{
"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 antigo | No DoubleX Agentes |
|---|---|
| Instruções | As instruções do agente, copiadas sem resumo nem tradução. |
| Arquivos de conhecimento | Uma nota por arquivo no Brain, na pasta Importados/<nome do agente>, ligadas ao agente. |
| Procedimentos reutilizáveis | Skills ligadas ao agente. |
| Sugestões de conversa | As sugestões que aparecem no chat do agente. |
| Apps usados | Os conectores que você já tem são ligados. Os que faltam aparecem com o link para conectar. |
| Rotina recorrente | Um 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#
| Ferramenta | O que faz |
|---|---|
get_account | Mostra a conta, a empresa, os times e o saldo de créditos. |
list_agents / get_agent | Lista os agentes e mostra a configuração completa de um. |
import_agent | Cria o agente com instruções, notas, skills, conectores e rotina, numa chamada. |
update_agent | Muda o agente e liga mais notas, skills ou conectores. |
list_brain / search_brain / read_brain_note | Lista, busca e lê o Brain. |
save_brain_note | Cria ou atualiza uma nota, opcionalmente ligando a um agente. |
list_skills / create_skill | Lista e cria skills. |
list_connectors | Mostra os apps conectados e o catálogo, com os IDs usados na migração. |
create_trigger | Cria um gatilho agendado, único ou por webhook. |
run_agent / get_agent_run | Conversa com um agente e acompanha a resposta. |
list_radar_alerts | Lê os avisos recentes (tela Avisos). |
list_monitor_tools / create_monitor | Mostra 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_noteem seguida. - Conectar um app exige o seu login nele, na tela de Conectores. A IA só liga os que já estão conectados.
run_agentusa créditos e espera até 45 segundos (até 120, se pedido). Conversas mais longas continuam rodando e a IA acompanha comget_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.