Conectores MCP gestionados
Los conectores MCP gestionados permiten que quienes administran agentes los conecten a un servidor MCP remoto. Crea un conector desde una plantilla o un endpoint HTTPS personalizado, pruébalo y selecciónalo en el paso MCP del agente.
Ruta rápida
- Abre Agents y usa la pestaña MCP.
- Elige una plantilla o añade un servidor MCP remoto personalizado.
- Introduce el secreto cuando sea necesario y usa Test connection.
- Selecciona el conector en el paso MCP del agente y guarda el agente.
Plantillas disponibles
| Plantilla | Finalidad | Autenticación |
|---|---|---|
| Context7 | Documentación y ejemplos de bibliotecas según su versión | Clave de API opcional |
| GitHub | Herramientas de repositorios, incidencias, pull requests y Actions | Requiere un token de acceso personal de GitHub |
| Scraper | Extracción, mapeo, rastreo y renderizado de sitios web públicos | Requiere un token Bearer |
GitHub usa de forma predeterminada acceso de solo lectura y un conjunto limitado de herramientas. Su endpoint y sus campos de autenticación son fijos en los conectores basados en plantilla.
Servidores remotos personalizados
Los conectores personalizados admiten URL https:// o http:// y uno de estos modos de autenticación: sin autenticación, token Bearer o encabezado personalizado. Las URL no pueden contener credenciales incrustadas.
Almirant valida las URL salientes de los conectores antes de guardarlas o actualizarlas. Rechaza destinos privados u otros no permitidos para reducir el riesgo de SSRF. Usa un endpoint HTTPS accesible públicamente siempre que sea posible.
Secretos y acceso
- Las credenciales del conector se cifran en el servidor.
- La interfaz de Agents solo indica que un conector tiene un secreto; no devuelve su valor.
- Los secretos se descifran únicamente para preparar una ejecución de un agente al que la persona propietaria puede acceder.
- La propiedad de los conectores está limitada al usuario dentro del espacio de trabajo activo.
- Una prueba de conexión devuelve el estado y datos de diagnóstico seguros, no el secreto ni el endpoint sin procesar en la respuesta de error.
Resolución de problemas
| Problema | Causa probable | Acción |
|---|---|---|
| La prueba falla antes de conectar | URL no válida, protocolo no compatible o destino bloqueado | Usa un endpoint MCP HTTP(S) externo válido. |
| No se puede guardar un conector autenticado | No se proporcionó ningún secreto | Proporciona el token Bearer o el valor del encabezado personalizado requerido. |
| No se puede cambiar una plantilla | El endpoint y la autenticación de la plantilla son inmutables | Crea un conector personalizado para otro servidor. |
| El agente no puede usar un conector | No se seleccionó en el paso MCP del agente | Selecciónalo, guarda el agente e inicia un trabajo nuevo. |