Resumen del MCP

El servidor Model Context Protocol (MCP) en Document360 expone el contenido de tu base de conocimiento a través de una interfaz estructurada para interactuar con la documentación. En lugar de acceder a la documentación como páginas web renderizadas, MCP permite que los asistentes de IA (ChatGPT, Claude) interactúen directamente con el contenido subyacente. Con MCP habilitado, tu base de conocimiento se vuelve accesible a través de asistentes de IA definidos que realizan operaciones específicas como búsqueda, recuperación, creación, actualización, publicación y gestión de flujos de trabajo de contenido, todo dentro de las reglas existentes de tu proyecto.

¿Qué es MCP?

El MCP es un estándar abierto que permite a los asistentes de IA conectarse de forma segura con sistemas externos y acceder a datos estructurados. En lugar de construir integraciones separadas para cada asistente de IA y cada plataforma, MCP proporciona una interfaz común que estandariza cómo los asistentes de IA se comunican con plataformas externas.

Un servidor MCP actúa como puente entre un asistente de IA y tu sistema. Expone capacidades específicas como buscar contenido, recuperar documentos o realizar actualizaciones estructuradas mediante un protocolo definido. El asistente de IA envía una solicitud estructurada al servidor MCP, y este responde con datos estructurados que el asistente puede utilizar. Puedes pensar en MCP como un conector universal para integraciones de IA. En lugar de crear conexiones personalizadas para cada herramienta, MCP permite una única forma estandarizada para que los asistentes de IA interactúen con sistemas reales y actualizados.

Al usar MCP, los asistentes de IA no se limitan a generar respuestas únicamente a partir de datos de entrenamiento. Pueden recuperar contenido en vivo, acceder a documentación estructurada y realizar acciones definidas a través del servidor MCP, haciendo que sus salidas sean más relevantes y conscientes del contexto.

El reto al que se enfrentan las organizaciones con los asistentes de IA

Muchas organizaciones están adoptando asistentes de IA como:

ChatGPT
Claude
GitHub Copilot
Agentes internos de IA

Sin embargo, estos asistentes a menudo carecen de acceso directo a conocimientos empresariales estructurados.

Como resultado:

Las herramientas de IA no pueden acceder fácilmente a bases de conocimiento
La documentación no está integrada en los flujos de trabajo de IA
Los desarrolladores y equipos de soporte copian y pegan la documentación manualmente
Mantener una documentación coherente se vuelve difícil

Las organizaciones necesitan una forma estructurada de conectar a los asistentes de IA con sus sistemas de documentación. Document360 MCP resuelve este problema.

Por qué MCP en Document360

La documentación en Document360 está estructurada a lo largo de versiones de proyectos, múltiples lenguajes, jerarquías de categorías y configuraciones de visibilidad basadas en roles. Esta estructura define cómo se organiza, accede y gobierna el contenido dentro de tu base de conocimiento.
Cuando la documentación se consume solo a través de páginas web renderizadas, gran parte de esa estructura se experimenta visualmente. El contexto de versión, la selección de lenguaje y las relaciones jerárquicas están presentes, pero no siempre explícitas cuando se accede programáticamente.
La disponibilidad de MCP depende de la configuración y el plan de tu proyecto. El MCP Server introduce una forma estandarizada para que los asistentes de IA interactúen con tu documentación mediante capacidades definidas como buscar, recuperar, actualizar y publicar contenido, y gestionar flujos de trabajo. En lugar de depender únicamente de la salida renderizada, los asistentes de IA pueden interactuar con tu base de conocimiento de manera estructurada y controlada.

Por ejemplo:
- Las operaciones de búsqueda pueden abarcar por defecto varias versiones del proyecto o dirigirse a una versión específica cuando sea necesario.
- El contenido recuperado respeta tus reglas de visibilidad y permisos configuradas.
- Las operaciones de escritura siguen el comportamiento de versionado existente y preservan la estructura del contenido.
- Las operaciones de flujo de trabajo respetan las etapas de revisión configuradas de tu proyecto y los permisos basados en roles.
- Las operaciones de publicación siguen las mismas normas que el portal; el contenido solo puede ser publicado o no publicado por usuarios con los permisos correspondientes.
Al mismo tiempo, MCP opera completamente dentro de tu configuración existente. La disponibilidad de contenido refleja la configuración de la versión de tu proyecto, configuración de idioma, modelo de permisos y reglas de visibilidad. El contenido no publicado o restringido sigue estando regulado por esas normas.

Cuando ocurren operaciones de escritura, flujo de trabajo o publicación, se conserva el comportamiento de versionado existente. MCP no anula los flujos de trabajo de documentación, reglas de publicación ni controles de gobernanza. Simplemente proporciona un acceso estructurado a tu base de conocimiento manteniendo la integridad de tu sistema de documentación.

Antes de que empieces

Antes de habilitar MCP, asegúrese de lo siguiente:

Tienes un rol de Propietario o Administrador del Proyecto. Solo estos roles pueden habilitar o desactivar MCP para un proyecto.
Estás usando un asistente de IA compatible (ChatGPT, Claude, GitHub Copilot, Cursor IDE, o cualquier plataforma que soporte MCP o conectores personalizados).

Para habilitar MCP y conectar tu asistente de IA, consulta Connect MCP usando un conector personalizado.

Autenticación y control de acceso

MCP utiliza OAuth para la autenticación. Cuando conectas un asistente de IA a Document360 a través de MCP, la conexión está vinculada a la cuenta de usuario que completa el flujo OAuth.

Todas las interacciones MCP siguen el modelo de control de acceso basado en roles (RBAC) de Document360. Esto significa:

El asistente de IA solo puede acceder al contenido permitido para el usuario autenticado en función de sus roles y permisos asignados.
El contenido restringido o no publicado sigue estando regulado por las normas de visibilidad vigentes.
Las operaciones de escritura (crear o actualizar artículos y categorías) solo son posibles si el usuario autenticado tiene los permisos adecuados.
Las operaciones de publicación, despublicación y flujo de trabajo siguen el mismo modelo de permisos que el portal. Solo los usuarios con los permisos adecuados pueden realizar estas acciones.

Habilitar MCP no otorga a herramientas externas acceso ilimitado a tu base de conocimiento.

Herramientas MCP de Document360

El Servidor MCP proporciona una lista de herramientas que definen cómo se puede buscar, recuperar y gestionar la documentación.

Cada herramienta representa una acción específica e intencionada contra tu base de conocimiento. En lugar de exponer contenido en bruto o puntos finales abiertos, MCP estructura las interacciones mediante operaciones claramente definidas. Esto garantiza que el acceso a la documentación siga siendo predecible, consciente de versiones y alineado con la configuración de tu proyecto.

Estas herramientas apoyan conjuntamente el descubrimiento estructurado, la recuperación contextual, actualizaciones controladas de contenido, gestión de flujos de trabajo y operaciones de publicación.

Herramientas de búsqueda y recuperación

Herramienta	Descripción
`document360-mcp-search`	Realiza una búsqueda semántica en tu proyecto de base de conocimientos. Coincide por significado, no por la redacción exacta. Busca todas las versiones del proyecto por defecto, o una versión específica cuando sea necesario.
`document360-mcp-find-text`	Encuentra una palabra o frase exacta y sensible a mayúsculas en cualquier parte de tu documentación y devuelve todas las categorías de artículos y páginas que la contienen, con sus URLs públicas.
`document360-mcp-list-documents`	Lista artículos y categorías de página usando filtros como versión, idioma, categoría, estado, etiquetas, etiquetas o fecha de actualización.
`document360-mcp-get-article`	Recupera el contenido completo del artículo usando un ID o URL del artículo. Soporta múltiples idiomas y permite obtener versiones publicadas o borradores.
`document360-mcp-get-categories`	Recupera la estructura completa de categorías de una versión seleccionada del proyecto, incluyendo categorías hijas y artículos asociados.
`document360-mcp-get-category`	Recupera información detallada para una categoría específica, incluyendo su contenido, subcategorías y artículos asociados.
`document360-mcp-get-project-versions`	Lista todas las versiones disponibles del proyecto junto con sus identificadores, permitiendo operaciones específicas de cada versión.
`document360-mcp-get-workflow-statuses`	Lista los estados del flujo de trabajo configurados para el proyecto, con sus identificadores.
`document360-mcp-get-workflow-assignees`	Lista los usuarios y grupos que pueden asignarse al flujo de trabajo de un artículo.

Estas herramientas permiten un descubrimiento estructurado y el acceso contextual al contenido documental.

Herramientas de escritura

Herramienta	Descripción
`document360-mcp-create-article`	Crea un nuevo artículo en una categoría y versión del proyecto especificadas. Soporta formatos de contenido estructurado y requiere confirmación antes de su creación.
`document360-mcp-update-article`	Actualiza un artículo existente preservando su estructura y formato. Soporta actualizaciones parciales y requiere recuperar el artículo antes de modificarlo.
`document360-mcp-create-category`	Crea una nueva categoría dentro de una versión seleccionada del proyecto. Soporta estructuras jerárquicas de categorías.
`document360-mcp-update-category`	Actualiza propiedades de categoría como nombre, posición, jerarquía o visibilidad dentro de la base de conocimiento.
`document360-mcp-update-category-content`	Actualiza el contenido de las páginas de categoría (aplicable a categorías de tipo Página o Índice) manteniendo la estructura existente.
`document360-mcp-publish-article`	Publica un artículo promocionando su último borrador a la versión en directo.
`document360-mcp-unpublish-article`	Elimina un artículo y lo elimina de la base de conocimiento en activo.
`document360-mcp-publish-category`	Publica el último borrador de contenido de una categoría de página en la versión en vivo.
`document360-mcp-unpublish-category`	Elimina una categoría de página y la elimina del sitio de la base de conocimiento en vivo.
`document360-mcp-set-workflow-status`	Establece el estado del flujo de trabajo de un artículo o categoría de página, con una fecha de entrega opcional, un comentario y los asignados.

Las operaciones de escritura siguen el mismo comportamiento de versionado y reglas de gestión de contenido que el editor Document360.

Estas herramientas pueden usarse individualmente o en combinación para apoyar flujos de trabajo de documentación de extremo a extremo. Por ejemplo, los asistentes de IA pueden buscar un artículo, actualizar su contenido, moverlo a través de un flujo de trabajo de revisión y publicarlo en el sitio en vivo, todo ello dentro de una sola conversación. Esto hace que MCP sea adecuado para escenarios de automatización como actualizaciones masivas de contenido, creación de documentación a gran escala, flujos de trabajo estructurados de revisión y aprobación, y mantener la coherencia entre múltiples artículos. La experiencia con prompts y respuestas puede variar según el asistente de IA que se utilice, ya que cada herramienta interpreta y procesa las solicitudes de forma diferente. Puedes monitorizar cómo se accede a tu base de conocimiento a través de MCP usando el panel de análisis del servidor MCP .