Saltar al contenido
Verificada

Conectar un cliente de IA mediante MCP

Añade Xuda como servidor MCP remoto a Claude, Cursor o cualquier otro cliente compatible con MCP.

Esta página trata del lado del cliente: conseguir que Claude, Cursor o cualquier otra cosa que hable MCP se comunique con tu cuenta de Xuda. Para el protocolo en sí, la nomenclatura de las herramientas, el ciclo de vida de la sesión y la forma de los errores, consulta MCP.

Lo que necesitas

Una sola cosa: una clave de API. Crea una desde el área de Desarrolladores de la cuenta (el acceso completo llega a todo lo que puede el propietario de la clave, el acceso personalizado llega solo a un conjunto permitido de métodos), consulta Autenticación. No hay una credencial MCP aparte: la misma clave funciona por REST simple en /cpi/<method> y por MCP.

Un endpoint para todas las claves

Todas las claves de API de la cuenta, y la clave emitida automáticamente por cada caja Full Stack VPS, apuntan a la misma dirección: https://xuda.ai/mcp. La clave de una Full Stack VPS expone además las herramientas de plugin instaladas en esa caja junto con los métodos del ecosistema, consulta Full Stack VPS.

Conectar un cliente

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Cursor lee su fragmento desde .cursor/mcp.json (proyecto) o desde sus ajustes MCP globales. Claude Desktop y claude.ai añaden un servidor remoto desde Ajustes, en Conectores: un nombre, la URL y la misma cabecera Authorization. Cualquier otro cliente MCP necesita solo los mismos dos datos: un endpoint HTTP de streaming en https://xuda.ai/mcp, y la clave en cada solicitud como Authorization: Bearer YOUR_API_KEY.

El panel lo escribe por ti

La página Desarrolladores, Claves de API de cada cuenta tiene una tarjeta Conectar bajo la lista de claves. Su selector de formato cambia un bloque entre .env, Next.js, MCP, cURL, Node.js y PHP, cada uno ya relleno con el endpoint y la primera clave de la lista, que el encabezado del bloque nombra. El formato .env lleva XUDA_MCP_URL junto a la base REST y la clave, y el formato MCP es el comando de Claude Code anterior. La clave se muestra oculta hasta que la reveles; Copiar siempre toma el valor real.

Lo que obtiene el agente al conectar

La primera solicitud de una conexión nueva es una llamada MCP initialize. La respuesta de Xuda lleva un campo instructions construido a partir de la guía LLM de Studio, el mismo modelo de documentos de prog, la referencia de atributos xu-* y las reglas de flujo de trabajo que se tratan en esa página, combinados a partir de los registros vivos de la propia plataforma para que nunca pueda describir una regla que el validador desplegado no aplique realmente. La mayoría de los clientes MCP reenvían instructions directamente al contexto del modelo, así que el agente ya sabe cómo se monta un prog de Studio antes de su primera llamada a una herramienta, sin necesidad de una sesión informativa aparte.

Vale la pena llamar directamente a dos herramientas en lugar de depender de lo que llegó al conectar: get_studio_guide vuelve a leer cualquier tema bajo demanda (components, tables, programs, javascript, attributes, anatomy, gotchas), y get_prog_examples devuelve progs de ejemplo seleccionados y funcionales sobre los que modelar una construcción.

Un endpoint dedicado para un programa de API

Los métodos anteriores son el catálogo completo de la cuenta detrás de una clave. Cuando quieres que un sistema externo llegue exactamente a un endpoint de un proyecto, despliégalo: Desplegar > Despliegues > Servidor lista Servidor MCP junto a Cron, Api, Node y Emitter. Su paso Ajustes de inicio elige uno de los propios programas api del proyecto como destino, y después los pasos habituales de centro de datos, nivel de rendimiento y nombre lo publican como su propio endpoint. Consulta Tu primer despliegue para las partes compartidas de ese asistente, y API para saber qué es un programa api.

Tipo de despliegue en beta

mcp figura hoy entre los tipos de despliegue en beta de la plataforma, junto con router, android y emitter.