Añadir un servidor MCP propio
Con un servidor MCP propio conecta AI-Corporate con una aplicación interna, fuente de datos o 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.example.com/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 adecuados para la organización.
- 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-Corporate soporta connector-OAuth y secretos estáticos. Tokens OAuth, tokens de refresco, claves API y contraseñas se almacenan solo en el servidor. Un chat recibe únicamente 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 permanecer activa hasta que se resuelva el problema.
Permisos de herramientas y gobernanza
Solo habilite herramientas que los empleados realmente necesiten. Un servidor MCP puede ofrecer acciones de lectura y escritura. AI-Corporate filtra las herramientas detectadas contra una lista blanca del lado servidor y verifica tenant, 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 de escritorio locales
Un servidor stdio local se instala en la app de escritorio. El renderer no puede iniciar comandos shell arbitrarios: 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. - 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 lista blanca, acceso por rol y estado activo.
- Funciona solo en escritorio: probablemente el servidor usa stdio o una dirección local.
