Saltar al contenido principal

Conectar otro cliente MCP

Senso MCP cumple con el estándar MCP: su sitio no está limitado a un único asistente. Cualquier cliente compatible puede conectarse de la misma manera.


Cliente MCP genérico

Un cliente MCP genérico se comunica con el servidor mediante HTTP y se autentica a través de OAuth. Gracias a los documentos de descubrimiento .well-known, configura la autenticación automáticamente a partir de la URL del servidor.

Parámetros necesarios

  • la URL del servidor MCP: https://su-sitio.tld/api/index.php/v1/mcp;
  • el transporte: HTTP streamable (no se utiliza el transporte SSE, más antiguo);
  • la autenticación: OAuth, cuyo descubrimiento se realiza automáticamente (no hay nada que introducir), o un token de API de Joomla (véase más abajo).

Ejemplo de configuración

La mayoría de los clientes aceptan una configuración de este tipo:

{
  "mcpServers": {
    "mi-sitio-joomla": {
      "url": "https://su-sitio.tld/api/index.php/v1/mcp"
    }
  }
}

Consulte la documentación de su cliente para conocer la ubicación exacta de este ajuste.

¿Token de API u OAuth?

Coexisten dos modos de autenticación, destinados a dos usos diferentes:

  • OAuth — para los asistentes interactivos (Claude, ChatGPT, Copilot…). El usuario se identifica en su sitio, elige los ámbitos que concede y puede revocar la conexión en cualquier momento. No es necesario copiar ningún secreto.
  • Token de API de Joomla — para automatizaciones y servidores (n8n, Make, Zapier, scripts). El token se crea en el perfil del usuario, en la pestaña Token de API, y se envía en la cabecera Authorization: Bearer <token>. La cuenta debe tener el permiso API Login. Un token da acceso a todas las herramientas autorizadas por el ACL de la cuenta, sin pantalla de consentimiento: resérvelo para una cuenta específica y aplique el principio del menor privilegio.

Llamada directa mediante JSON-RPC

MCP no es más que JSON-RPC sobre HTTP. Por tanto, una herramienta que no disponga de un cliente MCP, o un simple módulo « HTTP Request », puede llamar directamente al servidor. Para enumerar las herramientas disponibles:

curl -s -X POST "https://su-sitio.tld/api/index.php/v1/mcp" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Para llamar a una herramienta, en este caso la creación de un artículo:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_article",
    "arguments": {
      "title": "Mi artículo",
      "catid": 8,
      "body": "<p>Texto del artículo.</p>"
    }
  }
}

La respuesta de tools/list describe cada herramienta y el esquema JSON de sus argumentos: es la referencia que debe consultar para construir sus llamadas. Se aplican las mismas reglas que con un asistente: interruptores del sitio, ACL de la cuenta y modo de solo lectura.