DialogBrain

npx add-mcp 'https://api.dialogbrain.com/mcp/'

Usando o DialogBrain a partir do Claude, ChatGPT e Cursor

Seu workspace é um servidor MCP. Aponte um assistente para uma URL e sua caixa de entrada, contatos, chamadas, tarefas e conhecimento se tornam ferramentas que esse assistente pode chamar — as mesmas ferramentas que seus próprios agentes usam, com as mesmas permissões.

Atualizado em 2026-09-29

§ Antes de começar

• Um workspace do DialogBrain. A conexão é limitada a um workspace, e tudo o que o assistente lê ou envia pertence a ele.
• O cliente que você deseja conectar: Claude, ChatGPT, Cursor, VS Code, Devin Desktop (antigo Windsurf), Claude Desktop, Claude Code, Codex, Gemini CLI, Antigravity ou Grok. Qualquer cliente que fale MCP sobre HTTP funciona, incluindo um que você mesmo tenha escrito.
• Nada para instalar. Não há pacote nem processo local: o servidor é nosso e é acessado via HTTPS.

1. Copie a URL do servidor

   Abra Configurações → Desenvolvedor. A seção Conectar contém um único endereço, e ele é o mesmo para todos os clientes e todos os workspaces:

   https://api.dialogbrain.com/mcp/
   

   Em qual workspace você cai é decidido por quem autentica, não pela URL. É por isso que o endereço não é um segredo e a credencial é.
2. Etapa 2

   Adicione o servidor ao seu cliente

   Configurações → Desenvolvedor. Cada cliente coberto pelo guia tem sua própria entrada, e cada uma imprime o trecho a ser copiado. No Claude na web: Configurações → Conectores → Adicionar conector personalizado e cole a URL. No ChatGPT na web: Plugins → Adicionar → Adicionar servidor MCP personalizado e cole a mesma URL; o plano gratuito também funciona. Ambos então guiam você pela autenticação. No Grok na web: Plugins → Conectores → Novo conector → Personalizado, dê um nome e cole a mesma URL. O Grok abre um popup para você entrar e, em seguida, lista nossas ferramentas ao lado dos próprios conectores. No Claude Code, instale o plugin: ele adiciona o servidor e seis habilidades que sabem como configurar um widget, conectar um canal, construir um agente, executar o quadro de tarefas e escrever um relatório de leads. Em seguida, execute /mcp e entre.

   claude plugin marketplace add saloprj/dialogbrain-claude-plugin
   claude plugin install dialogbrain@dialogbrain
   

   Se você quiser apenas o servidor sem as habilidades:

   claude mcp add --transport http dialogbrain https://api.dialogbrain.com/mcp/
   

   No Codex CLI e no Gemini CLI, o formato é o mesmo, e ambos abrem um navegador para você entrar quando usar o servidor pela primeira vez:

   codex mcp add dialogbrain --url https://api.dialogbrain.com/mcp/
   

   gemini mcp add --transport http dialogbrain https://api.dialogbrain.com/mcp/
   

   O Antigravity não tem comando de adicionar e seu OAuth para MCP remoto não repassa o token, então é o único cliente que aceita uma chave de API desde o início. Coloque isto em .agents/mcp_config.json no projeto (ou ~/.gemini/config/mcp_config.json para todos os projetos); observe serverUrl, não url:

   {
     "mcpServers": {
       "dialogbrain": {
         "serverUrl": "https://api.dialogbrain.com/mcp/",
         "headers": { "X-API-Key": "<your API key>" }
       }
     }
   }
   

   No Cursor, coloque isto em ~/.cursor/mcp.json e reinicie:

   {
     "mcpServers": {
       "dialogbrain": { "url": "https://api.dialogbrain.com/mcp/" }
     }
   }
   

   No VS Code, o arquivo é .vscode/mcp.json no seu projeto e o formato é ligeiramente diferente — servers em vez de mcpServers, e o transporte é nomeado:

   {
     "servers": {
       "dialogbrain": { "type": "http", "url": "https://api.dialogbrain.com/mcp/" }
     }
   }
   

   O Claude Desktop (v0.9 e posterior) usa o formato do Cursor em claude_desktop_config.json; o Devin Desktop — o antigo Windsurf — usa em ~/.codeium/windsurf/mcp_config.json, ou ~/.config/devin/mcp_config.json em builds mais recentes. Configurações → Desenvolvedor imprime o trecho exato para cada um, para que você possa copiar em vez de redigitar.
3. Etapa 3

   Autentique

   Prefira OAuth onde o cliente oferecer: adicione o servidor, e o cliente abre um navegador para você entrar. No Claude Code, isso significa executar /mcp após adicionar o servidor. Nada é armazenado em um arquivo de configuração, e o acesso segue sua conta. Onde OAuth não estiver disponível (Antigravity e qualquer cliente cujo login nunca conclui), use uma chave de API. Configurações → Desenvolvedor → Chaves de API cria uma; ela é exibida apenas uma vez, então copie-a nesse momento. A chave vai em um cabeçalho X-API-Key:

   {
     "mcpServers": {
       "dialogbrain": {
         "url": "https://api.dialogbrain.com/mcp/",
         "headers": { "X-API-Key": "your-api-key" }
       }
     }
   }
   

   Alguns clientes aceitam apenas uma URL simples, sem cabeçalhos. Para esses, a mesma chave pode ir na string de consulta como ?token=… — a entrada Qualquer cliente MCP (HTTP) em Configurações → Desenvolvedor imprime esse formato. O Cursor é o que merece atenção: versões que pulam o prompt de OAuth respondem "unauthorized" e não dão nenhuma outra pista. Se isso acontecer, alterne essa entrada para a variante com chave de API acima.
4. Etapa 4

   Verifique se funcionou

   Pergunte ao assistente o que ele pode fazer com o DialogBrain, ou peça para listar suas ferramentas do DialogBrain. Um cliente conectado relata uma grande superfície de ferramentas, agrupadas pelo que elas operam: mensagens, threads, contatos, chamadas, agentes, tarefas, conhecimento, arquivos, análises, widgets. Em seguida, peça algo pequeno e somente leitura — "encontre o contato chamado …", "quais foram as últimas mensagens naquele thread" — antes de permitir que ele escreva qualquer coisa. Uma ferramenta que lê prova a conexão e o workspace em uma única etapa. Uma coisa que parece falha e não é: a entrada Canal do Claude Code na mesma página de configurações é um canal, não um servidor de ferramentas. Outros clientes MCP se conectam a ele e corretamente não encontram ferramentas. Se um cliente relatar uma lista de ferramentas vazia, verifique qual das duas você colou.

O que você pode fazer depois de conectado

Ler e responder. O assistente pode pesquisar threads e mensagens, abrir uma conversa e enviar uma resposta por qualquer canal ao qual essa conversa pertença — Telegram, WhatsApp, Instagram, e-mail — sem que você nomeie o canal.

Trabalhar a base de contatos. Encontre pessoas, mescle duplicatas, atualize campos, veja um perfil de contato com seu histórico entre canais.

Conduzir agentes e chamadas. Inicie uma chamada, leia a transcrição depois, entregue uma conversa a um agente ou retome-a, crie e atribua tarefas no quadro do workspace.

Fazer perguntas sobre seus próprios dados. A base de conhecimento e a superfície de análises também são ferramentas, então "quantas conversas respondemos na semana passada" é uma pergunta que o assistente pode realmente responder em vez de adivinhar.

Duas coisas que o servidor informa ao seu cliente e por que elas importam

Cada resposta carrega o workspace em que foi executada. Uma reconexão inicia uma nova sessão no workspace padrão da chave de API, então uma sessão pode se mover silenciosamente: o primeiro sintoma é uma ferramenta dizer que um id que você acabou de usar não existe. A correção é trocar de workspace, não tentar a chamada novamente ou duvidar do id.

Cada resposta também carrega uma versão da superfície de ferramentas. Adicionamos e alteramos ferramentas em cada implantação; quando esse valor muda no meio da sessão, um cliente com esquemas em cache deve reler a lista de ferramentas em vez de confiar nos parâmetros que memorizou na conexão.

Ambos são enviados ao cliente automaticamente no momento da conexão. Você não precisa fazer nada com eles, mas eles explicam duas falhas que, de outra forma, parecem bugs no seu prompt.

§ Perguntas e respostas

A URL do servidor é um segredo?

Não. É o mesmo endereço para todos e está impresso na página de configurações. A credencial é o segredo: quem autentica decide qual workspace a sessão vê.

OAuth ou chave de API?

OAuth sempre que o cliente suportar. Nada vai para um arquivo de configuração, o acesso segue sua conta e revogá-lo é uma ação normal de conta. Use uma chave quando o cliente não tiver fluxo OAuth ou quando a conexão pertencer a uma máquina em vez de uma pessoa.

Meu cliente conectou, mas não encontrou ferramentas.

Quase sempre é a URL do Canal do Claude Code colada onde pertence a URL do servidor MCP. Esse endpoint é um transporte para sessões do Claude Code e deliberadamente não registra ferramentas. O endereço do servidor é o que está em Conectar.

O Cursor diz "unauthorized" e nada mais.

Algumas versões do Cursor nunca mostram o prompt de OAuth e falham silenciosamente. Use o formato com chave de API com o cabeçalho X-API-Key; ele funciona em todas as versões.

Várias pessoas podem se conectar ao mesmo tempo?

Sim. Cada pessoa autentica como ela mesma, então o que ela faz é atribuído a ela, e as sessões são independentes — uma pessoa trocando de workspace não move ninguém mais. Onde uma superfície tem limites baseados em papéis, como o quadro de tarefas ou as configurações do workspace, eles se aplicam a quem está chamando.

O que acontece quando eu revogo uma chave?

Toda integração que a usa para imediatamente, e não há desfazer. Dê chaves próprias às máquinas para que revogar uma não derrube as demais.

Posso conectar meus próprios servidores MCP no sentido inverso?

Sim, e isso é um recurso separado: um agente pode receber qualquer servidor MCP ou API HTTP que você conectar, e essas ferramentas ficam ao lado das nossas no mesmo nível. Este guia é sobre a direção oposta — seu assistente acessando o DialogBrain.