El servidor MCP permite que asistentes de IA externos interactúen con tu base de conocimientos de Document360 de forma estructurada. Estas interacciones no saltan tu modelo de gobernanza: operan dentro de tu versión, lenguaje y configuración de visibilidad existentes. A continuación, se muestran escenarios prácticos que muestran cómo diferentes roles pueden utilizar MCP en sus flujos de trabajo diarios de documentación.
Redactores técnicos
Problema: Investigar, redactar y refinar la documentación requiere cambio de contexto y esfuerzo manual
Los redactores técnicos suelen moverse entre varios artículos, versiones y categorías para recopilar contexto antes de redactar o actualizar el contenido. También deben garantizar la coherencia en el tono, la terminología y la estructura, especialmente cuando se configura una Guía de Estilo. Cambiar entre editor, búsqueda, versiones anteriores y artículos de referencia ralentiza la redacción y la revisión.
Cómo ayuda el MCP
Con un asistente de IA conectado a Document360 a través de MCP, los escritores pueden:
- Pide al asistente que recupere los artículos relevantes antes de redactar nuevo contenido
- Lluvia de ideas basadas en documentación existente
- Refinar o reescribir el contenido directamente dentro del sistema de documentación
- Actualizar artículos sin copiar manualmente el contenido entre herramientas
- Mueve los artículos actualizados al estado de flujo de trabajo correspondiente y asigna revisores sin cambiar al portal
- Publica contenido aprobado directamente desde el asistente de IA una vez que la revisión esté completa
En lugar de redactar en un borrador aislado y pegar contenido después, los escritores pueden trabajar con el contexto extraído de su propia base de conocimientos. Cuando se realizan actualizaciones, el flujo de trabajo existente y el comportamiento de versionado permanecen sin cambios. Cualquier revisión bifurcada o estado de revisión continúa siguiendo los procesos normales de documentación.
Resultado
Los redactores técnicos reducen la investigación repetitiva, mantienen una mejor coherencia entre los artículos y redactan y publican contenido más rápido, manteniéndose dentro del mismo modelo de gobernanza documental.
Desarrolladores
Problema: Los desarrolladores necesitan documentación específica de cada versión al crear funciones
Los desarrolladores cambian frecuentemente entre IDEs y entornos de programación asistida por IA, como Cursor u otras herramientas habilitadas para IA. Al consultar documentación, necesitan información precisa y con versiones sin tener que navegar manualmente por la base de conocimiento.
Cómo ayuda el MCP
Conectando Document360 a través de MCP a su asistente de IA dentro del IDE:
- Los desarrolladores pueden recuperar el contenido completo del artículo en lugar de fragmentos parciales
- Busca en todas las versiones del proyecto por defecto, o especifica una versión
- Accede a la documentación en un idioma seleccionado
- Generar documentación preliminar para nuevos endpoints o integraciones
Esto permite que la búsqueda de documentación y la creación de contenido se realicen directamente dentro del flujo de trabajo de desarrollo.
Resultado
Los desarrolladores dedican menos tiempo a cambiar de contexto y más tiempo construyendo con documentación que refleje la versión y estructura correctas.
Gerentes de producto y consultores
Problema: Validar la documentación entre versiones es manual y fragmentada
Los responsables de producto a menudo necesitan comparar descripciones de características entre versiones, preparar notas de lanzamiento o validar que la documentación refleje los últimos cambios del producto. Comprobar manualmente varias versiones y categorías puede ser lento e inconsistente.
Cómo ayuda el MCP
A través de asistentes de IA habilitados por MCP, los equipos de producto pueden:
- Recuperar la documentación por versión específica del proyecto
- Compara cómo se describen las características entre las versiones
- Identificar lagunas antes del lanzamiento
- Generar resúmenes estructurados para la alineación interna o la incorporación
Como la interacción está estructurada, el contenido se recupera en contexto y no como salida web desconectada.
Resultado
La documentación es más fácil de validar antes del lanzamiento, reduciendo la desalineación entre las actualizaciones del producto y el conocimiento publicado.
Ingenieros de soporte
Problema: Los tickets de soporte exponen lagunas de conocimiento
Cuando llega un ticket de soporte, los ingenieros deben determinar rápidamente si ya existe documentación relevante. Buscar manualmente puede llevar mucho tiempo, especialmente en varias versiones y lenguajes. En algunos casos, la documentación puede no existir en absoluto.
Cómo ayuda el MCP
Con MCP conectado a un asistente de IA:
- Los ingenieros de soporte pueden pegar el contexto de los tickets y pedir al asistente que obtenga los artículos relevantes
- Recuperar contenido por nombre o ID del artículo
- Buscar entre versiones e idiomas
- Comparte las URLs de los artículos directamente con los clientes
Si no se encuentra ningún artículo relevante, significa que existe una laguna de conocimiento en la base de conocimientos. Los ingenieros pueden entonces:
- Redacta un nuevo artículo basado en el contexto del ticket
- Actualizar un artículo existente para mejorar la claridad
- Empujar los cambios estructurados de nuevo a Document360
- Mueve el artículo para revisarlo y asignar al miembro adecuado del equipo antes de que se publique
- Publica el artículo directamente una vez que haya sido revisado y aprobado
Todas las operaciones de escritura, flujo de trabajo y publicación continúan respetando permisos y reglas de gobernanza existentes.
Resultado
Los equipos de soporte resuelven tickets más rápido mientras mejoran continuamente la calidad de la documentación — y ahora pueden pasar contenido del borrador a la publicación sin salir de su asistente de IA.
Responsables de documentación y responsables de contenido
Problema: Coordinar revisión, aprobación y publicación a través de un equipo grande consume mucho tiempo
Los responsables de documentación que supervisan a varios redactores deben hacer un seguimiento de qué artículos están en borrador, cuáles esperan revisión y cuáles están listos para publicar. Coordinar esto en un equipo sin una visión centralizada provoca retrasos, revisiones perdidas y ritmos de publicación inconsistentes.
Cómo ayuda el MCP
Con un asistente de IA conectado a Document360 a través de MCP, los gestores de documentación pueden:
- Comprueba qué estados de flujo de trabajo están configurados y cómo está estructurado el pipeline de revisión
- Mueve varios artículos a la fase de revisión correspondiente y asigna a los miembros adecuados del equipo en una sola conversación
- Establece fechas de entrega para las tareas de flujo de trabajo para mantener las revisiones en el calendario
- Publica contenido que haya pasado la revisión sin cambiar al portal
- Elimina rápidamente el contenido desactualizado o incorrecto cuando algo deba ser desconectado
Como todas las operaciones de flujo de trabajo y publicación siguen el mismo modelo de permisos y gobernanza que el portal, los gestores mantienen el control total sobre quién puede hacer qué.
Resultado
Los responsables de documentación dedican menos tiempo a buscar el estado de las revisiones y publicar el contenido manualmente, y más tiempo a garantizar la calidad y coherencia de la documentación en todo el equipo.
Mejores prácticas
Sigue estas mejores prácticas al usar MCP con asistentes de IA:
- Utiliza MCP para recuperar documentación de la fuente de verdad en lugar de copiar contenido manualmente
- Verifica el contenido generado por IA antes de moverlo a revisarlo o publicarlo en la base de conocimiento
- Especifica la versión o lenguaje del proyecto cuando se requiera precisión
- Utiliza indicaciones claras y específicas al solicitar contenido o actualizaciones
- Asegúrate de que los roles y permisos de usuario estén configurados correctamente, especialmente para operaciones de flujo de trabajo y publicación
Limitaciones y consideraciones
- Los asistentes de IA solo pueden acceder al contenido permitido por la configuración de tu proyecto
- El contenido restringido o no publicado sigue estando regulado por reglas de visibilidad
- Las salidas generadas por IA pueden requerir validación antes de su uso
- El proceso de configuración puede variar según el asistente de IA
- El soporte para MCP puede variar según el asistente de IA o la herramienta de desarrollo que se utilice (como asistentes basados en IDE o clientes experimentales). Algunas herramientas pueden tener soporte limitado o en evolución para capacidades MCP.
- Si una cuenta de equipo tiene diferentes roles en portales y roles de contenido entre categorías y artículos, MCP aplica el rol de menor prioridad en todas las categorías y artículos. Por ejemplo, si tienes acceso de Editor en una categoría y acceso de Revisor en otra, MCP trata ambos como Revisores.
- Si a un usuario se le asignan dos roles personalizados, uno con permisos de vista para un conjunto de categorías y otro con permisos de actualización para otro conjunto diferente, el rol con acceso a la vista tiene prioridad. Si desea que el usuario actualice los artículos a través de MCP, asegúrese de que solo se le asigne el rol con permisos de actualización.
- Para utilizar herramientas de flujo de trabajo mediante MCP, los roles personalizados del portal deben tener explícitamente habilitados los permisos de Ver asignaciones de flujo de trabajo y Actualizar el flujo de trabajo. Sin estos, los cambios en el estado del flujo de trabajo no pueden realizarse mediante MCP.
- Para las categorías de página, no hay permiso de publicación independiente en la configuración de roles personalizados. Si un rol personalizado tiene permisos de Visualización y Actualización para categorías, se permite publicar automáticamente las categorías de página a través de MCP, coherente con el comportamiento del portal.
- No se permite publicar y despublicar mediante MCP para guías paso a paso.
Resolución de problemas
Si encuentras problemas al usar MCP:
- Confirma que MCP está activado en Document360
- Verifica que la URL del servidor MCP sea correcta
- Asegúrate de que la autenticación OAuth se complete con éxito
- Comprueba si tu asistente de IA soporta conectores MCP o personalizados
Si el problema persiste, consulta la documentación de tu asistente de IA o contacta con el soporte.