Markovo

npx add-mcp 'https://markovo.net/mcp'

Markovo Remote MCP

Endpoint canônico Streamable HTTP: https://markovo.net/mcp

O Markovo Remote MCP permite que um host MCP use uma conta Markovo sem pedir ao usuário para copiar uma credencial em um prompt ou arquivo de configuração. O host segue o fluxo de descoberta OAuth 2.1 do MCP, abre o login do Markovo e pede ao proprietário da conta que aprove os escopos solicitados. Authorization Code com PKCE é obrigatório; os tokens são vinculados ao público do recurso MCP do Markovo.

Conectar

Adicione esta URL como um servidor MCP remoto personalizado em um cliente que suporte Streamable HTTP e OAuth:

https://markovo.net/mcp

A primeira conexão retorna a URL de metadados do recurso protegido. O cliente então descobre o servidor de autorização do Markovo, registra seu URI de redirecionamento quando necessário, abre as páginas de login e consentimento do Markovo e retorna após a aprovação. Apenas URIs de redirecionamento HTTPS são aceitos, exceto redirecionamentos HTTP de loopback padrão usados por clientes desktop nativos.

Os escopos disponíveis são:

• markovo:read: capacidades de leitura, uso de Créditos, jobs próprios e metadados verificados de imagens de resultado.
• markovo:convert: estimar e enfileirar uma conversão para uma única página HTTPS pública fornecida explicitamente, e gerenciar concessões de imagens de resultado de curta duração.

A tela de autorização não compartilha senha do Markovo, credencial de cobrança, acesso de administrador ou conteúdo de documentos com o cliente MCP. Desconecte ou revogue a integração no cliente conectado quando não for mais necessária.

Ferramentas

• markovo_capabilities: listar capacidades e limites de conversão suportados.
• markovo_usage: inspecionar o saldo de Créditos do workspace autenticado.
• markovo_jobs: listar jobs recentes pertencentes ao workspace autenticado.
• markovo_job_status: inspecionar um job próprio.
• markovo_convert_url: converter uma fonte HTTPS pública suportada após aplicar um teto explícito de max_credit_units.
• markovo_job_assets: listar imagens verificadas em um resultado concluído.
• markovo_create_asset_link: criar uma URL pública de imagem impossível de adivinhar que expira após 60–600 segundos.
• markovo_revoke_asset_link: revogar uma URL de imagem antecipadamente.
• markovo_billing_help: retornar uso e a página oficial de cobrança sem abrir checkout ou alterar a conta.

O Remote MCP deliberadamente não possui ferramentas de arquivo local, requisição de rede arbitrária, shell, sistema de arquivos, credencial, mutação de cobrança ou administrador. Use a distribuição local stdio descrita em https://markovo.net/docs#mcp, ou upload multipart REST, quando um arquivo na sua máquina precisar ser convertido.

Créditos e cobrança

markovo_convert_url primeiro obtém uma estimativa no lado do servidor. Ele enfileira o job somente quando estimated_credit_units está igual ou abaixo do valor positivo de max_credit_units do chamador. Um Crédito equivale a 1.000 unidades de crédito. Um job com falha, tempo esgotado ou cancelado pelo sistema não é cobrado.

O Markovo nunca compra Créditos, inicia checkout, altera um plano ou tenta novamente um job acima do teto confirmado automaticamente. Quando a conta não tem Créditos, a ferramenta retorna orientação estruturada de recuperação e o proprietário da conta pode escolher o que fazer em https://markovo.net/app#billing.

Segurança de página pública e link de resultado

A conversão de URL aceita uma fonte HTTPS pública suportada: HTML/texto, um Google Doc público, uma página do Notion ou banco de dados limitado, recursos de texto do GitHub ou discussões, um tópico do Hacker News ou um vídeo do YouTube baixável. Ela não envia cookies ou credenciais do chamador, rejeita alvos de rede privada e com credenciais, segue redirecionamentos limitados e aplica limites de conteúdo e tempo. Fontes privadas, assinadas, somente login, somente navegador, arquivos binários genéricos e Tencent Docs não são suportadas. Imagens remotas de documentos não são baixadas.

O YouTube usa transcrição de áudio a 0,5 Créditos por minuto decodificado, com mínimo de 0,3 Créditos, em vez da taxa de tempo de busca de URL e contagem de palavras. O áudio deve caber em uma hora, 32 MB e no limite de upload da conta. Legendas não são obrigatórias; quadros de vídeo não são analisados. Revise a transcrição em relação à gravação.

Por exemplo, chame markovo_convert_url com {"url":"https://example.com/","max_credit_units":15000} para um teto de 15 Créditos. A chamada de URL específica autoriza buscar essa fonte. O Remote MCP permanece autenticado via OAuth; as prévias de convidado na Web são um fluxo separado. Para arquivos locais e configuração stdio, use o guia do desenvolvedor stdio local ou CLI.

Um link de ativo é uma capacidade de portador: qualquer pessoa que o receber pode visualizar aquela imagem até a expiração ou revogação. Não registre nem persista a URL. O endereço de armazenamento subjacente nunca é divulgado.

Suporte e políticas

• Documentação do produto: https://markovo.net/docs
• Preços e Créditos: https://markovo.net/pricing
• Cobrança: https://markovo.net/app#billing
• Privacidade: https://markovo.net/privacy
• Termos: https://markovo.net/terms
• Suporte: support@markovo.net
• Encontrou um problema de conversão? Relate um caso reproduzível para support@markovo.net. Se confirmarmos e corrigirmos, você receberá 1 mês de Markovo Pro.

Revise a saída da conversão em relação à fonte antes de usá-la para decisões de consequências importantes.