Servidor MCP da Virelia

Última atualização em 22 de outubro de 2026

O servidor MCP deixa qualquer IA compatível com o Model Context Protocol — Claude Code, Claude Desktop, Cursor, Windsurf e outras — usar a sua conta Virelia. Você pede em linguagem natural ("gera um relatório dos meus concorrentes e agenda os 3 melhores roteiros pra semana que vem") e a IA faz o resto.

Toda ação roda como você, com os mesmos limites e créditos do seu plano. É exclusivo do plano Pro. Sem ele, o servidor responde avisando isso.

Endereço do servidor

https://api.usevirelia.com/mcp

Transporte Streamable HTTP, autenticação por chave no cabeçalho Authorization.

1. Gere sua chave

  1. Entre na Virelia e abra Configurações.
  2. Em "Integração com IA (MCP)", dê um nome e clique em Gerar chave.
  3. Copie a chave na hora — por segurança ela só aparece uma vez. Ela começa com vir_mcp_.

Trate a chave como uma senha. Se ela vazar, revogue em Configurações e gere outra; a antiga para de funcionar no mesmo instante.

2. Conecte na sua IA

Claude Code

Rode no terminal:

claude mcp add --transport http virelia https://api.usevirelia.com/mcp --header "Authorization: Bearer vir_mcp_..."

Cursor, Windsurf e clientes com MCP remoto

Adicione no arquivo de configuração de MCP do cliente (no Cursor: Settings → MCP → Add new server):

{
  "mcpServers": {
    "virelia": {
      "url": "https://api.usevirelia.com/mcp",
      "headers": {
        "Authorization": "Bearer vir_mcp_..."
      }
    }
  }
}

Claude Desktop

Em Settings → Developer → Edit Config, adicione ao claude_desktop_config.json (precisa do Node.js instalado) e reinicie o app:

{
  "mcpServers": {
    "virelia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.usevirelia.com/mcp",
        "--header",
        "Authorization: Bearer vir_mcp_..."
      ]
    }
  }
}

Claude no navegador e ChatGPT

Conexão com um clique (login e aprovação, sem copiar chave) chega em breve.

3. Peça o que quiser

  • "Quantos créditos eu tenho e quais concorrentes estão cadastrados?"
  • "Adiciona @perfilx e @perfily como referência e gera um relatório de 90 dias."
  • "Quais os 5 melhores ganchos do meu último relatório?"
  • "Agenda o roteiro 2 pra segunda e o 3 pra quarta."
  • "Transforma o primeiro roteiro num carrossel roxo e me mostra as imagens."
  • "O que está bombando no meu nicho essa semana?"

Ferramentas disponíveis

Conta, perfil e concorrentes

  • get_account — Plano, créditos, perfil próprio e concorrentes cadastrados.
  • set_own_profile — Define o @ do seu perfil, usado pra adaptar os roteiros ao seu estilo.
  • list_competitors — Lista os perfis de referência que entram nos relatórios.
  • add_competitor — Cadastra um perfil de referência (até 5 por rede no Pro).
  • remove_competitor — Remove um perfil de referência.
  • set_competitor_active — Liga ou pausa um concorrente nos próximos relatórios.

Relatórios

  • create_report — Gera um relatório de estratégia dos concorrentes ativos. Pago, pede confirmação.
  • list_reports — Lista seus relatórios com status.
  • get_report — Ranking dos vídeos, padrões vencedores, banco de ganchos, roteiros prontos e insight principal.
  • cancel_report — Cancela um relatório que ainda está processando.
  • analyze_video — Prévia gratuita de um Reel ou TikTok a partir do link.
  • create_report_from_video — Relatório completo a partir de um único vídeo de referência. Pago.

Radar de Tendências

  • list_radar_watches — Nichos que você acompanha.
  • get_radar — Vídeos que estouraram acima da média e os padrões em alta no nicho.
  • watch_niche — Começa a acompanhar um nicho, atualizado toda semana.
  • create_trend_scripts — Roteiros adaptados ao seu perfil a partir de uma tendência. Pago.

Calendário de conteúdo

  • list_calendar — Roteiros agendados entre duas datas.
  • schedule_script — Coloca um roteiro de relatório numa data.
  • update_calendar_entry — Muda a data ou marca como gravado/postado.
  • remove_calendar_entry — Tira um item do calendário.

Carrossel

  • list_carousels — Carrosséis já criados.
  • generate_carousel — A IA cria um carrossel completo (texto e design, formato 4:5). Pago.
  • get_carousel_images — Devolve os slides em PNG 1080×1350, prontos pra postar.

Créditos e segurança

  • Ações que gastam crédito (relatórios, roteiros de tendência e carrossel com IA) só rodam com confirmação explícita — a IA precisa te perguntar antes.
  • A IA enxerga só a sua conta, e nada é publicado nas redes sociais: o calendário apenas organiza.
  • Limite de 120 chamadas por minuto por chave, além dos limites normais do seu plano.
  • Você pode ter até 5 chaves ativas e revogar qualquer uma a qualquer momento.