VibeKit.bot
Servidor MCP para desplegar, alojar y operar aplicaciones web y agentes de codificación de IA en VibeKit (listar aplicaciones, leer registros, gestionar variables de entorno, consultar Postgres, ejecutar QA y enviar tareas de codificación que se comprometen en GitHub y se despliegan).
Documentación
Servidor MCP de VibeKit
Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude Desktop, Cursor, Zed, Continue, o cualquier cliente MCP, operar tu cuenta de VibeKit directamente. Despliega repositorios de GitHub, configura variables de entorno, revisa registros, chatea con agentes alojados. Dile a Claude "despliega esto y configura la clave API"; Claude lo hace.
Conector remoto, sin instalación
Para clientes que aceptan una URL MCP remota (conectores web de claude.ai, ChatGPT y otros), no hay nada que instalar, solo pega esta URL:
https://mcp.vibekit.bot/mcp?api_key=vk_your_api_key_here
Los clientes que permiten configurar encabezados pueden usar la URL simple https://mcp.vibekit.bot/mcp con Authorization: Bearer vk_your_api_key_here. Obtén una clave de @the_vibe_kit_bot en Telegram con /apikey.
¿Ya agregaste un servidor vibekit, o estás rotando tu clave? Prefiere la forma de encabezado. Debido a que la URL ?api_key= incorpora la clave en el endpoint, cambiar las claves significa reemplazar toda la entrada del servidor, y algunos clientes conservan la anterior hasta que la sobrescribes explícitamente, por lo que podrías terminar autenticándote con una clave obsoleta sin notarlo. Con la URL simple + encabezado Authorization: Bearer (o la variable de entorno VIBEKIT_API_KEY para local/stdio), el endpoint nunca cambia, así que rotar una clave es solo intercambiar el valor del encabezado. Si tu cliente agregó la forma de URL, elimina la entrada existente de vibekit antes de volver a agregarla en lugar de añadir una segunda.
Instalación (local / stdio)
¿Prefieres ejecutarlo localmente (por ejemplo, Claude Desktop, Cursor)?
npm install -g vibekit-mcp
Obtén una clave API de VibeKit de @the_vibe_kit_bot en Telegram con /apikey.
Configurar Claude Desktop
Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en Windows / Linux:
{
"mcpServers": {
"vibekit": {
"command": "vibekit-mcp",
"env": {
"VIBEKIT_API_KEY": "vk_live_..."
}
}
}
}
Reinicia Claude Desktop. Las nuevas herramientas aparecen bajo el ícono de conectores.
Configurar Cursor
Cursor → Configuración → Funciones → Protocolo de Contexto de Modelo → Agregar un nuevo servidor MCP. El mismo comando y variables de entorno.
Lo que puedes hacer
36 herramientas expuestas hoy, agrupadas por superficie:
Alojamiento y Aplicaciones
vibekit_list_apps
Lista todas las aplicaciones alojadas en tu cuenta de VibeKit, cada una con su id, subdominio, estado y URL en vivo. Comienza aquí para obtener un appId para las otras herramientas de aplicaciones.
vibekit_get_app
Obtén detalles completos de una aplicación alojada: estado, subdominio/URL, repositorio, tiempo de ejecución y configuración de base de datos/dominio. Usa el appId de vibekit_list_apps.
vibekit_create_app
Crea una nueva aplicación alojada desde una plantilla inicial y despliégalo en vivo en <subdomain>.vibekit.bot. Llama a vibekit_list_templates primero para elegir una plantilla válida. Para desplegar código existente desde un repositorio de GitHub, usa vibekit_deploy.
vibekit_list_templates
Lista las plantillas iniciales disponibles para vibekit_create_app (por ejemplo, landing, dashboard, blog, saas, crud-api). Llama a esto antes de vibekit_create_app para elegir una plantilla válida.
vibekit_deploy
Despliega un repositorio de GitHub en el alojamiento de VibeKit, en vivo en <subdomain>.vibekit.bot (contenedor Fargate detrás de nginx, SSL automático). Úsalo cuando el código ya vive en un repositorio de GitHub; para una plantilla inicial usa vibekit_create_app.
vibekit_redeploy
Vuelve a desplegar una aplicación existente para extraer y enviar el código más reciente. Úsalo después de enviar cambios al repositorio de GitHub de la aplicación.
vibekit_app_logs
Obtén registros recientes de contenedor/aplicación para una aplicación. Úsalo para depurar fallos, errores o un despliegue que no está sirviendo.
vibekit_restart_app
Reinicia el contenedor de una aplicación alojada. Úsalo cuando una aplicación está bloqueada, o para aplicar variables de entorno cambiadas.
vibekit_stop_app
Detiene el contenedor de una aplicación alojada. La aplicación permanece en tu cuenta y puede reactivarse con vibekit_start_app. Úsalo para poner una aplicación fuera de línea sin eliminarla.
vibekit_start_app
Inicia el contenedor de una aplicación alojada detenida. Úsalo para volver a poner en línea una aplicación detenida mediante vibekit_stop_app.
vibekit_app_env
Obtén las variables de entorno configuradas para una aplicación (nombres y valores). Solo lectura: usa vibekit_set_env para cambiarlas.
vibekit_set_env
Configura o actualiza variables de entorno para una aplicación (se fusiona con las existentes). La aplicación debe reiniciarse o volver a desplegarse para que los cambios surtan efecto.
vibekit_delete_app
Elimina permanentemente una aplicación alojada: detiene el contenedor y elimina su espacio de trabajo, base de datos, variables de entorno y subdominio. Irreversible (el repositorio de GitHub NO se toca). Confirma con el usuario antes de llamar.
vibekit_list_deploys
Lista los despliegues recientes de una aplicación, del más nuevo al más antiguo, con estado e información de confirmación. Encuentra un deployId aquí para pasarlo a vibekit_rollback_deploy.
vibekit_rollback_deploy
Revierte una aplicación a un despliegue anterior (obtén el deployId de vibekit_list_deploys). El contenedor se reinicia en la compilación revertida; reversible al avanzar nuevamente.
Agente de IA
vibekit_chat
Envía un mensaje al agente de codificación de IA integrado de una aplicación, que lee, escribe y modifica el código de la aplicación y lo vuelve a desplegar. Úsalo para solicitudes de "construye/haz un cambio en mi aplicación". Si el agente termina rápidamente, obtienes su respuesta directamente. De lo contrario, obtienes estado:'working' — NO reenvíes; en su lugar, da al usuario progreso EN VIVO: consulta vibekit_agent_status cada pocos segundos y transmite el paso actual de activity.status ('editando la página de inicio…', 'desplegando…') hasta que activity.done sea verdadero, luego lee vibekit_agent_history para la respuesta final.
vibekit_agent_status
Verifica si el agente de IA de una aplicación está inactivo o trabajando, y obtén su progreso EN VIVO. Devuelve activity.status = el paso de compilación legible actual (por ejemplo, 'editando index.html', 'desplegando'), activity.steps = los pasos hasta ahora, y activity.done = si el turno terminó. Consulta esto cada pocos segundos mientras una compilación está en ejecución y transmite activity.status al usuario para que vea el progreso. Una vez que activity.done es verdadero, la respuesta también incluye liveCheck = una recuperación del lado del servidor de la página desplegada ({ url, ok, httpStatus, title }); úsalo para confirmar que la aplicación está en vivo y se renderiza — NO hagas curl/fetch de la URL tú mismo, tu sandbox puede bloquearlo.
vibekit_agent_history
Obtén el historial reciente de chat entre el usuario y el agente de IA de una aplicación.
Base de datos
vibekit_enable_database
Aprovisiona una base de datos Postgres para una aplicación (idempotente: seguro si ya está habilitada). Requerido antes de que funcionen las herramientas vibekit_db_*. Nota: las aplicaciones de nivel gratuito necesitan el complemento de Base de datos de $3/mes.
vibekit_database_status
Obtén el estado de la base de datos de una aplicación e información de conexión (si está aprovisionada, congelada, etc.).
vibekit_db_schema
Obtén el esquema de la base de datos de una aplicación: cada tabla y sus columnas. Siempre llama a esto antes de escribir una consulta con vibekit_db_query.
vibekit_db_query
Ejecuta una consulta SQL de solo lectura contra la base de datos Postgres de una aplicación y devuelve hasta 200 filas de resultados. Solo SELECT: las escrituras y DDL (INSERT/UPDATE/DELETE/ALTER/DROP/…) se rechazan en el servidor; usa vibekit_chat o vibekit_submit_task para que el agente haga cambios de datos o esquema. Llama a vibekit_db_schema primero para conocer las tablas. Cadena SQL, máximo 5000 caracteres.
vibekit_db_table
Explora filas de una tabla con paginación y ordenamiento opcional: una alternativa rápida de solo lectura a escribir un SELECT manualmente.
QA
vibekit_run_qa
Inicia una ejecución de QA automatizada (verificaciones de navegador sin cabeza) contra una aplicación alojada. Consulta vibekit_qa_status para obtener resultados.
vibekit_qa_status
Obtén los últimos resultados de QA automatizados y el estado de una aplicación.
Tareas
vibekit_submit_task
Envía una tarea de codificación autónoma. La IA escribe el código, hace commit a GitHub y (por defecto) despliega en <subdomain>.vibekit.bot. Devuelve un taskId: consulta vibekit_get_task o bloquea con vibekit_wait_for_task. Úsalo para trabajo de "construye X" o "cambia X" contra un repositorio.
vibekit_get_task
Obtén el estado y resultado de una tarea enviada mediante vibekit_submit_task.
vibekit_list_tasks
Lista tareas de codificación recientes, opcionalmente filtradas por estado.
vibekit_wait_for_task
Bloquea hasta que una tarea enviada termine (o el tiempo de espera), consultando cada 5 segundos, y luego devuelve su resultado. Úsalo justo después de vibekit_submit_task cuando quieras el resultado final en línea.
vibekit_cancel_task
Cancela una tarea en ejecución por taskId. No hace nada si ya terminó.
Programaciones
vibekit_create_schedule
Crea una tarea de codificación recurrente que la IA ejecuta automáticamente en un horario cron (por ejemplo, una pasada SEO semanal). Úsalo para solicitudes de "todos los lunes, haz X a mi repositorio".
vibekit_list_schedules
Lista todas las tareas recurrentes programadas de la cuenta.
vibekit_delete_schedule
Elimina una tarea recurrente programada por scheduleId. Confirma con el usuario primero.
Cuenta
vibekit_account
Obtén información de la cuenta de VibeKit: plan, saldo de crédito y uso.
Habilidades
vibekit_list_skills
Lista las habilidades de implementación disponibles (IDs, nombres, descripciones, etiquetas) del registro de habilidades de VibeKit. Descubre habilidades aquí antes de obtener una con vibekit_get_skill.
vibekit_get_skill
Obtén el contenido completo de una habilidad específica: patrones de implementación, ejemplos de código y mejores prácticas para un dominio. Obténlo bajo demanda cuando necesites orientación sobre un tema específico.
Por qué esto supera al panel de control
- Quédate en tu editor. Sin cambiar de pestaña. Despliega desde el mismo chat donde escribes el código.
- Composicional. Claude puede encadenar llamadas, "despliega esto, espera a que se active, luego configura estas 3 variables de entorno, luego reinicia", sin que tú supervisas cada paso.
- Scriptable desde agentes. Si tienes un flujo de trabajo de Claude Code que necesita desplegar una aplicación hermana, MCP lo convierte en una sola llamada de herramienta.
Paquetes relacionados
- vibekit-agent, ejecútalo en tu laptop para ser un trabajador Claude Code o Codex controlable remotamente (ruta de Agente Remoto iOS)
- vibekit-cli, CLI de terminal para iniciar tareas de agente y programar trabajos cron
Preguntas frecuentes
¿Qué hace el servidor MCP de VibeKit?
Expone tu cuenta de VibeKit como herramientas que cualquier cliente MCP (Claude Desktop, Cursor, Zed, Continue, etc.) puede llamar. Le dices a Claude Desktop 'despliega este repositorio y configura OPENAI_API_KEY' y Claude realmente lo hace a través de las herramientas MCP, sin copiar y pegar URLs en un panel separado.
¿Cómo instalo vibekit-mcp?
Ejecuta npm install -g vibekit-mcp\ y luego agrégalo a tu configuración MCP de Claude Desktop / Cursor. Para Claude Desktop, edita ~/Library/Application Support/Claude/claude_desktop_config.json y agrega vibekit-mcp bajo mcpServers. El servidor usa tu clave API de VibeKit para autenticación; obtén una de app.vibekit.bot/settings.
¿Qué clientes son compatibles?
Cualquier cliente que implemente la especificación del Protocolo de Contexto de Modelo, actualmente Claude Desktop, Cursor, Zed, Continue y una lista creciente. El servidor usa transporte stdio, por lo que funciona con el bloque de configuración MCP estándar que cualquiera de ellos acepta.
¿El servidor MCP es gratuito?
Sí, el paquete npm es gratuito y de código abierto. El nivel gratuito de VibeKit (1 aplicación alojada) es suficiente para comenzar. El servidor MCP es solo una capa RPC delgada; tu uso está limitado por tu plan de VibeKit y los costos de modelo de tu propio cliente.