DM Champ Docs

Conectar asistentes de IA (MCP)

DM Champ incluye un servidor MCP oficial: un punto de conexión del Protocolo de Contexto de Modelo (Model Context Protocol) que permite a asistentes de IA como Claude Code, Claude Desktop, ChatGPT, Cursor y sus propias aplicaciones controlar su cuenta de DM Champ directamente. Pregunte en lenguaje sencillo (“lista mis campañas activas”, “añade este cliente potencial”, “¿cuánto me ha costado la IA esta semana?”) y el asistente llamará a la API de DM Champ por usted.

Es la misma API v1 documentada en la sección de API, autenticada con su propia clave de API. El servidor MCP crea una herramienta para cada operación en nuestra especificación de API publicada, por lo que cubre la mayor parte, aunque no toda, de la API v1: contactos, mensajes, campañas, agentes de IA, base de conocimientos, citas, análisis, etiquetas, listas y subcuentas. Las difusiones, automatizaciones y tratos aún no están disponibles como herramientas MCP; utilice la API REST directamente para ellos. Dentro de lo que expone, no hay permisos por herramienta ni un valor predeterminado de solo lectura, por lo que la clave de API es el control de acceso completo.

  • Punto de conexión: https://mcp.youraiconnector.com/mcp
  • Autenticación: su clave de API de DM Champ (enviada como el encabezado X-API-Key)
  • Requisitos: un plan con acceso a la API. Crear una clave de API →

Su clave de API actúa en su propia cuenta, con los mismos permisos que el resto de la API, y puede leer las cuentas de cliente que usted gestiona, si tiene un plan de agencia (ver más abajo). Trátela como una contraseña. Puede revocarla en cualquier momento desde Configuración → Integraciones → Clave de API, lo que corta instantáneamente el acceso del asistente.

Claude Code 

claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Luego ejecute /mcp dentro de Claude Code para confirmar que muestra dm-champ ✓ conectado.

De forma predeterminada, el servidor se añade en el ámbito local (solo usted, este proyecto). Utilice --scope user para que esté disponible en todos sus proyectos, o --scope project to commit it to a repo’s .mcp.json para su equipo:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop

Edite su claude_desktop_config.json (Configuración → Desarrollador → Editar configuración) y añada:

{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Reinicie Claude Desktop. Las herramientas de DM Champ aparecerán en el menú de herramientas.

ChatGPT

Los conectores MCP personalizados están disponibles en ChatGPT Business, Enterprise y Pro. El propietario o administrador del espacio de trabajo debe activar primero el modo desarrollador / conectores personalizados en la configuración del espacio de trabajo; sin esto, la opción para crear un conector nunca aparecerá.

Luego, crea el conector con:

  • URL: https://mcp.youraiconnector.com/mcp
  • Autenticación: Encabezados personalizados
  • Nombre del encabezado: X-API-Key
  • Valor del encabezado: su clave de API de DM Champ

La URL debe terminar en /mcp. Pegar solo https://mcp.youraiconnector.com es el error más común: ChatGPT comprueba esa dirección exacta, no encuentra nada allí y muestra “Unable to add connector URL”.

Cursor y otros clientes MCP

La mayoría de los editores compatibles con MCP utilizan la misma forma .mcp.json que se muestra arriba (un servidor HTTP con un url y un encabezado X-API-Key). Añada un servidor dm-champ que apunte a https://mcp.youraiconnector.com/mcp y pegue su clave de API en el encabezado.

La API de Claude (intégrela en su propia aplicación)

Puede conectar el servidor MCP mediante programación con el conector MCP de la API de Claude, de modo que un agente que usted cree pueda utilizar las herramientas de DM Champ sin necesidad de un cliente independiente:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

Qué puedes hacer

Dentro de la parte de la API v1 que expone el servidor MCP, el asistente elige la herramienta adecuada automáticamente:

  • Campañas: listar, crear, actualizar, pausar/reanudar, inspeccionar la configuración del bot.
  • Contactos: buscar, crear, etiquetar, añadir a listas, importar.
  • Base de conocimientos / Preguntas frecuentes: añadir, editar, importar masivamente, aprobar sugerencias de IA.
  • Mensajes: leer conversaciones, enviar un mensaje a un contacto.
  • Citas: listar, reservar, cancelar.
  • Tareas: crear, completar, listar.
  • Análisis: estadísticas de mensajes, uso de créditos, coste de IA.
  • Canales: comprobar el estado de la conexión, iniciar un flujo de conexión.

Preguntar sobre las cuentas de sus clientes (agencias)

Una conexión cubre todas las cuentas que usted gestiona. No es necesario añadir una segunda conexión por cliente: en un plan de agencia, el asistente puede leer cualquier cuenta de cliente bajo su gestión, por lo que puede preguntar sobre todas ellas en una misma conversación.

Simplemente mencione al cliente:

  • “¿Cuántos contactos tiene Bella’s Bistro?”
  • “¿Cuánto le costó la IA a cada uno de mis clientes esta semana?”
  • “¿Qué campañas están activas para Northside Dental y cuál es el estado de sus canales?”

Esto cubre la lectura de contactos, mensajes, chats, campañas, citas, tareas, etiquetas, eventos, preguntas frecuentes, fuentes de la base de conocimientos, números de teléfono, canales, webhooks y análisis. Verificamos que la cuenta sea realmente suya antes de ejecutar cualquier acción; si solicita una que no lo es, se devolverá como “no encontrada”. Si no menciona al cliente, el asistente leerá su propia cuenta, exactamente como antes.

Cambiar la cuenta de un cliente es más limitado. Configurar agentes de IA, funciones personalizadas, plantillas de WhatsApp, puntos de entrada, conexiones de canales, estado de campañas y comprar un número funcionan para un cliente específico; la mayoría de las otras acciones de escritura siguen ejecutándose en su propia cuenta, así que realice esas desde la propia clave del cliente o desde la REST API, que cubre más.

Esta es también la respuesta para un cliente que gestiona varios negocios bajo un mismo inicio de sesión. Asigne a cada negocio su propia cuenta y luego invite al correo electrónico del cliente como miembro del equipo en todas ellas: iniciarán sesión una vez y cambiarán entre sus marcas con el selector de cuentas en la barra lateral.

Proporcionar a su asistente los documentos de ayuda

El servidor MCP le da a un asistente su cuenta; no le proporciona esta documentación. Si también desea que responda correctamente a preguntas del tipo “¿cómo hago para…?”, asígnele https://docs.youraiconnector.com/llms.txt (un índice de cada página de ayuda con un enlace a la versión Markdown de cada página) o https://docs.youraiconnector.com/llms-full.txt (toda la documentación en un solo archivo Markdown). Ambos son públicos, no requieren clave y se reconstruyen con cada cambio en la documentación. Consulte Leer estos documentos como Markdown.

Cómo encontrar o generar tu clave de API

La clave de API que utiliza esta conexión se encuentra en Ajustes → Integraciones → Clave de API, su propia sección, separada de los Webhooks. Consulta Acceso a la API para ver los pasos exactos.

Solución de problemas

  • “Unable to add connector URL” (ChatGPT) / “connection refused” — a la dirección le falta /mcp al final. Use https://mcp.youraiconnector.com/mcp, no https://mcp.youraiconnector.com.
  • Needs authentication / 401 — su clave de API falta o es incorrecta. Vuelva a añadir el servidor con una X-API-Key válida.
  • Una herramienta devuelve 403 — su plan o rol de equipo no permite esa acción; el servidor MCP no impone nada adicional, es la misma comprobación de permisos que la API.
  • Herramienta no encontrada — la lista de herramientas se genera en tiempo real desde la API, por lo que siempre coincide con la versión actual; vuelva a conectar para actualizar.
  • Una advertencia de seguridad o de certificado en su propio dominio — apuntar un registro DNS hacia nosotros no es suficiente por sí solo: el subdominio también debe verificarse en el panel de control antes de que pueda ofrecer una conexión segura. Las agencias de marca blanca pueden poner la dirección MCP en su propio dominio (p. ej. mcp.youragency.com) desde la tarjeta Dominio personalizado en Configuración → Marca blanca — añada primero el CNAME en su registrador, luego introduzca el nombre de host en el bloque Dominio MCP (asistentes de IA) y haga clic en Verificar, el mismo flujo que sus otros subdominios de marca. Hasta que se verifique, utilice la dirección estándar de arriba; no tiene marca, por lo que es seguro compartirla con los clientes.

Próximos pasos

  • Acceso a la API — genera o rota la clave que utiliza esta conexión.
  • Webhooks — la contraparte basada en push de esta conexión MCP basada en pull.