Conectar asistentes de IA (MCP) #

Your AI Connector incluye un servidor MCP oficial — un endpoint del Protocolo de Contexto de Modelo que permite a asistentes de IA como Claude Code, Claude Desktop, Cursor y tus propias aplicaciones controlar tu cuenta de Your AI Connector directamente. Pregunta en lenguaje sencillo (“lista mis agentes de IA”, “añade este lead”, “¿cuánto me ha costado la IA esta semana?”) y el asistente llamará a la API de Your AI Connector por ti.

Es la misma API v1 a la que accede con una clave 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, la API v1: contactos, mensajes, campañas, agentes de IA, funciones personalizadas, base de conocimientos, citas, análisis, etiquetas, listas, difusiones, acuerdos, conexiones de canales y subcuentas. Las automatizaciones se pueden listar y leer, pero aún no se pueden crear ni editar a través de MCP; créelas en la aplicación. 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.

• Endpoint: https://mcp.youraiconnector.com/mcp
• Autenticación: tu clave de API Your AI Connector (enviada como el encabezado X-API-Key)
• Requiere: 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 ai-connector https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Luego ejecuta /mcp dentro de Claude Code para confirmar que muestra ai-connector ✓ connected.

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": {
    "ai-connector": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop #

Añade el servidor como un conector personalizado. Se configura en tu cuenta de Claude, por lo que funciona tanto en Claude Desktop como en claude.ai (las cuentas gratuitas de Claude pueden añadir un conector personalizado).

1. Abre Customize → Connectors, haz clic en + Add y luego en Add custom connector.
2. Asígnale un nombre e introduce https://mcp.youraiconnector.com/mcp como URL.
3. En Authentication, elige No sign in. El servidor MCP no tiene página de inicio de sesión: elegir una opción de inicio de sesión terminará en “Couldn’t register with … sign-in service”.
4. En Request headers, añade una cabecera llamada X-API-Key con tu clave de API como valor.
5. Haz clic en Add. Las herramientas Your AI Connector aparecerán en el menú de herramientas de un chat nuevo.

¿No aparece el campo Request headers? Tu versión de Claude Desktop es antigua: actualízala o utiliza el archivo de configuración en su lugar. El archivo de configuración (claude_desktop_config.json, Settings → Developer → Edit Config) solo ejecuta programas en tu ordenador e ignora una entrada url, por lo que necesita el pequeño puente mcp-remote, que requiere Node.js 18 o superior:

{
  "mcpServers": {
    "ai-connector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.youraiconnector.com/mcp",
        "--header",
        "X-API-Key:${AI_CONNECTOR_KEY}"
      ],
      "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
    }
  }
}

Mantén X-API-Key:${AI_CONNECTOR_KEY} exactamente como está escrito, sin espacio después de los dos puntos (en Windows, un espacio divide la cabecera), y pon tu clave solo en env. Luego cierra completamente Claude Desktop (en Windows, haz clic derecho en el icono de la bandeja del sistema → Quit) y ábrelo de nuevo.

ChatGPT #

ChatGPT no puede conectarse al servidor MCP en este momento. Su formulario de conector personalizado solo ofrece OAuth o Sin autenticación, y el servidor MCP de Your AI Connector inicia sesión con tu clave de API, enviada como encabezado de solicitud. Elegir OAuth falla con “no se pudieron descubrir los ajustes de OAuth”, y Sin autenticación es rechazado porque cada solicitud necesita la clave.

Utiliza un asistente que te permita establecer un encabezado de solicitud en su lugar: Claude Code, Claude Desktop, Cursor u otro cliente MCP, o la API de Claude.

ChatGPT aún puede leer la documentación de ayuda sin conexión: consulta La documentación de ayuda está integrada para los archivos públicos de llms.txt.

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). Agrega un servidor ai-connector que apunte a https://mcp.youraiconnector.com/mcp y pega tu 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 Your AI Connector sin necesidad de un cliente independiente:

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my AI agents" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "ai-connector",
      "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:

• Agentes de IA: listar, crear, actualizar, pausar/reanudar, inspeccionar configuración.
• 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.
• Analítica: estadísticas de mensajes, uso de créditos, coste de la 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 ha costado la IA para cada uno de mis clientes esta semana?”
• “¿Cuál es el estado de los canales de Northside Dental y cuántos chats se han recibido esta semana?”

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 funciona de la misma manera. Todas las acciones que aceptan una cuenta de cliente en la API están disponibles para un cliente designado: configurar agentes de IA, base de conocimientos, funciones personalizadas, plantillas de WhatsApp, puntos de entrada, conexiones de canales, contactos, etiquetas, difusiones, citas, tratos y tareas, y enviar mensajes. Las excepciones son las acciones a nivel de agencia, que siempre se ejecutan en su propia cuenta de agencia: gestionar las cuentas de los clientes (límites, funciones, precios, pausas), instantáneas, su equipo y claves de API. Agregar contactos a la lista de un cliente o eliminarlos de ella aún no está disponible para un cliente designado; hágalo desde la propia clave de ese cliente o en su cuenta. La guía de la API de agencia enumera lo que es compatible.

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.

Probar el agente de un cliente #

Pídale al asistente que pruebe el agente de un cliente (“envía ‘¿hacen entregas los domingos?’ al agente de Panadería del cliente X y muéstrame qué hizo”). Envía un mensaje de prueba (Try Out) con su clave de agencia y el sub_account_id del cliente, espera y lee la respuesta además de cualquier acción que haya realizado el agente. No se necesita una copia del agente. Si el asistente dice que usted no tiene una cuenta de agencia, es porque está conectado con la clave de un cliente: vuelva a conectarlo con la clave de su cuenta de agencia. Consulte Probar.

Clientes con un límite de herramientas #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

La documentación de ayuda está integrada #

El servidor MCP proporciona al asistente tu cuenta y esta documentación. Tres herramientas leen la documentación de ayuda en tiempo real, por lo que el asistente puede consultar cómo funciona una función o qué ha cambiado recientemente, en lugar de adivinar:

• docs_search: encuentra las secciones que responden a una pregunta y las devuelve con el enlace a la página.
• docs_read: lee una página completa o una sección de ella.
• docs_list: enumera todas las páginas por área.

No hay nada que configurar y las herramientas de documentación nunca acceden a los datos de tu cuenta. Pregunta “¿cómo funcionan los puntos de entrada?” o “¿qué hay de nuevo en las automatizaciones?” y el asistente buscará primero en la documentación. Debido a que las herramientas leen el propio sitio de ayuda, una función es conocida por tu asistente tan pronto como se publica su guía.

Un asistente que no esté conectado a través de MCP aún puede leer la documentación: apúntalo a 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 necesitan clave y se reconstruyen con cada cambio en la documentación.

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 #

• “Connection refused” o “not found” — a la dirección le falta /mcp al final. Usa https://mcp.youraiconnector.com/mcp, no https://mcp.youraiconnector.com.
• Needs authentication / 401 — tu clave de API falta o es incorrecta. Vuelve a añadir el servidor con una X-API-Key válida.
• “Could not discover OAuth settings” (ChatGPT) — ChatGPT solo admite OAuth o sin autenticación para conectores personalizados, y el servidor MCP utiliza una clave de API, por lo que ChatGPT no puede conectarse por ahora. Consulta ChatGPT.
• “Couldn’t register with … sign-in service” o “add an OAuth Client ID” (Claude Desktop) — el conector personalizado se añadió con una opción de inicio de sesión. No hay ningún ID de cliente OAuth que introducir: elimina el conector y añádelo de nuevo con Authentication → No sign in y tu clave de API como cabecera de solicitud X-API-Key, como en Claude Desktop.
• Claude Desktop no muestra herramientas después de editar el archivo de configuración — el archivo de configuración ignora una entrada "url"; utiliza el conector personalizado o el formulario mcp-remote en Claude Desktop, y cierra y vuelve a abrir la aplicación por completo.
• Una herramienta devuelve 403 — tu 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.
• Tool not found — la lista de herramientas se genera en vivo desde la API, por lo que siempre coincide con la versión actual; vuelve a conectar para actualizar.
• Una advertencia de seguridad o certificado en tu propio dominio — apuntar un registro DNS hacia nosotros no es suficiente por sí solo: el subdominio también debe ser verificado en el panel de control antes de que pueda servir 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 Custom domain en Settings → White Labeling — añade primero el CNAME en tu registrador, luego introduce el nombre de host en el bloque MCP domain (AI assistants) y haz clic en Verify, el mismo flujo que tus otros subdominios de marca. La dirección de marca omite las herramientas de agencia; sigue usando la dirección estándar sin marca para esas. Hasta que tu dirección de marca sea verificada, utiliza la dirección estándar sin marca: 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.