El servidor MCP permite que asistentes de IA externos interactúen con tu base de conocimientos de Document360 de forma estructurada. Estas interacciones no eluden 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
Utiliza la Guía de Estilo configurada como guía al editar o revisar contenido
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 reducen la investigación repetitiva, mantienen una mejor coherencia entre los artículos y redactan el 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, ese vacío se hace visible de inmediato. 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
Todas las operaciones de escritura continúan respetando los flujos de trabajo y permisos existentes.
Resultado
Los equipos de soporte resuelven tickets más rápido mientras mejoran continuamente la calidad de la documentación.
Usa MCP con tu asistente de IA
Después de conectar MCP, puedes interactuar con tu base de conocimientos a través de tu asistente de IA.
Buscar documentación
Puedes pedir al asistente de IA que busque contenido en tu base de conocimiento.
Ejemplos:
Busca una función en una versión específica
Encuentra artículos relacionados con un tema
Recuperar documentación en un lenguaje específico
Recuperar artículos
Puedes solicitar artículos específicos por nombre o tema.
El asistente de IA recupera contenido estructurado según la configuración de tu proyecto, incluyendo la versión y el lenguaje.
Crear y actualizar contenido
Si se permiten las operaciones de escritura, el asistente de IA puede:
Crear nuevos artículos en una categoría específica
Actualizar los artículos existentes
Mantener la estructura y el formato HTML
Todas las operaciones de escritura siguen el comportamiento existente de versionado y publicación.
Accede a metadatos estructurados
Puedes solicitar contexto adicional, como:
Versiones disponibles del proyecto
Lenguajes soportados
Estructura de categorías
Esto ayuda a garantizar que las interacciones estén alineadas con la organización de documentación.
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 las respuestas generadas por IA antes de publicar o compartir
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
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.
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.