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. También pueden mantener términos de glosario, gestionar recordatorios de revisión de artículos, realizar tus tareas asignadas y enviar comentarios sobre artículos.
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.
Cuando Document360 lanza nuevas herramientas MCP, tu asistente de IA no las detecta automáticamente. Actualiza la lista de herramientas en tu asistente de IA, o desconecta y vuelve a conectar el conector de Document360 para empezar a usarlas.
Las herramientas MCP solo funcionan con el contenido de tu espacio de trabajo de la base de conocimiento. No buscan, recuperan, crean ni actualizan contenido dentro de un espacio de trabajo de documentación de la API (referencias de API generadas a partir de una especificación OpenAPI o Postman). Para trabajar con contenido de documentación de la API, utiliza el portal Document360 o la API estándar del cliente.
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 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 |
document360-mcp-list-glossary-terms |
Lista los términos del glosario en tu proyecto, incluyendo la definición de cada término y variantes lingüísticas. Puedes filtrar por términos globales o a nivel de idioma, idioma o texto de búsqueda. | Comprueba si un término ya está definido, revisa las definiciones del glosario, encuentra un término antes de insertarlo en un artículo |
document360-mcp-list-review-reminders |
Lista los artículos y categorías de páginas en un espacio de trabajo que incluye un recordatorio de reseña, con la fecha de revisión más temprana primero. Puedes filtrar por estado (obsoleto o programado), rango de fechas de revisión y lenguaje. | Encuentra contenido que necesite revisión ahora, planifica las próximas revisiones, revisa qué artículos deben entregarse antes de la publicación |
document360-mcp-get-my-tasks |
Lista las tareas asignadas en un espacio de trabajo, incluyendo asignaciones de flujo de trabajo, comentarios de lectores y recordatorios de repasos. Esta es la misma lista que ves en la página de Tareas del portal. | Mira qué hay que atrasar o vencer esta semana, haz un triaje en tu trabajo, busca el ID de la tarea antes de actuar sobre una tarea |
¿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 |
document360-mcp-create-glossary-term |
Añade un nuevo término a tu glosario, ya sea como un término global compartido entre todos los idiomas o como término a nivel de idioma para un idioma. | Definir nuevos términos de producto, añadir entradas de glosario que faltan, construir un glosario a partir de la documentación existente |
document360-mcp-update-glossary-term |
Actualiza el nombre, término o definición de un término glosario existente. Solo se actualizan los campos que cambias. Para términos a nivel de idioma, puedes actualizar un idioma o añadir uno nuevo. | Revisar definiciones obsoletas, añadir una definición en otro idioma, corregir la redacción de un término |
document360-mcp-set-article-review-reminder |
Programa un recordatorio de revisión en un artículo, lo marca para revisión ahora o elimina el recordatorio. | Programa la siguiente revisión tras actualizar un artículo, marca un artículo como que necesita revisión, elimina un recordatorio que ya no es necesario |
document360-mcp-snooze-task |
Pospone una de tus tareas hasta una fecha concreta, o trae de vuelta una tarea pospuesta. | Pospone una tarea que aún no puedes realizar, trae de vuelta una tarea que está dormida antes |
document360-mcp-mark-task-done |
Marca una de tus tareas de flujo de trabajo como terminada, igual que Marca como terminada en la página de Tareas . | Confirma que has completado la revisión de un artículo |
document360-mcp-update-feedback-status |
Actualiza el estado, el asignado o la nota interna de los comentarios del lector asignados a ti. También puedes notificar al lector sobre el cambio. | Feedback cerrado después de corregir un artículo, dar feedback a un compañero, añadir una nota interna |
document360-mcp-send-article-feedback |
Envía comentarios sobre un artículo publicado a tu equipo de documentación, por ejemplo, cuando el contenido no es claro, está desactualizado, falta información, es irrelevante o tiene un enlace roto. El feedback aparece en el gestor de Feedback. | Reporta un problema encontrado en un artículo mientras uses tu asistente de IA |
- Las herramientas del glosario solo están disponibles cuando la función Glosario está incluida en el plan de tu proyecto.
document360-mcp-update-feedback-statusestá disponible solo cuando el gestor de Retroalimentación está incluido en el plan de tu proyecto. - Los términos del glosario no pueden eliminarse a través del MCP, y no se puede activar la traducción del glosario desde el MCP. Para términos a nivel de idioma, añade cada idioma por separado usando
document360-mcp-update-glossary-term. - Renombrar un término glosario no actualiza los artículos que ya lo usan.
document360-mcp-mark-task-doneno cambia el estado del flujo de trabajo. Para mover el artículo al siguiente estado, utilizadocument360-mcp-set-workflow-status.
Cuentas de lector y revisor: Las herramientas MCP siguen el rol y el acceso al contenido de la cuenta conectada, por lo que tu asistente de IA solo puede realizar las acciones que se te permiten realizar en el portal.
- Las cuentas de lectores pueden usar
document360-mcp-send-article-feedback, pero ninguna otra herramienta de escritura. Los lectores tampoco pueden usardocument360-mcp-list-glossary-terms,document360-mcp-list-review-reminders, odocument360-mcp-get-my-tasks. - Las cuentas revisores no pueden usar
document360-mcp-create-glossary-term,document360-mcp-update-glossary-term,document360-mcp-set-article-review-reminder, nidocument360-mcp-update-feedback-status.
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 las llamadas de búsqueda, recuperación, creación y actualización extraen todas de un mismo pool. El límite de tarifa depende de tu plan: los proyectos de plan de negocio están limitados a 60 solicitudes por minuto por usuario y los proyectos de plan empresarial a 100 solicitudes por minuto por usuario.
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.