VibeKit.bot

Servidor MCP para implantar, hospedar e operar aplicativos web e agentes de codificação de IA no VibeKit (listar aplicativos, ler logs, gerenciar variáveis de ambiente, consultar Postgres, executar QA e enviar tarefas de codificação que fazem commit no GitHub e implantam).

Documentação

Servidor MCP do VibeKit

Um servidor Model Context Protocol que permite que Claude Desktop, Cursor, Zed, Continue, qualquer cliente MCP, opere sua conta VibeKit diretamente. Faça deploy de repositórios GitHub, defina variáveis de ambiente, acompanhe logs, converse com agentes hospedados. Diga ao Claude "faça o deploy disso e defina a chave da API"; o Claude faz.

Conector remoto, sem instalação

Para clientes que aceitam uma URL MCP remota (conectores web do claude.ai, ChatGPT e outros), não há nada para instalar, basta colar esta URL:

https://mcp.vibekit.bot/mcp?api_key=vk_your_api_key_here

Clientes que permitem definir cabeçalhos podem usar o https://mcp.vibekit.bot/mcp puro com Authorization: Bearer vk_your_api_key_here. Obtenha uma chave de @the_vibe_kit_bot no Telegram com /apikey.

Já adicionou um servidor vibekit, ou está rotacionando sua chave? Prefira o formato de cabeçalho. Como a URL ?api_key= incorpora a chave no endpoint, trocar as chaves significa substituir toda a entrada do servidor, e alguns clientes mantêm a antiga até você sobrescrevê-la explicitamente, então você pode acabar autenticando com uma chave desatualizada sem perceber. Com a URL pura + cabeçalho Authorization: Bearer (ou a variável de ambiente VIBEKIT_API_KEY para local/stdio), o endpoint nunca muda, então rotacionar uma chave é apenas trocar o valor do cabeçalho. Se o seu cliente adicionou o formato de URL, exclua a entrada vibekit existente antes de adicionar novamente, em vez de adicionar uma segunda.

Instalação (local / stdio)

Prefere executar localmente (ex.: Claude Desktop, Cursor)?

npm install -g vibekit-mcp

Obtenha uma chave de API VibeKit de @the_vibe_kit_bot no Telegram com /apikey.

Configurar o Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou o equivalente no Windows / Linux:

{
  "mcpServers": {
    "vibekit": {
      "command": "vibekit-mcp",
      "env": {
        "VIBEKIT_API_KEY": "vk_live_..."
      }
    }
  }
}

Reinicie o Claude Desktop. As novas ferramentas aparecem sob o ícone de conectores.

Configurar o Cursor

Cursor → Configurações → Recursos → Model Context Protocol → Adicionar um novo servidor MCP. Mesmo comando e variáveis de ambiente.

O que você pode fazer

36 ferramentas expostas hoje, agrupadas por superfície:

Hospedagem e Aplicativos

vibekit_list_apps

Lista todos os aplicativos hospedados na sua conta VibeKit, cada um com seu id, subdomínio, status e URL ativa. Comece aqui para obter um appId para as outras ferramentas de aplicativos.

vibekit_get_app

Obtém detalhes completos de um aplicativo hospedado — status, subdomínio/URL, repositório, runtime e configuração de banco de dados/domínio. Use o appId de vibekit_list_apps.

vibekit_create_app

Cria um novo aplicativo hospedado a partir de um modelo inicial e o implanta ao vivo em <subdomain>.vibekit.bot. Chame vibekit_list_templates primeiro para escolher um modelo válido. Para implantar código existente de um repositório GitHub, use vibekit_deploy.

vibekit_list_templates

Lista os modelos iniciais disponíveis para vibekit_create_app (ex.: landing, dashboard, blog, saas, crud-api). Chame isso antes de vibekit_create_app para escolher um modelo válido.

vibekit_deploy

Implanta um repositório GitHub na hospedagem VibeKit, ao vivo em <subdomain>.vibekit.bot (contêiner Fargate atrás de nginx, SSL automático). Use quando o código já estiver em um repositório GitHub; para um modelo inicial, use vibekit_create_app.

vibekit_redeploy

Reimplanta um aplicativo existente para puxar e enviar o código mais recente. Use após enviar alterações para o repositório GitHub do aplicativo.

vibekit_app_logs

Busca logs recentes de contêiner/aplicativo para um aplicativo. Use isso para depurar falhas, erros ou uma implantação que não está servindo.

vibekit_restart_app

Reinicia o contêiner de um aplicativo hospedado. Use quando um aplicativo estiver travado ou para aplicar variáveis de ambiente alteradas.

vibekit_stop_app

Para o contêiner de um aplicativo hospedado. O aplicativo permanece na sua conta e pode ser reativado com vibekit_start_app. Use para colocar um aplicativo offline sem excluí-lo.

vibekit_start_app

Inicia o contêiner de um aplicativo hospedado que foi parado. Use para trazer de volta um aplicativo parado via vibekit_stop_app.

vibekit_app_env

Obtém as variáveis de ambiente configuradas para um aplicativo (nomes e valores). Somente leitura — use vibekit_set_env para alterá-las.

vibekit_set_env

Define ou atualiza variáveis de ambiente para um aplicativo (mescla com as existentes). O aplicativo deve ser reiniciado ou reimplantado para que as alterações tenham efeito.

vibekit_delete_app

Exclui permanentemente um aplicativo hospedado — para o contêiner e remove seu workspace, banco de dados, variáveis de ambiente e subdomínio. Irreversível (o repositório GitHub NÃO é tocado). Confirme com o usuário antes de chamar.

vibekit_list_deploys

Lista as implantações recentes de um aplicativo, das mais novas para as mais antigas, com status e informações de commit. Encontre um deployId aqui para passar para vibekit_rollback_deploy.

vibekit_rollback_deploy

Reverte um aplicativo para uma implantação anterior (obtenha o deployId de vibekit_list_deploys). O contêiner reinicia na versão revertida; reversível revertendo novamente para frente.

Agente de IA

vibekit_chat

Envia uma mensagem para o agente de codificação de IA integrado de um aplicativo, que lê, escreve e modifica o código do aplicativo e o reimplanta. Use para solicitações de 'construir/fazer uma alteração no meu aplicativo'. Se o agente terminar rapidamente, você recebe a resposta diretamente. Caso contrário, você recebe status:'working' — NÃO reenvie; em vez disso, dê ao usuário progresso AO VIVO: consulte vibekit_agent_status a cada poucos segundos e repasse a etapa atual de activity.status ('editando a página inicial…', 'implantando…') até activity.done, então leia vibekit_agent_history para a resposta final.

vibekit_agent_status

Verifica se o agente de IA de um aplicativo está ocioso ou trabalhando e obtém seu progresso AO VIVO. Retorna activity.status = a etapa de construção legível atual (ex.: 'editando index.html', 'implantando'), activity.steps = as etapas até agora e activity.done = se a rodada terminou. Consulte isso a cada poucos segundos enquanto uma construção está em execução e repasse activity.status ao usuário para que ele veja o progresso. Quando activity.done for true, a resposta também inclui liveCheck = uma busca no lado do servidor da página implantada ({ url, ok, httpStatus, title }); use para confirmar que o aplicativo está ativo e renderiza — NÃO faça curl/fetch da URL você mesmo, seu sandbox pode bloqueá-la.

vibekit_agent_history

Obtém o histórico recente de conversas entre o usuário e o agente de IA de um aplicativo.

Banco de Dados

vibekit_enable_database

Provisiona um banco de dados Postgres para um aplicativo (idempotente — seguro se já estiver habilitado). Necessário antes que as ferramentas vibekit_db_* funcionem. Nota: aplicativos do plano gratuito precisam do complemento de Banco de Dados de $3/mês.

vibekit_database_status

Obtém o status do banco de dados de um aplicativo e informações de conexão (se está provisionado, congelado, etc.).

vibekit_db_schema

Obtém o esquema do banco de dados de um aplicativo — cada tabela e suas colunas. Sempre chame isso antes de escrever uma consulta com vibekit_db_query.

vibekit_db_query

Executa uma consulta SQL somente leitura contra o banco de dados Postgres de um aplicativo e retorna até 200 linhas de resultado. Somente SELECT — escritas e DDL (INSERT/UPDATE/DELETE/ALTER/DROP/…) são rejeitadas no lado do servidor; use vibekit_chat ou vibekit_submit_task para que o agente faça alterações de dados ou esquema. Chame vibekit_db_schema primeiro para conhecer as tabelas. String SQL, máx. 5000 caracteres.

vibekit_db_table

Navega pelas linhas de uma tabela com paginação e ordenação opcional — uma alternativa rápida somente leitura a escrever um SELECT manualmente.

QA

vibekit_run_qa

Inicia uma execução de QA automatizada (verificações de navegador headless) contra um aplicativo hospedado. Consulte vibekit_qa_status para resultados.

vibekit_qa_status

Obtém os resultados e o status de QA automatizado mais recentes para um aplicativo.

Tarefas

vibekit_submit_task

Envia uma tarefa de codificação autônoma. A IA escreve o código, faz commit no GitHub e (por padrão) implanta em <subdomain>.vibekit.bot. Retorna um taskId — consulte vibekit_get_task ou bloqueie com vibekit_wait_for_task. Use para trabalho de 'construir X' ou 'alterar X' contra um repositório.

vibekit_get_task

Obtém o status e o resultado de uma tarefa enviada via vibekit_submit_task.

vibekit_list_tasks

Lista tarefas de codificação recentes, opcionalmente filtradas por status.

vibekit_wait_for_task

Bloqueia até que uma tarefa enviada termine (ou o tempo limite), consultando a cada 5 segundos, e então retorna seu resultado. Use logo após vibekit_submit_task quando quiser o resultado final inline.

vibekit_cancel_task

Cancela uma tarefa em execução por taskId. Sem efeito se já tiver terminado.

Agendamentos

vibekit_create_schedule

Cria uma tarefa de codificação recorrente que a IA executa automaticamente em um agendamento cron (ex.: uma passada de SEO semanal). Use para solicitações de 'toda segunda-feira, faça X no meu repositório'.

vibekit_list_schedules

Lista todas as tarefas recorrentes agendadas da conta.

vibekit_delete_schedule

Exclui uma tarefa recorrente agendada por scheduleId. Confirme com o usuário primeiro.

Conta

vibekit_account

Obtém informações da conta VibeKit: plano, saldo de créditos e uso.

Habilidades

vibekit_list_skills

Lista habilidades de implementação disponíveis (IDs, nomes, descrições, tags) do registro de habilidades VibeKit. Descubra habilidades aqui antes de buscar uma com vibekit_get_skill.

vibekit_get_skill

Busca o conteúdo completo de uma habilidade específica — padrões de implementação, exemplos de código e melhores práticas para um domínio. Busque sob demanda quando precisar de orientação sobre um tópico específico.

Por que isso supera o painel

  • Fique no seu editor. Sem alternar de aba. Implante de dentro do mesmo chat em que você está escrevendo o código.
  • Composicional. O Claude pode encadear chamadas, "implante isso, espere subir, depois defina essas 3 variáveis de ambiente, depois reinicie", sem você cuidar de cada etapa.
  • Scriptável a partir de agentes. Se você tem um fluxo de trabalho Claude Code que precisa implantar um aplicativo irmão, o MCP torna isso uma única chamada de ferramenta.

Pacotes relacionados

  • vibekit-agent, execute no seu laptop para ser um trabalhador Claude Code ou Codex controlável remotamente (caminho do Agente Remoto iOS)
  • vibekit-cli, CLI de terminal para iniciar tarefas de agente e agendar trabalhos cron

FAQ

O que o servidor MCP do VibeKit faz?

Ele expõe sua conta VibeKit como ferramentas que qualquer cliente MCP (Claude Desktop, Cursor, Zed, Continue, etc.) pode chamar. Você diz ao Claude Desktop 'implante este repositório e defina OPENAI_API_KEY' e o Claude realmente faz isso via as ferramentas MCP, sem copiar e colar URLs em um painel separado.

Como instalo o vibekit-mcp?

Execute npm install -g vibekit-mcp\ e depois adicione-o à sua configuração MCP do Claude Desktop / Cursor. Para Claude Desktop, edite ~/Library/Application Support/Claude/claude_desktop_config.json e adicione vibekit-mcp sob mcpServers. O servidor usa sua chave de API VibeKit para autenticação, obtenha uma em app.vibekit.bot/settings.

Quais clientes suportam isso?

Qualquer cliente que implemente a especificação Model Context Protocol, atualmente Claude Desktop, Cursor, Zed, Continue e uma lista crescente. O servidor usa transporte stdio, então funciona com o bloco de configuração MCP padrão que qualquer um deles aceita.

O servidor MCP é gratuito?

Sim, o pacote npm é gratuito e de código aberto. O plano gratuito do VibeKit (1 aplicativo hospedado) é suficiente para começar. O servidor MCP é apenas uma camada RPC fina; seu uso é limitado pelo seu plano VibeKit e pelos custos de modelo do seu próprio cliente.