# 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](../api/getting-started.md), 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 →](api-access.md#generating-your-api-key) > 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 ```bash 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: ```json { "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: ```json { "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: ```json { "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](../agency/api-for-agencies.md), 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.dmchamp.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.dmchamp.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](../api/getting-started.md#reading-these-docs-as-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](api-access.md#generating-your-api-key) 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](api-access.md) — genera o rota la clave que utiliza esta conexión. - [Webhooks](webhooks.md) — la contraparte basada en push de esta conexión MCP basada en pull.