Añadir un servidor MCP propio
Con un servidor MCP propio, conecta AI-Corporate con una aplicación interna, una fuente de datos o un servicio especializado. Primero elige qué transporte se adapta al lugar de uso.
Elegir 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 servidores nuevos elige Streamable HTTP |
Requisitos para Streamable HTTP
Usa el endpoint público completo, incluido el path MCP, por ejemplo:
https://mcp.example.com/mcp
El endpoint debe usar HTTPS, estar accesible mediante DNS público sin redirección y responder a un handshake válido de MCP initialize. Los nombres de usuario y contraseñas no deben ir en la URL. Las direcciones locales, las direcciones de red privadas y los endpoints de metadatos de la nube están bloqueados.
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 adecuados para la organización.
- Elige Añadir tu propio servidor MCP.
- 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 a través de Administración → Tools → MCP.
Autenticación y secrets
AI-Corporate admite OAuth de connector y secrets estáticos. Los tokens OAuth, refresh tokens, claves API y contraseñas se almacenan en almacenamiento exclusivo del 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 comprueba de nuevo primero. Si esa comprobación falla, una configuración previamente aprobada puede seguir activa hasta que se resuelva el problema.
Permisos de tools y gobernanza
Concede solo las tools que los empleados realmente necesiten. Un servidor MCP puede ofrecer acciones de lectura y escritura. AI-Corporate filtra las tools detectadas mediante una allowlist del lado del servidor y verifica tenant, propietario y rol en cada uso. La organización sigue siendo responsable de los scopes adecuados, el registro, los periodos de retención y la autorización en el sistema de origen.
Servidores locales de escritorio
Un servidor stdio local se instala en la app de escritorio. El renderer no puede iniciar comandos shell arbitrarios: command, argumentos, claves de entorno y acceso solicitado se limitan y se muestran antes de la aprobación. Los secrets se cifran localmente.
Solución de problemas
- Endpoint no accesible: comprueba HTTPS, DNS, firewall y la ruta completa
/mcp. - Se requiere reconexión: renueva el consentimiento de OAuth o el secret almacenado.
- Pertenece a otro entorno: registra de nuevo el connector dentro del entorno actual.
- No se ven tools: 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 guardada permanece oculta: deja el campo de la clave vacío para conservarla. Si la URL o el método de autenticación cambian, hace falta volver a vincular. Un error en una sola tool MCP no significa que todas las tools de ese servidor sean inaccesibles.