DialogBrain

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

Uso de DialogBrain desde Claude, ChatGPT y Cursor

Tu espacio de trabajo es un servidor MCP. Apunta un asistente a una URL y su bandeja de entrada, contactos, llamadas, tareas y conocimiento se convierten en herramientas que ese asistente puede invocar — las mismas herramientas que usan tus propios agentes, con los mismos permisos.

Actualizado 2026-09-29

§ Antes de empezar

• Un espacio de trabajo de DialogBrain. La conexión está limitada a un espacio de trabajo, y todo lo que el asistente lee o envía pertenece a ese espacio.
• El cliente que quieres conectar: Claude, ChatGPT, Cursor, VS Code, Devin Desktop (antes Windsurf), Claude Desktop, Claude Code, Codex, Gemini CLI, Antigravity o Grok. Cualquier cliente que hable MCP sobre HTTP funciona, incluido uno que hayas escrito tú mismo.
• Nada que instalar. No hay paquete ni proceso local: el servidor es nuestro y se accede a él por HTTPS.

1. Copia la URL del servidor

   Abre Configuración → Desarrollador. La sección Conectar contiene una única dirección, y es la misma para todos los clientes y todos los espacios de trabajo:

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

   En qué espacio de trabajo aterrizas lo decide quién se autentica, no la URL. Por eso la dirección no es un secreto y la credencial sí lo es.
2. Paso 2

   Añade el servidor a tu cliente

   Configuración → Desarrollador. Cada cliente que cubre la guía tiene su propia entrada, y cada una muestra el fragmento a copiar. En Claude en la web: Configuración → Conectores → Añadir conector personalizado, y pega la URL. En ChatGPT en la web: Plugins → Añadir → Añadir servidor MCP personalizado, y pega la misma URL; el plan gratuito también funciona. Ambos te guían luego por la autenticación. En Grok en la web: Plugins → Conectores → Nuevo conector → Personalizado, ponle un nombre y pega la misma URL. Grok abre una ventana emergente para iniciar sesión y luego lista nuestras herramientas junto a sus propios conectores. En Claude Code, instala el plugin: añade el servidor y seis habilidades que saben cómo configurar un widget, conectar un canal, construir un agente, gestionar el tablero de tareas y redactar un informe de clientes potenciales. Luego ejecuta /mcp e inicia sesión.

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

   Si solo quieres el servidor sin las habilidades:

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

   En Codex CLI y Gemini CLI tiene la misma forma, y ambos abren un navegador para iniciar sesión la primera vez que usas el servidor:

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

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

   Antigravity no tiene comando de añadir y su OAuth para MCP remoto no transfiere el token, así que es el único cliente que requiere una clave API desde el principio. Pon esto en .agents/mcp_config.json en el proyecto (o ~/.gemini/config/mcp_config.json para todos los proyectos); observa serverUrl, no url:

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

   En Cursor, pon esto en ~/.cursor/mcp.json y reinicia:

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

   En VS Code el archivo es .vscode/mcp.json en tu proyecto y la forma es ligeramente distinta — servers en lugar de mcpServers, y el transporte tiene nombre:

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

   Claude Desktop (v0.9 y posteriores) usa la forma de Cursor en claude_desktop_config.json; Devin Desktop — el Windsurf renombrado — la usa en ~/.codeium/windsurf/mcp_config.json, o ~/.config/devin/mcp_config.json en versiones más nuevas. Configuración → Desarrollador imprime el fragmento exacto para cada uno, para que puedas copiar en lugar de volver a escribir.
3. Paso 3

   Autentícate

   Prefiere OAuth donde el cliente lo ofrezca: añade el servidor, y el cliente abre un navegador para iniciar sesión. En Claude Code eso significa ejecutar /mcp después de añadir el servidor. Nada se guarda en un archivo de configuración, y el acceso sigue a tu cuenta. Donde OAuth no esté disponible (Antigravity, y cualquier cliente cuyo inicio de sesión nunca se complete), usa una clave API. Configuración → Desarrollador → Claves API crea una; se muestra una sola vez, así que cópiala en ese momento. La clave va en una cabecera X-API-Key:

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

   Algunos clientes aceptan solo una URL desnuda sin cabeceras. Para esos, la misma clave puede ir en la cadena de consulta como ?token=… — la entrada Cualquier cliente MCP (HTTP) en Configuración → Desarrollador imprime esa forma. Cursor es el que hay que vigilar: las versiones que omiten el aviso de OAuth responden "unauthorized" y no dan ninguna otra pista. Si eso ocurre, cambia esa entrada a la variante con clave API de arriba.
4. Paso 4

   Comprueba que funcionó

   Pregunta al asistente qué puede hacer con DialogBrain, o pídele que liste sus herramientas de DialogBrain. Un cliente conectado informa de una gran superficie de herramientas, agrupadas por lo que actúan: mensajes, hilos, contactos, llamadas, agentes, tareas, conocimiento, archivos, analíticas, widgets. Luego pide algo pequeño y de solo lectura — "encuentra el contacto llamado …", "cuáles fueron los últimos mensajes en ese hilo" — antes de dejar que escriba nada. Una herramienta que lee demuestra la conexión y el espacio de trabajo en un solo paso. Una cosa que parece un fallo y no lo es: la entrada Canal de Claude Code en la misma página de configuración es un canal, no un servidor de herramientas. Otros clientes MCP se conectan a él y correctamente no encuentran herramientas. Si un cliente informa de una lista de herramientas vacía, comprueba cuál de los dos pegaste.

Qué puedes hacer una vez conectado

Leer y responder. El asistente puede buscar en hilos y mensajes, abrir una conversación y enviar una respuesta a través del canal al que pertenezca esa conversación — Telegram, WhatsApp, Instagram, correo electrónico — sin que tú nombres el canal.

Trabajar la base de contactos. Encuentra personas, fusiona duplicados, actualiza campos, mira un perfil de contacto con su historial a través de canales.

Impulsar agentes y llamadas. Inicia una llamada, lee su transcripción después, entrega una conversación a un agente o recupérala, crea y asigna tareas en el tablero del espacio de trabajo.

Hacer preguntas sobre tus propios datos. La base de conocimiento y la superficie de analíticas también son herramientas, así que "¿cuántas conversaciones respondimos la semana pasada?" es una pregunta que el asistente puede responder de verdad en lugar de adivinar.

Dos cosas que el servidor le dice a tu cliente, y por qué importan

Cada respuesta lleva el espacio de trabajo en el que se ejecutó. Una reconexión inicia una nueva sesión en el espacio de trabajo predeterminado de la clave API, así que una sesión puede moverse silenciosamente: el primer síntoma es que una herramienta dice que un id que acabas de usar no existe. La solución es cambiar de espacio de trabajo, no reintentar la llamada ni dudar del id.

Cada respuesta también lleva una versión de la superficie de herramientas. Añadimos y cambiamos herramientas en cada despliegue; cuando ese valor cambia a mitad de sesión, un cliente con esquemas en caché debería releer la lista de herramientas en lugar de confiar en los parámetros que memorizó al conectar.

Ambos se envían al cliente automáticamente al conectar. No tienes que hacer nada con ellos, pero explican dos fallos que de otro modo parecen errores en tu prompt.

§ Preguntas y respuestas

¿La URL del servidor es un secreto?

No. Es la misma dirección para todos, y se imprime en la página de configuración. La credencial es el secreto: quien se autentica decide qué espacio de trabajo ve la sesión.

¿OAuth o una clave API?

OAuth donde el cliente lo soporte. Nada acaba en un archivo de configuración, el acceso sigue a tu cuenta, y revocarlo es una acción normal de cuenta. Usa una clave cuando el cliente no tenga flujo OAuth, o cuando la conexión pertenezca a una máquina en lugar de a una persona.

Mi cliente se conectó pero no encontró herramientas.

Casi siempre es la URL del Canal de Claude Code pegada donde corresponde la URL del servidor MCP. Ese endpoint es un transporte para sesiones de Claude Code y deliberadamente no registra herramientas. La dirección del servidor es la que está bajo Conectar.

Cursor dice "unauthorized" y nada más.

Algunas versiones de Cursor nunca muestran el aviso de OAuth y fallan silenciosamente. Usa la forma con clave API con la cabecera X-API-Key en su lugar; funciona en todas las versiones.

¿Pueden conectarse varias personas a la vez?

Sí. Cada persona se autentica como sí misma, así que lo que hacen se les atribuye, y las sesiones son independientes — que una persona cambie de espacio de trabajo no mueve a nadie más. Donde una superficie tiene límites basados en roles, como el tablero de tareas o la configuración del espacio de trabajo, se aplican a quien esté llamando.

¿Qué pasa cuando revoco una clave?

Toda integración que la use se detiene inmediatamente, y no hay deshacer. Da a las máquinas sus propias claves para que revocar una no derribe al resto.

¿Puedo conectar mis propios servidores MCP al revés?

Sí, y esa es una función separada: a un agente se le puede dar cualquier servidor MCP o API HTTP que conectes, y esas herramientas se sitúan junto a las nuestras al mismo nivel. Esta guía trata de la dirección opuesta — tu asistente accediendo a DialogBrain.