Añadir un servidor MCP propio
Con un servidor MCP propio, conecta AI-Public con un sistema de gestión de casos, un archivo, una fuente de datos u otro servicio especializado. Primero, elige qué transporte se adapta al lugar de uso.
Elige el transporte adecuado
| 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 nuevos servidores, elige Streamable HTTP |
Requisitos para Streamable HTTP
Usa el endpoint público completo, incluido el path MCP, por ejemplo:
https://mcp.organizacion.nl/mcp
El endpoint debe usar HTTPS, ser accesible mediante DNS público sin redirección y responder a un handshake initialize válido de MCP. Los nombres de usuario y contraseñas no deben incluirse en la URL. Se bloquean direcciones locales, direcciones de red privada y endpoints de metadatos de la nube.
Añadir un servidor
- Abre Preferencias → Tools.
- Elige Añadir tools o Añadir servidor MCP. Este botón solo aparece si tienes acceso a MCP.
- Revisa los presets disponibles.
- Elige Añadir un servidor MCP propio.
- Completa el nombre, el endpoint completo y el 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 predeterminado.
Un administrador puede registrar un servidor para todo el entorno mediante Administración → Tools → MCP.
Autenticación y secretos
AI-Public admite OAuth de connector y secretos estáticos. Los tokens OAuth, los refresh tokens, las claves API y las contraseñas se almacenan en un almacenamiento exclusivo del servidor. Un chat solo recibe el connectorId registrado, nunca la configuración secreta.
Si cambian 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 y seguridad de la información
Comparte solo las herramientas que los usuarios realmente necesiten. Un servidor MCP puede ofrecer acciones de lectura y escritura. AI-Public filtra las herramientas detectadas frente a una allowlist del lado del servidor y verifica el entorno, el propietario y el rol en cada uso. La organización sigue siendo responsable de los scopes adecuados, el registro, los plazos de conservación y la autorización en el sistema de origen.
Servidores locales de escritorio
Un servidor local stdio se instala en la aplicación de escritorio. El comando, los argumentos, las claves de entorno y el acceso solicitado se limitan y se muestran antes de la aprobación. Los secretos se cifran localmente.
Solución de problemas
- Endpoint no accesible: comprueba HTTPS, DNS, firewall y la ruta completa
/mcp. - Es necesario volver a conectar: renueva el consentimiento OAuth o el secreto guardado.
- Pertenece a otro entorno: registra de nuevo el conector dentro del entorno actual.
- No se muestran herramientas: comprueba la allowlist, el acceso por rol y el estado 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 almacenada permanece oculta: deja vacío el campo de la clave para conservarla. Si la URL o el método de autenticación cambian, es necesario volver a vincular. Un error en una herramienta MCP no significa que todas las herramientas de ese servidor sean inaccesibles.