Añadir un servidor MCP propio
Con un servidor MCP propio conecta AI-Public con un sistema de casos, archivo, fuente de datos u otro servicio especializado. Primero elija el transporte que se adapte al lugar de uso.
Elija 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 elija Streamable HTTP |
Requisitos para Streamable HTTP
Use el endpoint público completo, incluyendo la ruta MCP, por ejemplo:
https://mcp.organisatie.nl/mcp
El endpoint debe usar HTTPS, ser accesible sin redirección a través de DNS público y responder un handshake MCP initialize válido. Los nombres de usuario y contraseñas no deben estar en la URL. Se bloquean direcciones locales, direcciones de red privada y endpoints de metadatos en la nube.
Añadir un servidor
- Abra Preferencias → Herramientas.
- Elija Agregar herramientas o Agregar servidor MCP.
- Revise los presets disponibles.
- Seleccione Agregar un servidor MCP propio.
- Complete nombre, endpoint completo y método de autenticación.
- Guarde la configuración y espere la comprobación de conexión.
- Active el servidor para su conjunto de herramientas predeterminado.
Un administrador puede registrar un servidor para todo el entorno vía Administración → Herramientas → MCP.
Autenticación y secretos
AI-Public soporta connector-OAuth 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 la autenticación, la nueva configuración se verifica primero. Si la verificación falla, una configuración aprobada previamente puede seguir activa hasta que se resuelva el problema.
Permisos de herramientas y seguridad de la información
Solo habilite herramientas que los usuarios realmente necesiten. Un servidor MCP puede ofrecer acciones de lectura y escritura. AI-Public filtra las herramientas detectadas contra una lista blanca del lado servidor y verifica entorno, propietario y rol en cada uso. La organización sigue siendo responsable de los scopes adecuados, registro, períodos de retención y autorización en el sistema origen.
Servidores locales de escritorio
Un servidor stdio local se instala en la aplicación de escritorio. Comando, argumentos, claves de entorno y accesos solicitados se limitan y muestran antes de la aprobación. Los secretos se cifran localmente.
Solución de problemas
- Endpoint no accesible: verifique HTTPS, DNS, firewall y la ruta completa
/mcp. - Se requiere reconexión: renueve el permiso OAuth o el secreto almacenado.
- Pertenece a otro entorno: registre el conector nuevamente en el entorno actual.
- No se ven herramientas: verifique la lista blanca, acceso por rol y estado activo.
- Funciona solo en escritorio: probablemente el servidor usa stdio o una dirección local.
