Seguridad y privacidad

Principios

Las herramientas de los complementos pueden acceder a datos de los usuarios y a API de terceros, y realizar acciones de escritura. Trata cada servidor MCP y cada componente de la interfaz como software de producción:

• Mínimo privilegio: solicita solo los alcances de autorización, el acceso al almacenamiento y los permisos de red que necesites.
• Consentimiento explícito del usuario: asegúrate de que los usuarios sepan cuándo están vinculando cuentas u otorgando acceso de escritura. Usa las solicitudes de confirmación del host para las acciones destructivas.
• Defensa en profundidad: da por hecho que tu servidor recibirá intentos de inyección de prompts y entradas maliciosas. Valida cada entrada y conserva registros de auditoría.

Manejo de datos

• Contenido estructurado: incluye solo los datos necesarios para el prompt actual. Evita incluir secretos o tokens en las propiedades de los componentes.
• Almacenamiento: decide cuánto tiempo conservarás los datos de los usuarios y publica una Política de retención. Respeta las solicitudes de eliminación.
• Registros: oculta la información de identificación personal antes de escribir en los registros. Guarda los identificadores de correlación para la depuración, pero evita almacenar el texto original de los prompts salvo que sea necesario.

Inyección de prompts y acciones de escritura

Los servidores MCP personalizados permiten el acceso completo a MCP, incluidas las herramientas de escritura. Para reducir el riesgo:

• Revisa periódicamente las descripciones de las herramientas para desalentar el uso indebido (“No uses esta herramienta para eliminar registros”).
• Valida todas las entradas en el servidor, incluso si las proporcionó el modelo.
• Exige confirmación humana para las operaciones irreversibles.

Comparte con tu equipo de control de calidad los prompts que mejor te hayan servido para probar la inyección de prompts. Así, el equipo podrá detectar puntos débiles desde el principio.

Acceso a la red

Los widgets se ejecutan en un iframe aislado con una política de seguridad de contenido (CSP) estricta. No pueden acceder a las API privilegiadas del navegador, como window.alert, window.prompt, window.confirm o navigator.clipboard. La CSP controla las solicitudes estándar de fetch. De forma predeterminada, los frames anidados no están disponibles. Para habilitarlos, especifica los orígenes permitidos en los metadatos de la CSP del recurso, por ejemplo, en _meta.ui.csp.frameDomains. Los complementos pueden insertar páginas del dominio registrable de su propio servidor MCP, incluidos editores e interfaces de administración existentes. Consulta la política de iframes para conocer los requisitos de titularidad del dominio, justificación y revisión.

La CSP del widget limita los destinos que se pueden cargar en un iframe. Cada página insertada usa su propia CSP. Las listas de dominios permitidos connectDomains y resourceDomains del widget no restringen las solicitudes de red que se realizan desde esa página. Define orígenes específicos para los iframes e incluye la experiencia insertada en tu revisión de seguridad.

El código que se ejecuta en el servidor solo está sujeto a las restricciones de red que imponga tu entorno de alojamiento. Sigue las prácticas recomendadas habituales para las llamadas salientes (verificación de TLS, reintentos y tiempos de espera).

Autenticación y autorización

• Usa flujos de código de autorización de OAuth 2.1 al integrar cuentas externas. Da preferencia a los documentos de metadatos de ID de cliente (CIMD) cuando tu servidor de autorización admita CIMD y quien crea el complemento elija esa opción. Usa none para el intercambio de tokens de clientes públicos o private_key_jwt cuando tu servidor de autorización exija autenticar al cliente. Ofrece compatibilidad con DCR cuando quien crea el complemento elija esa opción o cuando CIMD no esté disponible.
• Verifica y aplica los alcances de autorización en cada llamada a una herramienta. Devuelve una respuesta 401 si el token está vencido o tiene un formato incorrecto.
• Si usas la identidad integrada, evita almacenar secretos de larga duración y usa el contexto de autenticación proporcionado.

Preparación para la operación

• Realiza revisiones de seguridad antes del lanzamiento, especialmente si manejas datos sujetos a regulación.
• Monitorea el tráfico para detectar patrones anómalos y configura alertas para errores recurrentes o intentos fallidos de autenticación.
• Mantén al día los parches de las dependencias de terceros, las bibliotecas y las herramientas de compilación para reducir los riesgos de la cadena de suministro.

La seguridad y la privacidad son fundamentales para la confianza de los usuarios. Incorpóralas desde el principio en tus flujos de trabajo de planificación, implementación y despliegue.