A medida que más equipos integran agentes de IA en sus flujos de trabajo de documentación, surge una pregunta arquitectónica común: cuando Document360 ofrece tanto endpoints MCP como endpoints estándar de API, ¿qué debería usar un agente de IA como Claude Code, y cuándo?
Este artículo explica cómo pensar en esa decisión, cuándo usar cada interfaz y cómo un enfoque híbrido suele ofrecer lo mejor de ambas.
Comprensión de las dos interfaces
La interfaz MCP expone un conjunto seleccionado de herramientas: buscar, recuperar, crear, actualizar, gestionar flujos de trabajo y publicar contenido, a través de un protocolo estructurado que los agentes de IA comprenden de forma nativa. Cuando un agente se conecta mediante MCP, puede descubrir qué operaciones están disponibles, entender sus esquemas de entrada/salida e invocarlos como parte de una cadena de razonamiento, todo ello sin código de enlace personalizado.
La API estándar te da acceso directo y de bajo nivel a todas las capacidades de Document360 a través de endpoints REST. Controlas explícitamente cada parámetro de solicitud, lógica de reintentos, paginación y flujo de autenticación.
Ambas interfaces se comunican con la misma base de conocimientos subyacente. La diferencia está en cómo un agente (o tu código) interactúa con él.
Por defecto MCP cuando el agente lo soporte
MCP está diseñado específicamente para agentes de IA. Cuando el servidor MCP de Document360 esté disponible y cubra la operación que necesitas, debería ser tu primera opción para flujos de trabajo agentes. He aquí por qué:
No se requiere código de pegamento - El agente descubre las herramientas disponibles de forma dinámica. No necesitas escribir constructores de solicitudes personalizados ni analizar respuestas API en bruto para operaciones comunes como buscar artículos o buscar estructuras de categorías.
Entradas y salidas estructuradas : cada herramienta MCP tiene un esquema definido. Esto reduce los errores causados por solicitudes mal formadas y hace que el comportamiento del agente sea más predecible.
Encajamiento natural para el razonamiento en varios pasos : los agentes de IA destacan encadenando acciones como buscar un artículo, leer su contenido y luego actualizarlo según lo encontrado. Las herramientas MCP están diseñadas precisamente para este tipo de flujo de trabajo secuencial y consciente del contexto.
Autenticación estandarizada y paso de contexto : MCP gestiona OAuth y contexto de forma consistente entre servicios, reduciendo la fricción de integración cuando tu agente se conecta a varios sistemas.
Usa la API estándar cuando necesites control
El servidor MCP expone un subconjunto curado de la superficie completa de la API de Document360. Hay casos en los que la opción de la API estándar tiene más sentido:
La operación no se expone mediante MCP - Comprueba si la capacidad específica que necesitas — un filtro concreto, una exportación masiva, un disparador webhook — está disponible en las herramientas MCP compatibles. Si no lo es, la API estándar es tu camino.
Necesitas optimizaciones de rendimiento : si tu flujo de trabajo implica agrupar muchas solicitudes, transmitir grandes cargas útiles o almacenar respuestas en caché de forma agresiva, la API estándar te ofrece palancas de control que las abstracciones MCP no tienen.
Estás construyendo automatización no agentica : los trabajos cron, pipelines de datos y manejadores de webhooks no se benefician del descubrimiento de herramientas ni del razonamiento agente. Una llamada directa a la API es más sencilla y fácil de mantener en estos contextos.
Necesitas un control preciso de paginación o reintentos : la API estándar te da control total sobre cómo recorrer grandes conjuntos de resultados y gestionar errores transitorios, lo cual es importante para la automatización sensible a la fiabilidad.
Un enfoque híbrido suele funcionar mejor en la práctica
Para la mayoría de los equipos que construyen con agentes de IA, la arquitectura ideal no es una elección binaria. Está estructurado en capas:
| Capa | Interfaz | Propósito |
|---|---|---|
| Razonamiento y actuación del agente | MCP | Buscar, recuperar, crear, actualizar, gestionar flujos de trabajo y publicar contenido mediante el uso natural de herramientas |
| Operaciones de precisión | API estándar | Procesamiento por lotes, operaciones no soportadas, rutas críticas de rendimiento |
| Automatización en segundo plano | API estándar | Canalizaciones, trabajos cron, webhooks que no necesitan descubrimiento de herramientas |
Piénsalo así: deja que el agente use MCP para saber en qué son buenos los agentes: razonar sobre qué herramienta llamar, encadenar acciones en varios pasos y trabajar con contenido estructurado de documentación. Reserva las llamadas directas de API para operaciones deterministas, sensibles al rendimiento o no soportadas cuando el control explícito importe.
Lista de verificación práctica antes de elegir
Antes de decidir qué interfaz usar para una operación determinada, resuelve estas preguntas:
- ¿Está disponible la operación como herramienta MCP? Consulta las herramientas listadas en el artículo de Herramientas soportadas . Si es así, prefiero MCP.
- ¿Necesita el agente razonar sobre qué acción tomar? Si el agente decide dinámicamente qué hacer a continuación según el contexto, MCP encaja de forma natural.
- ¿Necesitas procesar grandes volúmenes o controlar comportamientos a nivel de solicitud? Si es así, usa la API estándar.
- ¿Forma parte de una automatización no agentica (pipeline, planificador, webhook)? Si es así, usa directamente la API estándar — aquí no hay ningún beneficio en el descubrimiento de herramientas.
- ¿Estás conectando varios servicios? El modelo de autenticación estandarizado de MCP reduce la fricción cuando tu agente se comunica con Document360 junto con otras herramientas compatibles con MCP.
Cómo se ve esto en un flujo de trabajo real
Considera a un ingeniero de soporte que utiliza un agente de IA para identificar y cubrir los huecos de documentación de los tickets entrantes.
El agente haría:
- Úsalo
document360-mcp-searchpara comprobar si ya existe documentación relevante - Úsalo
document360-mcp-get-articlepara recuperar y leer el artículo más cercano - Úsalo
document360-mcp-create-articlepara redactar un nuevo artículo si se encuentra un vacío - Úsalo
document360-mcp-set-workflow-statuspara mover el artículo a la revisión y asignar al miembro adecuado del equipo - Úsalo
document360-mcp-publish-articlepara publicar el artículo una vez que ha sido revisado y aprobado
Los cinco pasos se realizan a través del MCP. El agente razona qué hacer a continuación en cada etapa, y los esquemas de la herramienta guían la interacción.
Si ese mismo equipo también ejecuta una pipeline nocturna para exportar todos los artículos para un sistema de auditoría externo, esa pipeline llamaría directamente a la API estándar. No necesita descubrimiento de herramientas; Solo necesita acceso fiable y paginado al contenido del artículo según un calendario.
A medida que crece la cobertura de MCP
Los servidores MCP están evolucionando. La implementación actual de Document360 cubre las operaciones de documentación más comunes para agentes de IA: búsqueda, recuperación, gestión de contenidos, gestión de flujos de trabajo y publicación. Con el tiempo, es probable que más superficie de la API se exponga a través de MCP, lo que desplazará el equilibrio aún más hacia MCP para la mayoría de los casos de uso agente.
Por ahora, la regla práctica es empezar con MCP, volver a la API estándar para huecos y diseñar tu sistema para que cambiar entre ambos sea sencillo.
.png)
Preguntas frecuentes
¿Puede un agente de IA cambiar entre MCP y la API estándar dentro del mismo flujo de trabajo?
Sí. Un único flujo de trabajo puede usar MCP para los pasos de razonamiento y acción — búsqueda, lectura, escritura — y llamar directamente a la API estándar para operaciones fuera del alcance de MCP. Las dos interfaces no son mutuamente excluyentes; acceden a la misma base de conocimiento subyacente.
¿Utilizar la API estándar evita las reglas de permisos y visibilidad de Document360?
Las dos interfaces gestionan los permisos de forma diferente. MCP se basa en OAuth e incluye el contexto completo del usuario, por lo que respeta todos los controles de acceso basados en roles: el agente de IA solo puede acceder a contenido que el usuario autenticado pueda ver.
La API estándar opera con un token de API, que controla el tipo de operaciones permitidas (lectura, escritura, eliminación) pero no impone el acceso a nivel de portal ni de roles a nivel de contenido. No transmite el contexto del usuario de la misma manera. Ten esto en cuenta al diseñar flujos de trabajo que impliquen contenido sensible o restringido: MCP es la interfaz más adecuada donde la visibilidad basada en roles importa.
Nuestro agente de IA aún no soporta MCP. ¿Deberíamos esperar o construir con la API estándar ahora?
Compila con la API estándar ahora si tienes un caso de uso que funcione. El soporte para MCP está creciendo en todas las plataformas de IA, pero no hay motivo para retrasar. Diseña tu integración para que las acciones del agente sean modulares — eso facilita intercambiar llamadas a herramientas MCP más adelante sin reestructurar todo el flujo de trabajo.