Docsie

Servidor MCP Docsie de Vídeo para Documentação

Servidor MCP remoto para o Diretório de Conectores da Anthropic. Converte vídeos em documentação estruturada usando a IA Dokuta.

O Que Ele Faz

Usuários no Claude podem:

1. Enviar uma URL de vídeo (YouTube, Loom, Vimeo, MP4 direto, etc.)
2. Escolher um tipo de documento (guia do usuário, POP, documentação de produto, política, blog)
3. Receber documentação em markdown estruturado de volta

Plano gratuito: Vídeos de até 5 minutos são processados gratuitamente. Vídeos mais longos exigem uma conta Docsie com créditos de IA.

Arquitetura

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: HTTP Streamable (especificação MCP)
• Autenticação: OAuth2 Authorization Code + PKCE via provedor /o2/ da Docsie
• Runtime: Python 3.12 + FastMCP + Starlette + uvicorn

Ferramentas MCP

Ferramenta	Descrição
analyze_video	Enviar uma URL de vídeo para geração de documentação
check_job_status	Consultar o progresso e recuperar resultados concluídos
list_doc_types	Listar tipos de documentos e níveis de qualidade disponíveis

Desenvolvimento 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 teste

# 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":{}}'

Variáveis de Ambiente

Variável	Descrição	Padrão
MCP_DOCSIE_BASE_URL	URL pública da Docsie (para metadados OAuth)	https://app.docsie.io
MCP_DOCSIE_INTERNAL_URL	URL interna da Docsie (para chamadas de API)	http://docsie-web:8080
MCP_DOKUTA_API_URL	API de análise de vídeo Dokuta	https://app.videodokuta.com/api/v1
MCP_DOKUTA_API_KEY	Chave de API Dokuta	(obrigatório)
MCP_MCP_INTERNAL_API_KEY	Segredo compartilhado para endpoints internos do Django	(obrigatório)
MCP_OAUTH2_CLIENT_ID	ID do cliente OAuth2 para o aplicativo MCP	(obrigatório)
MCP_FREE_TIER_MAX_SECONDS	Duração máxima gratuita de vídeo em segundos	300

Implantação (Kubernetes)

As imagens Docker são construídas e enviadas automaticamente via GitHub Actions ao fazer push para 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

Configuração do Lado Django

1. Adicionar chave de API interna às configurações do Django

No seu .env ou ambiente:

MCP_INTERNAL_API_KEY=your-shared-secret-here

2. Registrar Aplicação OAuth2

No admin do Django em /o2/applications/register/:

• Nome: Claude MCP Connector
• Tipo de cliente: Público
• Tipo de concessão de autorização: Código de autorização
• URIs de redirecionamento: (fornecidos pela Anthropic durante o registro no diretório)
• Pular autorização: Sim

3. Endpoints internos (já conectados)

• GET /api/internal/mcp/user-context/ — validação de token + informações do usuário
• POST /api/internal/mcp/deduct-credits/ — dedução de créditos

Submissão ao Diretório de Conectores da Anthropic

Para enviar ao diretório, você precisará de:

1. URL do servidor MCP: https://mcp.docsie.io/mcp
2. URL de metadados OAuth2: https://mcp.docsie.io/.well-known/oauth-authorization-server
3. Nome da empresa: Docsie Inc.
4. Descrição: "Converta vídeos em documentação estruturada usando IA. Envie uma URL de vídeo e receba de volta um guia do usuário, POP, documentação de produto ou post de blog."
5. Logotipo: Logotipo da Docsie (SVG/PNG)
6. Política de privacidade: https://www.docsie.io/privacy-policy/
7. Termos de serviço: https://www.docsie.io/terms-of-service/

Envie em: https://console.anthropic.com/dashboard/connectors