Docsie MCP

Docsie MCP

Docsie MCP conecta asistentes de IA a la plataforma de documentación con IA de Docsie para búsqueda en bases de conocimiento, recuperación de centros de ayuda y documentación de productos, automatización de video a documentos, comparación nativa de múltiples videos, llenado de plantillas de Word, verificaciones de políticas/cumplimiento, creación de presentaciones, importación de contenido, flujos de publicación, ejecuciones de agentes de Docsie con alcance y recargas de créditos de IA compatibles con CLI.

Servidor Remoto

Usa el endpoint MCP alojado:

https://app.docsie.io/mcp

Transporte:

Streamable HTTP

Autenticación:

OAuth2 Authorization Code + PKCE

Qué Hace

Docsie MCP permite que clientes de IA compatibles con MCP se conecten a Docsie para que los usuarios puedan:

• Buscar bases de conocimiento aprobadas, centros de ayuda, documentación de productos, SOP, notas de versión y artículos de soporte
• Recuperar contenido de artículos y estructura del espacio de trabajo desde Docsie
• Convertir demostraciones de productos, videos de capacitación, grabaciones de pantalla y recorridos en documentación paso a paso
• Llenar plantillas de Word del cliente a partir del análisis de video preservando el diseño original del DOCX
• Verificar videos, audio, texto y documentación generada contra reglas de política como PII, HIPAA, marca, control de calidad de capacitación o políticas personalizadas
• Crear resultados listos para presentaciones y sesiones de presentador en vivo a partir de documentación de video generada
• Comparar o combinar múltiples videos mediante trabajos MCP nativos y luego obtener la matriz de comparación o el borrador combinado
• Generar, reescribir, traducir y exportar documentación como Markdown, DOCX, PDF o PPTX
• Importar archivos, sitios web y contenido web extraído a los flujos de documentación de Docsie
• Publicar bases de conocimiento, ayuda en la aplicación, dominios personalizados, formularios y flujos de solicitud de archivos cuando se conceda
• Delegar tareas complejas de documentación y descubrimiento de voz a agentes de IA de Docsie con alcance
• Solicitar opciones de pago aprobadas para flujos extendidos de automatización de Docsie

Los usuarios se autentican con Docsie, eligen una organización y contexto de espacio de trabajo, y otorgan paquetes de permisos explícitos antes de que se expongan las herramientas.

Modelo de Enrutamiento de Herramientas

Docsie MCP expone dos formas complementarias de automatizar Docsie:

Caso de uso	Usa estas herramientas	Por qué
Trabajos simples estilo API	video_to_docs_submit, video_to_docs_status, video_to_docs_result, video_compare_submit, video_compare_status, video_compare_result	El cliente MCP envía un trabajo, conserva el job_id devuelto y consulta el estado/resultado directamente.
Flujos de trabajo estilo Docsie Chat	docsie_agent_start, docsie_agent_status, docsie_agent_result	Docsie crea una sesión de chat oculta y permite que el agente de Docsie orqueste el trabajo de múltiples pasos internamente.

Usa docsie_agent_start para flujos de trabajo complejos en lenguaje natural como:

• analizar un video con Dokuta, esperar la finalización, generar documentación, reescribirla e importarla
• llenar una plantilla de Word/DOCX a partir de un video o documentación generada
• comparar o combinar videos y producir un borrador final de documentación
• ejecutar verificaciones de política/cumplimiento y resumir hallazgos
• publicar o finalizar contenido generado de Docsie después de su creación
• cualquier flujo de trabajo que deba comportarse como el asistente de Docsie Chat en la aplicación

El agente remoto puede usar las herramientas internas vinculadas a sesión de Docsie, incluida la supervisión de operaciones, porque la ejecución del agente posee una sesión de chat de Docsie. Las herramientas de trabajos MCP directos están intencionalmente basadas en ID de trabajo y deben usarse para automatización determinista más simple.

Instalación

Usa esta configuración de servidor en clientes MCP que admitan servidores HTTP remotos:

{
  "mcpServers": {
    "docsie": {
      "type": "http",
      "url": "https://app.docsie.io/mcp"
    }
  }
}

La sintaxis exacta varía según el cliente. La URL estable del servidor es:

https://app.docsie.io/mcp

Open Plugins / Cursor Store

Este repositorio incluye archivos de descubrimiento de Open Plugins en la raíz del repositorio:

• .plugin/plugin.json
• .cursor-plugin/plugin.json
• .mcp.json
• mcp.json

El componente MCP de Open Plugins usa mcp-remote para conectar hosts de plugins stdio locales al endpoint MCP OAuth alojado de Docsie:

{
  "mcpServers": {
    "docsie": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.docsie.io/mcp"]
    }
  }
}

Borradores de configuración específicos por cliente:

• Claude
• ChatGPT / OpenAI
• Cursor
• Windsurf
• VS Code
• GitHub Copilot
• Smithery
• mcp-remote

Los clientes MCP solo locales también pueden usar:

• envoltorio stdio npm: npx -y docsie-mcp
• envoltorio stdio PyPI / uvx: uvx docsie-mcp

El código fuente del envoltorio está en mcp-packages/. Los ejemplos de configuración están en examples/.

Verificación

Pruebas unitarias del envoltorio:

npm test --prefix mcp-packages/npm
python -m pytest mcp-packages/pypi/tests

Prueba de humo en vivo contra el servidor alojado:

DOCSIE_MCP_ENDPOINT=https://staging.docsie.io/mcp \
DOCSIE_MCP_TOKEN=... \
node scripts/verify-live-tools.mjs

Para probar un comando de puente local diferente:

DOCSIE_MCP_COMMAND="uvx docsie-mcp" \
DOCSIE_MCP_TOKEN=... \
node scripts/verify-live-tools.mjs

La prueba de humo en vivo verifica initialize, tools/list, las herramientas requeridas de Docsie, la forma del esquema JSON, los títulos de las herramientas y las anotaciones de herramientas MCP.

Para verificar también llamadas seguras a herramientas en vivo:

DOCSIE_MCP_ENDPOINT=https://staging.docsie.io/mcp \
DOCSIE_MCP_TOKEN=... \
DOCSIE_MCP_VERIFY_CALLS=1 \
DOCSIE_MCP_EXPECTED_WORKSPACE_ID=workspace_... \
node scripts/verify-live-tools.mjs

La verificación de llamadas confirma el descubrimiento de espacios de trabajo con alcance mediante list_workspaces y la estimación no mutante de créditos de video mediante video_to_docs_estimate.

Prueba de humo E2E real de video a documentos, solo para staging:

DOCSIE_MCP_ENDPOINT=https://staging.docsie.io/mcp \
DOCSIE_MCP_TOKEN=... \
DOCSIE_MCP_E2E_CONFIRM=1 \
DOCSIE_MCP_E2E_VIDEO_URL=https://example.com/small-video.mp4 \
DOCSIE_MCP_E2E_WORKSPACE_ID=workspace_... \
node scripts/verify-video-to-docs-e2e.mjs

Esto crea un trabajo real de video a documentos, consulta el análisis hasta su finalización, ejecuta la generación, verifica los enlaces/contenido de documentos generados de Docsie y consume créditos de IA de Docsie. El script establece auto_generate=false por defecto para que el E2E controle el paso de generación explícitamente. La verificación opcional de exportación está disponible con DOCSIE_MCP_E2E_EXPORT_FORMATS=docx.

Para reanudar o verificar una ejecución de staging sin enviar un nuevo video:

DOCSIE_MCP_ENDPOINT=https://staging.docsie.io/mcp \
DOCSIE_MCP_TOKEN=... \
DOCSIE_MCP_E2E_CONFIRM=1 \
DOCSIE_MCP_E2E_EXISTING_FINAL_JOB_ID=job_key_... \
node scripts/verify-video-to-docs-e2e.mjs

Descubrimiento OAuth

Docsie publica metadatos MCP OAuth en:

https://app.docsie.io/.well-known/oauth-authorization-server
https://app.docsie.io/.well-known/oauth-authorization-server/mcp
https://app.docsie.io/.well-known/oauth-protected-resource
https://app.docsie.io/.well-known/oauth-protected-resource/mcp

Puntos finales OAuth:

https://app.docsie.io/mcp/oauth/register/
https://app.docsie.io/mcp/oauth/authorize/
https://app.docsie.io/mcp/oauth/token/
https://app.docsie.io/mcp/oauth/revoke/

Paquetes de Permisos

El acceso a Docsie MCP está limitado por:

• Identidad del usuario de Docsie
• Organización seleccionada
• Espacio de trabajo seleccionado
• Membresía del espacio de trabajo
• Paquetes de permisos explícitos

Los paquetes de permisos comunes incluyen:

• workspace_read: leer y buscar conocimiento de Docsie
• workspace_write: crear y actualizar contenido de documentación, guardar comparaciones y gestionar plantillas persistentes de llenado de Word del espacio de trabajo
• video_docs: flujos de trabajo de video a documentos, trabajos nativos de comparar/combinar videos, llenado de plantillas de Word, verificaciones de políticas, anotaciones avanzadas y soporte de comparación
• video_presentation: análisis de video orientado a presentaciones, flujos de exportación PPTX y sesiones de presentador en vivo
• imports: importación de archivos, extracción de sitios web, flujos de investigación y comparaciones respaldadas por web
• publishing: implementaciones, visibilidad, solicitudes de archivos y herramientas de publicación relacionadas
• billing: opciones de flujo de trabajo pagadas aprobadas mediante enlaces de Stripe Checkout compatibles con CLI y solicitudes de pago x402
• agent_runs: iniciar, monitorear, cancelar y obtener ejecuciones de agentes de fondo remotos de Docsie, con herramientas de descubrimiento de voz cuando estén habilitadas para el espacio de trabajo

Usa el conjunto más pequeño de paquetes de permisos necesario para tu flujo de trabajo.

También están disponibles credenciales de servicio gestionadas por la organización para agentes compartidos que deben ejecutarse con una cuenta fija de Docsie en lugar de requerir que cada usuario final inicie sesión. Las credenciales de servicio están limitadas a una organización, un espacio de trabajo seleccionado y paquetes de permisos explícitos.

Más detalles:

• Herramientas
• Privacidad y Permisos
• Seguridad
• Tokens de Servicio
• Solución de Problemas

Controles de Flujos de Trabajo Pagados

Algunos flujos de automatización de Docsie pueden requerir capacidad de procesamiento adicional.

Cuando se requiere más capacidad, Docsie MCP puede devolver:

• Un respaldo alojado de Stripe Checkout
• Una solicitud de pago x402 para clientes de agentes compatibles
• Pasos siguientes estructurados que expliquen el flujo de trabajo solicitado, la autorización requerida y la ruta de reintento

Las herramientas de pago agénticas requieren el paquete de permisos billing. El acceso a flujos de trabajo pagados se concede solo después de la verificación y liquidación del pago.

Ejemplos de Prompts

List my Docsie workspaces.
Search Docsie knowledge for onboarding API documentation.
Fetch the article content for the selected Docsie article.
Turn this product walkthrough video into Docsie documentation.
Fill this SOP Word template from the training video.
Check this onboarding video against our PII policy.
Create a presentation from this product demo video.
Analyze these videos and compare the generated procedures.
Buy 100000 Docsie AI credits and give me the payment link.
Find the customer-facing setup steps for this feature.
Create a draft article from the approved workspace knowledge.

Enlaces

• Docsie: https://www.docsie.io/
• Aplicación: https://app.docsie.io/
• Documentación: https://docsie.com/
• Privacidad y términos: https://terms.docsie.io/

Soporte

Para soporte de directorio MCP e integración, contacta a phil@docsie.io.