Docsie MCP

Docsie MCP

O Docsie MCP conecta assistentes de IA à plataforma de documentação de IA da Docsie para busca em bases de conhecimento, recuperação de central de ajuda e documentação de produtos, automação de vídeo para documentação, comparação nativa de múltiplos vídeos, preenchimento de modelos do Word, verificações de política/conformidade, criação de apresentações, importações de conteúdo, fluxos de publicação, execuções de agentes Docsie com escopo e recargas de créditos de IA via CLI.

Servidor Remoto

Use o endpoint MCP hospedado:

https://app.docsie.io/mcp

Transporte:

Streamable HTTP

Autenticação:

OAuth2 Authorization Code + PKCE

O Que Ele Faz

O Docsie MCP permite que clientes de IA compatíveis com MCP se conectem à Docsie para que os usuários possam:

• Pesquisar bases de conhecimento aprovadas, centrais de ajuda, documentos de produtos, SOPs, notas de versão e artigos de suporte
• Recuperar conteúdo de artigos e estrutura de workspaces da Docsie
• Transformar demonstrações de produtos, vídeos de treinamento, gravações de tela e walkthroughs em documentação passo a passo
• Preencher modelos do Word do cliente a partir de análise de vídeo, preservando o layout original do DOCX
• Verificar vídeos, áudio, texto e documentação gerada contra regras de política, como PII, HIPAA, marca, QA de treinamento ou políticas personalizadas
• Criar saída pronta para apresentação e sessões de apresentador ao vivo a partir de documentação gerada por vídeo
• Comparar ou combinar múltiplos vídeos por meio de jobs MCP nativos e, em seguida, buscar a matriz de comparação ou o rascunho combinado
• Gerar, reescrever, traduzir e exportar documentação como Markdown, DOCX, PDF ou PPTX
• Importar arquivos, sites e conteúdo web extraído para fluxos de documentação da Docsie
• Publicar bases de conhecimento, ajuda no aplicativo, domínios personalizados, formulários e fluxos de solicitação de arquivos quando concedido
• Delegar tarefas complexas de documentação e descoberta por voz a agentes de IA da Docsie com escopo definido
• Solicitar opções de pagamento aprovadas para fluxos de automação estendidos da Docsie

Os usuários se autenticam na Docsie, escolhem uma organização e um contexto de workspace e concedem pacotes de permissão explícitos antes que as ferramentas sejam expostas.

Modelo de Roteamento de Ferramentas

O Docsie MCP expõe duas maneiras complementares de automatizar a Docsie:

Caso de uso	Use estas ferramentas	Por quê
Jobs simples no estilo API	video_to_docs_submit, video_to_docs_status, video_to_docs_result, video_compare_submit, video_compare_status, video_compare_result	O cliente MCP envia um job, mantém o job_id retornado e consulta o status/resultado diretamente.
Fluxos de trabalho no estilo Docsie Chat	docsie_agent_start, docsie_agent_status, docsie_agent_result	A Docsie cria uma sessão de chat oculta e permite que o agente Docsie orquestre o trabalho multi-etapas internamente.

Use docsie_agent_start para fluxos de trabalho complexos em linguagem natural, como:

• analisar um vídeo com Dokuta, aguardar a conclusão, gerar documentação, reescrevê-la e importá-la
• preencher um modelo Word/DOCX a partir de vídeo ou documentação gerada
• comparar ou combinar vídeos e produzir um rascunho final de documentação
• executar verificações de política/conformidade e resumir descobertas
• publicar ou finalizar conteúdo Docsie gerado após a criação
• qualquer fluxo de trabalho que deva se comportar como o assistente Docsie Chat no aplicativo

O agente remoto pode usar as ferramentas internas da Docsie vinculadas à sessão, incluindo monitoramento de operações, porque a execução do agente possui uma sessão de chat Docsie. As ferramentas de job MCP direto são intencionalmente baseadas em ID de job e devem ser usadas para automação determinística mais simples.

Instalação

Use esta configuração de servidor em clientes MCP que suportam servidores HTTP remotos:

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

A sintaxe exata varia conforme o cliente. A URL estável do servidor é:

https://app.docsie.io/mcp

Open Plugins / Cursor Store

Este repositório inclui arquivos de descoberta do Open Plugins na raiz:

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

O componente MCP do Open Plugins usa mcp-remote para conectar hosts de plugins locais via stdio ao endpoint OAuth hospedado da Docsie:

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

Rascunhos de configuração específicos por cliente:

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

Clientes MCP somente locais também podem usar:

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

O código-fonte dos wrappers está em mcp-packages/. Exemplos de configuração estão em examples/.

Verificação

Testes de unidade dos wrappers:

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

Teste de fumaça ao vivo contra o servidor hospedado:

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

Para testar um comando de ponte local diferente:

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

O teste de fumaça ao vivo verifica initialize, tools/list, as ferramentas Docsie necessárias, a forma do JSON Schema, títulos de ferramentas e anotações de ferramentas MCP.

Para também verificar chamadas de ferramentas ao vivo seguras:

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

A verificação de chamadas confirma a descoberta de workspace com escopo por meio de list_workspaces e a estimativa não mutável de créditos de vídeo por meio de video_to_docs_estimate.

Teste de fumaça E2E real de vídeo para documentação, apenas 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

Isso cria um job real de vídeo para documentação, aguarda a conclusão da análise, executa a geração, verifica os links/conteúdo dos documentos Docsie gerados e consome créditos de IA da Docsie. O script define auto_generate=false por padrão para que o E2E controle a etapa de geração explicitamente. Verificação opcional de exportação está disponível com DOCSIE_MCP_E2E_EXPORT_FORMATS=docx.

Para retomar ou verificar uma execução de staging sem enviar um novo vídeo:

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

Descoberta OAuth

A Docsie publica metadados OAuth MCP em:

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

Endpoints 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/

Pacotes de Permissão

O acesso ao Docsie MCP é limitado por:

• Identidade do usuário da Docsie
• Organização selecionada
• Workspace selecionado
• Associação ao workspace
• Pacotes de permissão explícitos

Os pacotes de permissão comuns incluem:

• workspace_read: ler e pesquisar o conhecimento da Docsie
• workspace_write: criar e atualizar conteúdo de documentação, salvar comparações e gerenciar modelos de preenchimento de Word persistentes no workspace
• video_docs: fluxos de trabalho de vídeo para documentação, jobs nativos de comparação/combinação de vídeo, preenchimento de modelos Word, verificações de política, anotações avançadas e suporte a comparação
• video_presentation: análise de vídeo orientada a apresentações, fluxos de exportação PPTX e sessões de apresentador ao vivo
• imports: importação de arquivos, extração de sites, fluxos de pesquisa e comparações com suporte web
• publishing: implantações, visibilidade, solicitações de arquivos e ferramentas de publicação relacionadas
• billing: opções de fluxo de trabalho pagas aprovadas por meio de links Stripe Checkout compatíveis com CLI e solicitações de pagamento x402
• agent_runs: iniciar, monitorar, cancelar e buscar execuções de agentes Docsie em segundo plano, com ferramentas de descoberta por voz quando habilitadas para o workspace

Use o menor conjunto de pacotes de permissão necessário para seu fluxo de trabalho.

Credenciais de serviço gerenciadas pela organização também estão disponíveis para agentes compartilhados que devem ser executados com uma conta Docsie fixa, em vez de exigir que cada usuário faça login. As credenciais de serviço são limitadas a uma organização, um workspace selecionado e pacotes de permissão explícitos.

Mais detalhes:

• Ferramentas
• Privacidade e Permissões
• Segurança
• Tokens de Serviço
• Solução de Problemas

Controles de Fluxos de Trabalho Pagos

Alguns fluxos de automação da Docsie podem exigir capacidade de processamento adicional.

Quando mais capacidade é necessária, o Docsie MCP pode retornar:

• Um fallback hospedado de Stripe Checkout
• Uma solicitação de pagamento x402 para clientes de agente compatíveis
• Próximos passos estruturados que explicam o fluxo de trabalho solicitado, a autorização necessária e o caminho de nova tentativa

As ferramentas de pagamento agênticas exigem o pacote de permissão billing. O acesso a fluxos de trabalho pagos é concedido somente após verificação e liquidação do pagamento.

Exemplos 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.

Links

• Docsie: https://www.docsie.io/
• App: https://app.docsie.io/
• Documentação: https://docsie.com/
• Privacidade e termos: https://terms.docsie.io/

Suporte

Para suporte ao diretório MCP e integração, entre em contato com phil@docsie.io.