Ir al contenido principal

Añadir un servidor MCP propio

Con un servidor MCP propio conectas AI-School a una aplicación propia, una fuente de datos o un servicio especializado. Primero elige qué transporte se adapta al lugar de uso.

Elige el transporte adecuado​

TransporteWebMóvilEscritorioUso
Streamable HTTPSíSíSíRecomendado para servidores alojados
stdioNoNoSíProcesos locales e integraciones de escritorio
SSESolo configuraciones existentesSolo configuraciones existentesSíTransporte obsoleto; para servidores nuevos, elige Streamable HTTP

Requisitos para Streamable HTTP​

Usa el endpoint público completo, incluido el path 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 a través de DNS público;
  • responder a un handshake initialize válido de MCP;
  • tener un conjunto explícito de herramientas permitidas.

Las direcciones locales, las direcciones de red privada y los endpoints de metadatos de la nube se bloquean. Por eso no puedes registrar un servidor en localhost desde la app web.

Añadir un servidor​

  1. Abre Preferencias → Tools.
  2. Elige Añadir Tools o Añadir servidor MCP. Este botón solo aparece si tienes acceso MCP.
  3. Revisa primero los presets disponibles.
  4. Elige Añadir yo mismo un servidor MCP.
  5. Rellena el nombre, el endpoint completo y el método de autenticación.
  6. Guarda la configuración y espera la comprobación de conexión.
  7. Activa el servidor para tu conjunto de herramientas predeterminado.

Un administrador también puede registrar un servidor para todo el entorno mediante Administración → Ajustes de AI → Tools → MCP.

Autenticación y secretos​

AI-School admite OAuth de conector y secretos estáticos. Los tokens OAuth, los refresh tokens, las claves API y las contraseñas se almacenan solo en el servidor. Un chat solo recibe el connectorId registrado, nunca la configuración secreta.

Si cambia la URL o la autenticación, la nueva configuración se vuelve a comprobar primero. Si esa comprobación falla, una configuración previamente aprobada puede seguir activa hasta que se resuelva el problema.

Permisos de herramientas​

Comparte solo las herramientas que los usuarios realmente necesiten. Un servidor MCP puede ofrecer acciones de lectura y de escritura, como eliminar archivos, enviar correo electrónico o modificar registros. AI-School filtra las herramientas descubiertas frente a la allowlist del lado del servidor, pero el administrador del servidor sigue siendo responsable de los scopes y la autorización adecuados.

Probar localmente​

Un servidor local stdio se prueba en la app de escritorio. El renderizador no puede iniciar comandos de shell arbitrarios: la instalación se realiza mediante un preset aprobado o el flujo seguro de escritorio. El comando, los argumentos, las claves de entorno y el acceso solicitado se muestran antes de la instalación.

Solución de problemas​

  • El endpoint no es accesible: comprueba HTTPS, DNS, firewall y el path completo /mcp.
  • Se requiere reconexión: renueva el permiso OAuth o el secreto guardado.
  • Pertenece a otro entorno: registra de nuevo el conector dentro del entorno actual.
  • No se ven herramientas: comprueba la allowlist de herramientas, tu acceso MCP y si el servidor está activo.
  • Solo funciona en escritorio: probablemente el servidor usa stdio o una dirección local.

Recursos de desarrollo​

Ver también​

Al editar, se recupera la configuración registrada del servidor. La clave guardada permanece oculta: deja el campo de la clave vacío para conservarla. Si la URL o el método de autenticación son distintos, es necesario volver a vincular. Un error en una herramienta MCP no significa que todas las herramientas de ese servidor sean inaccesibles.

En esta página