Ahora que has conectado el servidor MCP de Document360 con tus asistentes de IA, exploremos cómo los asistentes de IA pueden usar las herramientas MCP para buscar, recuperar, crear, actualizar, gestionar flujos de trabajo y publicar contenido en tu base de conocimiento.
Estas herramientas trabajan juntas mediante prompts, permitiendo tareas de documentación en varios pasos con una sola instrucción. Por ejemplo, un asistente de IA puede buscar artículos existentes, recuperar detalles de categorías, crear nueva documentación, actualizar contenido existente, mover contenido por etapas de flujo de trabajo y publicarlo en tu base de conocimientos, todo basado en la estructura de tu proyecto y los permisos. Entender cómo funcionan estas herramientas te ayuda a crear prompts más efectivos y a construir flujos de trabajo de documentación eficientes.
Herramientas MCP
Herramientas de búsqueda y recuperación
| Herramienta | Qué hace | Usa esto para |
|---|---|---|
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. | Descubre artículos relacionados, explora un tema o encuentra documentación cuando no sepas la expresión exacta utilizada |
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. | Encuentra cada documento que contenga un término exacto, recursos de contenido o fragmento de código antes de una actualización masiva |
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. | Haz una lista de reseñas para una publicación, audita una categoría o busca todo lo actualizado desde una fecha determinada |
document360-mcp-get-article |
Recupera el contenido completo de cualquier artículo usando su ID o URL. Funciona en varios idiomas y te permite acceder tanto a versiones publicadas como borradores. | Lee los artículos existentes, revisa el borrador del contenido, recoge los artículos antes de actualizarlos |
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. | Navega por la jerarquía de la base de conocimiento, encuentra identificadores de categoría, entiende la estructura de la documentación |
document360-mcp-get-category |
Recupera todo sobre una categoría específica, su contenido, subcategorías y artículos asociados usando el ID de categoría. | Inspecciona una categoría a fondo, lee el contenido de la página de categoría, valida la categoría antes de actualizar |
document360-mcp-get-project-versions |
Lista todas las versiones disponibles de tu proyecto junto con sus identificadores para que puedas ejecutar operaciones específicas de cada versión con precisión. | Selecciona la versión correcta, crea avisos que consiguen la versión, recupera los IDs de versión válidos |
document360-mcp-get-workflow-statuses |
Lista los estados del flujo de trabajo configurados para el proyecto, junto con sus identificadores y señales. | Descubre los estados de flujo de trabajo disponibles, recupera los identificadores de estado antes de pasar el contenido por las etapas de revisión |
document360-mcp-get-workflow-assignees |
Lista los usuarios y grupos que pueden asignarse al flujo de trabajo de un documento específico. | Encuentra identificadores válidos de asignados antes de asignar un paso de flujo de trabajo, identifica quién puede revisar un documento |
¿Qué herramienta de búsqueda deberías usar? Depende de lo que busques:
- Si conoces el tema pero no las palabras exactas, usa
document360-mcp-search. Por ejemplo, "¿qué dice nuestra documentación sobre restablecer una contraseña?" - Si sabes la palabra o frase exacta que quieres encontrar, usa
document360-mcp-find-text. Por ejemplo, para encontrar todos los artículos que contienen{{old_api_key}}. - Si no tienes un término de búsqueda y solo quieres una lista de documentos, usa
document360-mcp-list-documents. Por ejemplo, todos los artículos de una categoría que se actualizaron el mes pasado.
Herramientas de escritura
| Herramienta | Qué hace | Usa esto para |
|---|---|---|
document360-mcp-create-article |
Crea un nuevo artículo dentro de una categoría y versión del proyecto especificadas apoyando contenido estructurado. | Crea nueva documentación en la categoría correcta, redacta artículos de ayuda que faltan, genera primeros borradores a partir de prompts |
document360-mcp-update-article |
Actualiza un artículo existente preservando su estructura y formato. Diseñado para actualizaciones parciales para que puedas revisar una sección sin tocar el resto del artículo. | Actualizar la documentación desactualizada, revisar artículos durante las actualizaciones del producto, reescribir secciones específicas sin afectar al resto |
document360-mcp-create-category |
Crea una nueva categoría dentro de una versión seleccionada del proyecto. Soporta estructuras anidadas para que puedas crear subcategorías a medida que tu contenido crece. | Añadir nuevas secciones de documentación, crear subcategorías para nuevas funcionalidades, organizar el contenido en nuevas estructuras |
document360-mcp-update-category |
Actualiza propiedades de categoría como nombre, posición, jerarquía o visibilidad. | Renombrar categorías, reorganizar la jerarquía, mejorar la estructura |
document360-mcp-update-category-content |
Actualiza el contenido de las páginas de categorías preservando la estructura existente. | Actualizar el contenido de la página o del índice de categorías, revisar la visión general de las categorías o secciones introductorias, actualizar las directrices a nivel de categoría sin afectar al resto de la estructura |
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. | Mover el contenido por las etapas de revisión, asignar revisores, establecer fechas de entrega para las tareas de flujo de trabajo |
document360-mcp-publish-article |
Publica un artículo promocionando su último borrador a la versión en directo. | Haz que un borrador de artículo esté disponible en la base de conocimientos después de crearlo o actualizarlo |
document360-mcp-unpublish-article |
Despublicar un artículo y eliminarlo del sitio de la base de conocimiento activa. El contenido se conserva y puede volver a publicarse. | Quita un artículo desactualizado o incorrecto sin borrarlo |
document360-mcp-publish-category |
Publica el último borrador de contenido de una categoría de página en la versión en vivo. | Haz una categoría de página activa después de actualizar su contenido |
document360-mcp-unpublish-category |
Elimina una categoría de página y la elimina del sitio de la base de conocimiento en activo. El contenido se conserva y puede volver a publicarse. | Elimina una categoría de página del sitio de la base de conocimiento activa sin eliminarla |
Límites de tasas
Las solicitudes MCP están sujetas a límites de tasa basados en tu plan Document360. Los límites se aplican por usuario, por proyecto, en todas las llamadas a herramientas MCP dentro de una ventana fija de un minuto. Las operaciones de lectura y escritura comparten el mismo límite, por lo que buscar, recuperar, crear y actualizar llamadas extraen todas de un mismo pool. Dependiendo de tu plan, el límite de velocidad es de 60 o 100 solicitudes por minuto.
Estos límites ayudan a garantizar un rendimiento fiable y un uso justo en los flujos de trabajo de documentación. Si superas el límite de tasa, las solicitudes posteriores pueden limitarse hasta que comience la siguiente ventana de un minuto.
Esto puede ocurrir cuando:
- Ejecutar prompts automáticos frecuentes
- Realizar búsquedas repetidas en rápida sucesión
- Ejecutar múltiples operaciones de creación o actualización al mismo tiempo
Si tu flujo de trabajo necesita un límite más alto, contacta con tu Responsable de Éxito del Cliente o support@document360.com. Los límites más altos pueden configurarse según tus necesidades y pueden implicar un coste adicional.
Mejores prácticas para gestionar los límites de solicitudes MCP
Para evitar el limitamiento:
- Espacia las solicitudes frecuentes o automáticas
- Divide flujos de trabajo grandes en secuencias de prompts más pequeñas
- Reutilizar el contexto de la categoría o del artículo recuperado cuando sea posible
- Evitar búsquedas paralelas repetidas en varias versiones
Esto ayuda a mantener una experiencia MCP más fluida y reduce la probabilidad de interrupciones en el flujo de trabajo.