EntrarCriar conta grátis
  1. Início
  2. Documentação
  3. Autenticação

Autenticação

Como funciona o acesso ao MCPTube: um só endereço /mcp, que funciona sem conta e abre o login (OAuth 2.1) quando precisa, e chaves de API para scripts e CI.

O MCPTube tem um só endereço para clientes MCP: https://mcp.mcptube.com/mcp. Ele funciona sem conta e passa a usar o plano da sua conta quando você entra. Todas as formas de uma mesma conta dividem a mesma cota: criar várias chaves não multiplica o limite.

Como você chamaPlano
/mcp sem credencialAnônimo, com cota por IP.
/mcp depois do login (OAuth)O da sua conta: Gratuito ou Pro.
/mcp ou /v1 com chave no header AuthorizationO da sua conta.

Sem login

Sem credencial, o /mcp responde no plano anônimo: 5 chamadas por dia, contadas por IP, vídeos até 480p e 30 minutos, sem transcrição por IA e sem chave de API.

Quando um pedido passa do plano anônimo (a cota do dia acabou, o vídeo tem mais de 30 minutos ou pede transcrição por IA), o servidor responde 401 com WWW-Authenticate e o próprio cliente abre o login do MCPTube. Isso acontece no máximo uma vez por dia; nas outras vezes, a resposta explica o limite e traz o link para criar a conta. Resolução acima de 480p não é recusada: o vídeo vem em 480p, com um aviso.

Login OAuth no MCP

É o caminho para clientes MCP. O MCPTube segue a especificação de autorização do MCP:

  1. O cliente recebe 401 com WWW-Authenticate: Bearer resource_metadata="https://mcp.mcptube.com/.well-known/oauth-protected-resource/mcp": quando o pedido passa do plano anônimo, ou logo na conexão se o endereço for https://mcp.mcptube.com/mcp?login=1.
  2. Ele lê os metadados do recurso e descobre o servidor de autorização: https://app.mcptube.com/api/auth.
  3. O cliente se registra sozinho (Dynamic Client Registration) e abre o navegador em app.mcptube.com/login.
  4. Você entra com Google, GitHub ou e-mail e autoriza o acesso. O cliente recebe um token que vale só para https://mcp.mcptube.com/mcp, com PKCE (S256).

Você não precisa copiar nada: basta colar o endereço /mcp no cliente. Quer usar o seu plano desde a primeira chamada? Cole https://mcp.mcptube.com/mcp?login=1. Um token inválido ou vencido recebe 401, nunca cai no plano anônimo. Para desconectar, remova o conector no cliente.

Chave de API

Para scripts, automações e CI, crie uma chave no painel. O plano Gratuito tem 1 chave ativa e o Pro, até 10, cada uma com um nome que aparece no histórico de uso.

Header
Authorization: Bearer mct_SUA_CHAVE
  • A chave completa aparece uma única vez, logo depois de criada. Não guardamos a chave em si, só uma impressão dela que permite conferir.
  • Com uma chave inválida ou revogada, a resposta é 401. A chamada não cai no plano anônimo.
  • Revogar vale na hora para todos os clientes que usam a chave.