Docsie

Servidor MCP de Docsie para Video a Documentos

Servidor MCP remoto para el Directorio de Conectores de Anthropic. Convierte videos en documentación estructurada usando Dokuta AI.

Qué Hace

Los usuarios en Claude pueden:

1. Enviar una URL de video (YouTube, Loom, Vimeo, MP4 directo, etc.)
2. Elegir un tipo de documento (guía de usuario, SOP, documentación de producto, política, blog)
3. Recibir documentación estructurada en markdown

Nivel gratuito: Los videos de hasta 5 minutos se procesan gratis. Los videos más largos requieren una cuenta de Docsie con créditos de IA.

Arquitectura

Claude → POST https://mcp.docsie.io/mcp (Bearer token)
              │
              ├─→ Docsie /o2/ (OAuth2 token validation)
              ├─→ Dokuta API (video analysis)
              └─→ Docsie /api/internal/mcp/ (credit deduction)

• Transporte: Streamable HTTP (especificación MCP)
• Autenticación: Código de Autorización OAuth2 + PKCE a través del proveedor /o2/ de Docsie
• Tiempo de ejecución: Python 3.12 + FastMCP + Starlette + uvicorn

Herramientas MCP

Herramienta	Descripción
analyze_video	Enviar una URL de video para la generación de documentación
check_job_status	Consultar el progreso y recuperar los resultados completados
list_doc_types	Listar los tipos de documentos y niveles de calidad disponibles

Desarrollo Local

cd mcp-server

# Install dependencies
pip install -e .

# Configure environment
cp .env.example .env
# Edit .env with your Dokuta API key and Docsie internal URL

# Run
uvicorn app.main:app --reload --port 8000

Endpoints de prueba

# Health check
curl http://localhost:8000/health

# OAuth metadata
curl http://localhost:8000/.well-known/oauth-authorization-server

# MCP tool listing (via MCP protocol)
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'

Variables de Entorno

Variable	Descripción	Predeterminado
MCP_DOCSIE_BASE_URL	URL pública de Docsie (para metadatos OAuth)	https://app.docsie.io
MCP_DOCSIE_INTERNAL_URL	URL interna de Docsie (para llamadas API)	http://docsie-web:8080
MCP_DOKUTA_API_URL	API de análisis de video de Dokuta	https://app.videodokuta.com/api/v1
MCP_DOKUTA_API_KEY	Clave API de Dokuta	(requerido)
MCP_MCP_INTERNAL_API_KEY	Secreto compartido para endpoints internos de Django	(requerido)
MCP_OAUTH2_CLIENT_ID	ID de cliente OAuth2 para la aplicación MCP	(requerido)
MCP_FREE_TIER_MAX_SECONDS	Duración máxima de video gratuito en segundos	300

Despliegue (Kubernetes)

Las imágenes Docker se construyen y se publican automáticamente mediante GitHub Actions al hacer push a main.

# Deploy with Helm (secrets managed via Doppler)
helm upgrade --install mcp-staging helm/docsie-mcp/ \
  -n mcp \
  --set image.tag=v2026.04.06.01 \
  --set doppler.token=$DOPPLER_SERVICE_TOKEN

Configuración del lado de Django

1. Agregar la clave API interna a la configuración de Django

En tu .env o entorno:

MCP_INTERNAL_API_KEY=your-shared-secret-here

2. Registrar la aplicación OAuth2

En el administrador de Django en /o2/applications/register/:

• Nombre: Claude MCP Connector
• Tipo de cliente: Público
• Tipo de concesión de autorización: Código de autorización
• URIs de redirección: (proporcionadas por Anthropic durante el registro en el directorio)
• Omitir autorización: Sí

3. Endpoints internos (ya conectados)

• GET /api/internal/mcp/user-context/ — validación de token + información del usuario
• POST /api/internal/mcp/deduct-credits/ — deducción de créditos

Envío al Directorio de Conectores de Anthropic

Para enviar al directorio, necesitarás:

1. URL del servidor MCP: https://mcp.docsie.io/mcp
2. URL de metadatos OAuth2: https://mcp.docsie.io/.well-known/oauth-authorization-server
3. Nombre de la empresa: Docsie Inc.
4. Descripción: "Convierte videos en documentación estructurada usando IA. Envía una URL de video y recibe una guía de usuario, SOP, documentación de producto o publicación de blog."
5. Logotipo: Logotipo de Docsie (SVG/PNG)
6. Política de privacidad: https://www.docsie.io/privacy-policy/
7. Términos de servicio: https://www.docsie.io/terms-of-service/

Enviar en: https://console.anthropic.com/dashboard/connectors