Añadir un servidor MCP propio
Con un servidor MCP propio conectas AI-School con una aplicación propia, fuente de datos o servicio especializado. Primero elige el transporte que se adapte al lugar de uso.
Elige el transporte correcto
| Transporte | Web | Móvil | Escritorio | Uso |
|---|---|---|---|---|
| Streamable HTTP | Sí | Sí | Sí | Recomendado para servidores alojados |
| stdio | No | No | Sí | Procesos locales e integraciones de escritorio |
| SSE | Solo configuraciones existentes | Solo configuraciones existentes | Sí | Transporte obsoleto; para servidores nuevos elige Streamable HTTP |
Requisitos para Streamable HTTP
Usa el endpoint público completo, incluyendo la ruta MCP, por ejemplo:
https://mcp.example.nl/mcp
El endpoint debe:
- Usar HTTPS;
- funcionar sin nombre de usuario ni contraseña en la URL;
- no requerir redirección;
- ser accesible vía DNS pública;
- responder un handshake MCP
initializeválido; - tener un conjunto explícito de herramientas permitidas.
Las direcciones locales, direcciones de red privada y endpoints de metadatos en la nube están bloqueados. Por ello, no puedes registrar un servidor en localhost desde la webapp.
Añadir un servidor
- Abre Preferencias → Herramientas.
- Elige Añadir herramientas o Añadir servidor MCP.
- Primero revisa los presets disponibles.
- Selecciona Añadir un servidor MCP propio.
- Rellena nombre, endpoint completo y método de autenticación.
- Guarda la configuración y espera la comprobación de conexión.
- Activa el servidor para tu conjunto de herramientas por defecto.
Un administrador puede registrar un servidor para todo el entorno vía Administración → Configuración AI → Herramientas → MCP.
Autenticación y secretos
AI-School soporta OAuth de conector y secretos estáticos. Los tokens OAuth, tokens de refresco, claves API y contraseñas se almacenan solo en el servidor. Un chat recibe solo el connectorId registrado, nunca la configuración secreta.
Si cambia la URL o autenticación, la nueva configuración se verifica primero. Si la verificación falla, una configuración aprobada previamente puede seguir activa hasta resolver el problema.
Permisos de herramientas
Solo habilita las herramientas que los usuarios realmente necesitan. Un servidor MCP puede ofrecer acciones de lectura y escritura, como eliminar archivos, enviar correos o modificar registros. AI-School filtra las herramientas detectadas contra la lista blanca del servidor, pero el administrador del servidor sigue siendo responsable de los scopes y autorizaciones adecuadas.
Pruebas locales
Un servidor stdio local se prueba en la app de escritorio. El renderer no puede iniciar comandos shell arbitrarios: la instalación se realiza mediante un preset aprobado o el flujo seguro de escritorio. Comando, argumentos, claves de entorno y accesos solicitados se muestran antes de la instalación.
Solución de problemas
- Endpoint no accesible: verifica HTTPS, DNS, firewall y la ruta completa
/mcp. - Se requiere reconexión: renueva el permiso OAuth o el secreto almacenado.
- Pertenece a otro entorno: registra el conector de nuevo en el entorno actual.
- No se ven herramientas: revisa la lista blanca de herramientas, tu acceso MCP y que el servidor esté activo.
- Funciona solo en escritorio: probablemente el servidor usa stdio o una dirección local.
