Propósito Esta guía ayuda a los administradores de plataforma/experiencia del desarrollador a planificar, implementar y operar Windsurf en organizaciones con grandes equipos empresariales. Es deliberadamente opinada y enlaza a documentos detallados de “cómo hacerlo” por tema. Úsala tanto como guía de lectura continua y como lista de verificación durante la incorporación.

---

	Detalles
Quién debería leerlo	Administradores de Plataforma / Dev‑Ex, TI corporativa, equipos de Herramientas Centralizadas
Conocimientos asumidos	Términos básicos de Windsurf (equipo, rol), conceptos de IdP de Enterprise (SAML, SCIM [Sistema para la Gestión de Identidades entre Dominios]), uso de la CLI
Fuera de alcance	Aspectos internos avanzados de seguridad y cumplimiento → consulta la documentación de Security & Compliance

---

1. Confirmar la configuración a nivel de organización
2. Configurar SSO (inicio de sesión único) (Okta, Azure AD, Google; consulte la documentación de SAML para otros)
3. Habilitar SCIM (Sistema para la Gestión de Identidades entre Dominios) y asignar grupos del IdP → teams de Windsurf
4. Definir el modelo de roles y permisos (principio de privilegio mínimo)
5. Configurar el Admin Portal: vista del equipo y controles de seguridad
6. Distribuir los clientes/extensiones de Windsurf a los usuarios finales
7. Ver los paneles de Analytics y los tokens de acceso de la API

Use esta lista como su registro de implementación del “Día 0”.

---

• Equipo – colecciones planas de miembros; sin equipos anidados. Los Teams (también llamados Grupos) impulsan la asignación de roles y la agrupación en Analytics, lo que te permite delimitar permisos y ver métricas de uso por cohorte.
• Roles y permisos – RBAC predefinido; los administradores son principalmente responsables de la gestión de equipos, la configuración de funciones de Windsurf y de Analytics. Los roles integrados suelen cubrir estas necesidades, pero crear un rol personalizado con el permiso analytics-view permite a los responsables y líderes de equipo ver métricas de sus propios equipos. (Documentación de RBAC)
• Portal de administración – interfaz centralizada para la gestión de usuarios y equipos, uso de créditos, configuración de SSO (inicio de sesión único), conmutadores de funciones (Web Search, MCP, Deploys), paneles de Analytics/exportación de informes, claves de servicio para uso de la API y controles de roles/permisos.
• Agentes y workspaces – el IDE de Windsurf y los plugins de JetBrains son agentivos

El portal de administración ofrece gestión centralizada de todas las funciones empresariales de Windsurf a través de una interfaz web intuitiva. Sus funciones principales incluyen:

• Agrega, elimina y administra usuarios en toda tu organización
• Configura equipos con las asignaciones de roles adecuadas
• Supervisión del estado y la actividad de los usuarios

• Configura la integración de SSO (inicio de sesión único) con los principales proveedores de identidad
• Configura el aprovisionamiento con SCIM (Sistema para la Gestión de Identidades entre Dominios) para la gestión automatizada del ciclo de vida de usuarios
• Administra el control de acceso basado en roles (RBAC)
• Crea y gestiona claves de servicio para automatizaciones de API con permisos con alcance definido

Importante: Estos controles de funciones afectan el comportamiento de toda tu organización y solo pueden ser modificados por administradores. Las nuevas funciones importantes con implicaciones de privacidad de datos se lanzan en estado “desactivado” de forma predeterminada para que tengas control sobre cuándo y cómo se habilitan.

El Portal de administración te ofrece control granular sobre las funciones de Windsurf que se pueden habilitar o deshabilitar por equipo. Nota sobre privacidad de datos: Algunas funciones requieren almacenar datos adicionales o telemetría, como se indica a continuación: Configuración de modelos

• Configura a qué modelos de IA pueden acceder tus equipos dentro de Windsurf
• Selecciona varios modelos para distintos casos de uso (autocompletado de código, Chat, etc.)

Ejecución automática de comandos en la terminal (Beta)

• Permite o restringe la capacidad de Cascade para ejecutar automáticamente comandos en las máquinas de los usuarios
• Más información sobre comandos ejecutados automáticamente

Servidores MCP (Beta)

• Permite que los usuarios configuren y utilicen servidores de Model Context Protocol (MCP)
• Mantén una lista de servidores MCP permitidos para integraciones aprobadas
• Nota de seguridad: Revisa las implicaciones operativas y de seguridad antes de habilitarlo, ya que MCP puede crear recursos de infraestructura fuera del monitoreo de seguridad de Windsurf
• Más información sobre Model Context Protocol (MCP)
• Controles de administrador de MCP para Teams y Enterprise

Implementaciones de aplicaciones (Beta)

• Administra los permisos de implementación para tus equipos en Cascade
• Más información sobre Implementaciones de aplicaciones

Compartir conversaciones

• Permite que los miembros del equipo compartan conversaciones de Cascade con otros
• Las conversaciones se cargan de forma segura en los servidores de Windsurf
• Los enlaces compartibles están restringidos a miembros del equipo que hayan iniciado sesión
• Más información sobre cómo compartir conversaciones

Revisiones de PR (integración con GitHub)

• Instala Windsurf en la organización de GitHub de tu equipo
• Habilita la automatización de revisiones de PR y la edición de descripciones
• Más información sobre Windsurf PR Reviews

Gestión de la base de conocimiento

• Selecciona y organiza conocimiento a partir de fuentes de Google Drive para tus equipos de desarrollo
• Sube y organiza documentación y recursos internos
• Más información sobre la base de conocimiento

---

Recomendación: Utiliza SSO (inicio de sesión único) junto con SCIM (Sistema para la Gestión de Identidades entre Dominios) siempre que sea posible para el aprovisionamiento automatizado, la baja de usuarios y la gestión de grupos.

	Guía
IdP compatibles	Okta, Azure AD, Google (otros mediante SAML genérico)
Enfoque recomendado	Crear una aplicación específica de Windsurf en el IdP; usar asignaciones de grupos basadas en roles en lugar del grupo All Employees a nivel de la organización
Errores comunes	Desajustes en el sufijo del correo, alias de usuario duplicados

Consulta la Guía de configuración de SSO y SCIM para obtener instrucciones paso a paso para Okta, Azure AD, Google y SAML genérico.

• Por qué – automatización del ciclo de vida de usuarios y gestión de membresías de equipos a escala
• Capacidades
  • Crear/desactivar usuarios automáticamente
  • Crear equipos automáticamente (o gestionar manualmente)
  • Los usuarios pueden pertenecer a varios equipos
  • Creación personalizada de equipos mediante la API de SCIM (docs)
• Estrategias de asignación
  • 1 grupo del IdP → 1 equipo de Windsurf (sencillo, el más común)
  • Prefijos de grupos funcionales vs. basados en proyectos (p. ej., proj-foo-devs)
• Decisiones a tomar
  • Qué grupos excluir (p. ej., becarios, contratistas)
  • Reglas de cambio de nombre cuando cambien los nombres de los grupos en el IdP
• Precaución: SCIM debe seguir siendo tu fuente de verdad; mezclar SCIM con actualizaciones manuales o por API puede generar desviaciones. Usa la API principalmente para agregar grupos complementarios.

---

• Estructura de equipo plana → diseñe cuidadosamente la taxonomía de equipos (sin anidamiento como respaldo)
• Los usuarios pueden pertenecer a múltiples grupos. Los grupos se utilizan para ver Analytics
• Actualmente, SCIM (Sistema para la Gestión de Identidades entre Dominios) no admite asignar roles a los usuarios. SCIM solo admite asignar usuarios a grupos

---

Panel	Caso de uso
Adoption Overview	Seguimiento de usuarios activos totales y participación diaria
Team Activity	Uso del equipo

Analytics muestra el porcentaje de código escrito por Windsurf, ayudando a cuantificar el impacto; consulta tus paneles en team analytics.

API	Escenarios típicos de administración
REST	Gestión de SCIM, Analytics

• Genera claves de servicio en Configuración del equipo → Claves de servicio. Limita el alcance de las claves al menor privilegio necesario.
• Para informes más avanzados, consulta la referencia de Analytics API.
• Para la gestión de equipos, consulta la API de SCIM – Teams personalizados.

---

• Páginas de estado – supervisa el estado del servicio en tiempo real: Windsurf, Anthropic, OpenAI
• Canales de soporte – windsurf.com/support

---

1. Indica a los usuarios finales la guía de instalación de Windsurf para instalar la extensión o el cliente de escritorio adecuado.
2. Publica una página interna “Primeros pasos con Windsurf” (enlace a la documentación oficial)
3. Realiza sesiones de onboarding en vivo / graba demostraciones breves
4. Prepara plantillas de proyecto iniciales y ejemplos de prompts
5. Recopila comentarios mediante una encuesta después de 2 semanas; itera

---

• Guía de configuración de SSO (inicio de sesión único) y SCIM (Sistema para la Gestión de Identidades entre Dominios)
• Analytics API – Teams personalizados
• Referencia de la Analytics API
• Controles de RBAC