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.