VibeKit MCP
vibekit-mcp
MCP-сервер для VibeKit: развертывайте приложения, управляйте хостингом и общайтесь с ИИ-агентами из любого MCP-клиента.
Этот пакет предназначен для облачного/API-доступа VibeKit. Он не подключает ваш локальный экземпляр Claude Code к Telegram. Для удаленного управления локальной машиной используйте vibekit-agent.
Использование удаленно (без установки)
VibeKit также работает как размещенный удаленный сервер, поэтому клиентам, которые принимают удаленный URL MCP (веб-коннекторы claude.ai, ChatGPT и т. д.), не требуется установка:
https://mcp.vibekit.bot/mcp?api_key=vk_your_api_key_hereВставьте этот URL в поле «пользовательский коннектор» / «удаленный MCP-сервер» вашего клиента. Клиенты, которые позволяют задавать заголовки, могут вместо этого отправлять Authorization: Bearer vk_your_api_key_here и использовать голый https://mcp.vibekit.bot/mcp. См. Получить API-ключ ниже.
Предпочитаете локальную установку stdio (например, Claude Desktop)? Используйте шаги ниже.
Related MCP server: vibekit-mcp
Получение API-ключа
Ключи начинаются с vk_. Два способа получить его:
Мгновенно, без регистрации: один запрос возвращает ключ.
curl -X POST https://vibekit.bot/api/v1/auth/register
# Response: {"apiKey": "vk_...", "plan": "free", "credits": 0}Сохраните возвращенный ключ и используйте его повторно. Каждый вызов /auth/register создает совершенно новую учетную запись, поэтому вызывайте его один раз, а не для каждого запроса.
Из вашей учетной записи: если вы уже пользуетесь VibeKit, скопируйте или перегенерируйте свой ключ в веб-панели или в настройках приложения iOS.
Установка
npm install -g vibekit-mcpНастройка
Получите API-ключ VibeKit (см. Получить API-ключ выше).
Добавьте в конфигурацию вашего MCP-клиента (например, Claude Desktop) (
~/Library/Application Support/Claude/claude_desktop_config.jsonна macOS):
{
"mcpServers": {
"vibekit": {
"command": "vibekit-mcp",
"env": {
"VIBEKIT_API_KEY": "vk_your_api_key_here"
}
}
}
}Перезапустите ваш MCP-клиент
Доступные инструменты
Хостинг
Tool | Description |
| Список всех размещенных приложений |
| Получить сведения о конкретном приложении |
| Список стартовых шаблонов для |
| Создать новое приложение из шаблона |
| Развернуть репозиторий GitHub на хостинге |
| Повторно развернуть приложение с последним кодом |
| Список последних развертываний приложения со статусом и коммитом |
| Откатить приложение к предыдущему развертыванию |
| Получить журналы приложения |
| Перезапустить приложение |
| Остановить приложение |
| Запустить остановленное приложение |
| Получить переменные окружения приложения |
| Установить переменные окружения приложения |
| Удалить приложение навсегда |
Агент
Tool | Description |
| Общение с ИИ-агентом приложения |
| Получить статус агента |
| Получить историю чата с агентом |
База данных
Tool | Description |
| Включить базу данных Postgres для приложения |
| Получить статус базы данных и информацию о подключении |
| Получить схему базы данных (каждую таблицу и ее столбцы) |
| Выполнить SQL-запрос только для чтения (только SELECT, до 200 строк) |
| Просмотр строк одной таблицы с постраничной навигацией и сортировкой |
Контроль качества
Tool | Description |
| Запустить автоматические QA-тесты |
| Получить результаты QA-тестов |
Задачи
Tool | Description |
| Отправить задачу на кодирование |
| Получить статус/результат задачи |
| Список недавних задач |
| Ожидать завершения задачи |
| Отменить выполняющуюся задачу |
| Создать повторяющуюся запланированную задачу |
| Список запланированных задач |
| Удалить запланированную задачу |
Аккаунт
Tool | Description |
| Получить информацию об аккаунте (план, кредиты, использование) |
| Список навыков реализации |
| Получить содержимое конкретного навыка |
Примеры использования
После настройки вы можете использовать такие запросы, как:
"Разверните мой репозиторий GitHub на VibeKit и создайте новое приложение"
"Пообщайтесь с ИИ-агентом моего приложения о добавлении контактной формы"
"Покажите журналы моего приложения и перезапустите его, если есть ошибки"
"Включите базу данных для моего приложения, затем покажите ее схему и выполните запрос к таблице пользователей"
"Перечислите недавние развертывания моего приложения и откатитесь к последнему рабочему"
"Запустите QA-тесты на моем развернутом приложении"
"Проверьте баланс моего аккаунта VibeKit и перечислите мои приложения"
"Создайте еженедельное расписание для улучшения производительности моего приложения"
Переменные окружения
Variable | Description | Default |
| Ваш API-ключ VibeKit (обязательно) | нет |
| Базовый URL API |
|
Связанные пакеты
vibekit-cli: терминальный клиент для облачных рабочих процессов VibeKitvibekit-agent: мост Telegram для локального Claude Code на вашей собственной машине
Ссылки
Панель управления (просмотр или перегенерация вашего API-ключа)
Политика конфиденциальности
Политика конфиденциальности VibeKit: https://vibekit.bot/privacy
Что этот MCP-сервер делает с вашими данными, конкретно:
Каждый вызов инструмента пересылается в API VibeKit (
https://vibekit.bot/api/v1) по HTTPS с аутентификацией с помощью настроенного вами API-ключа. Входные и выходные данные инструментов обрабатываются VibeKit для запуска ваших приложений и агентов в соответствии с указанной выше политикой конфиденциальности.Сам сервер не хранит состояние: ничего не записывается на диск, этот пакет не собирает аналитику или телеметрию, а ваш API-ключ считывается из конфигурации (
VIBEKIT_API_KEY/ поле ключа расширения) и отправляется только наvibekit.bot.Хранение данных, передача третьим лицам и удаление регулируются указанной выше политикой. Вопросы: support@vibekit.bot.
Available Tools
2 toolsvibekit_database_statusVibeKit Database StatusARead-onlyIdempotentInspect
Get an app's database status and connection info (whether it's provisioned, frozen, etc.).
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | App ID (from vibekit_list_apps) |
Output Schema
| Name | Required | Description |
|---|---|---|
| ok | Yes | Whether the call succeeded. |
| data | No | Database stats: tables, storage, and connection info. |
| error | No | Error message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint and idempotentHint. The description adds minimal behavioral context (e.g., 'whether it's provisioned, frozen, etc.') but does not reveal additional traits. No contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence with no wasted words. Every element is purposeful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given an output schema exists, the description need not explain return values. It covers the essential purpose and mentions example states. Could be slightly more specific but is adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a description for 'appId'. The tool description adds no extra meaning beyond the schema, so baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Get an app's database status and connection info', which uses the verb 'Get' and specifies the resource. It distinguishes from siblings like 'vibekit_db_query' and 'vibekit_enable_database' by focusing solely on status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. The description only states what it does, leaving the agent to infer context from sibling tool names.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
vibekit_get_taskVibeKit Get TaskARead-onlyInspect
Get the status and result of a task submitted via vibekit_submit_task.
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | Task ID returned from vibekit_submit_task |
Output Schema
| Name | Required | Description |
|---|---|---|
| ok | Yes | Whether the call succeeded. |
| data | No | Task details: status, logs/result summary, and repo info. |
| error | No | Error message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error). |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already set readOnlyHint=true, indicating no side effects. The description adds no further behavioral details (e.g., re-fetch behavior, error states). With annotations covering safety, the description meets the baseline but does not exceed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence that directly conveys the purpose without fluff. Every word is necessary; no redundancy or extraneous information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description doesn't need to detail return values. The one-parameter tool is fully covered by the description and schema, leaving no gaps for an agent to misinterpret.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with description for taskId. The description adds value by specifying that the ID comes from vibekit_submit_task, linking the tools together and clarifying the parameter's origin.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Get' and the resource 'status and result of a task', and distinguishes it from sibling tools like vibekit_submit_task (creates) and vibekit_cancel_task (cancels). It references the specific submission tool, making purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use after vibekit_submit_task. It does not explicitly mention when not to use or alternatives like vibekit_wait_for_task for polling, but the context is clear enough for an agent to infer appropriate usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
31 tool updates
v0.7.5- Removed
vibekit_account - Removed
vibekit_agent_history - Removed
vibekit_agent_status - Removed
vibekit_app_env - Removed
vibekit_app_logs - Removed
vibekit_cancel_task - Removed
vibekit_chat - Removed
vibekit_create_app - Removed
vibekit_create_schedule - Changed
vibekit_database_status2 fields changed- changed
Input schema / properties / appId / descriptionPrevious value: -"The app ID to get database status for"New value: +"App ID (from vibekit_list_apps)" - changed
Output schema / (root)Previous value: -nullNew value: +{ + "description": "Result envelope: ok=true with data on success, ok=false with error on failure.", + "properties": { + "data": { + "description": "Database stats: tables, storage, and connection info." + }, + "error": { + "description": "Error message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error).", + "type": "string" + }, + "ok": { + "description": "Whether the call succeeded.", + "type": "boolean" + } + }, + "required": [ + "ok" + ], + "type": "object" +}
- Removed
vibekit_delete_app - Removed
vibekit_delete_schedule - Removed
vibekit_deploy - Removed
vibekit_enable_database - Removed
vibekit_get_app - Removed
vibekit_get_skill - Changed
vibekit_get_task2 fields changed- changed
Input schema / properties / taskId / descriptionPrevious value: -"The task ID returned from vibekit_submit_task"New value: +"Task ID returned from vibekit_submit_task" - changed
Output schema / (root)Previous value: -nullNew value: +{ + "description": "Result envelope: ok=true with data on success, ok=false with error on failure.", + "properties": { + "data": { + "description": "Task details: status, logs/result summary, and repo info." + }, + "error": { + "description": "Error message when ok is false (e.g. missing/invalid VIBEKIT_API_KEY, or an API error).", + "type": "string" + }, + "ok": { + "description": "Whether the call succeeded.", + "type": "boolean" + } + }, + "required": [ + "ok" + ], + "type": "object" +}
- Removed
vibekit_list_apps - Removed
vibekit_list_schedules - Removed
vibekit_list_skills - Removed
vibekit_list_tasks - Removed
vibekit_list_templates - Removed
vibekit_qa_status - Removed
vibekit_redeploy - Removed
vibekit_restart_app - Removed
vibekit_run_qa - Removed
vibekit_set_env - Removed
vibekit_start_app - Removed
vibekit_stop_app - Removed
vibekit_submit_task - Removed
vibekit_wait_for_task
31 tool updates
v0.6.1- First observed
vibekit_account - First observed
vibekit_agent_history - First observed
vibekit_agent_status - First observed
vibekit_app_env - First observed
vibekit_app_logs - First observed
vibekit_cancel_task - First observed
vibekit_chat - First observed
vibekit_create_app - First observed
vibekit_create_schedule - First observed
vibekit_database_status - First observed
vibekit_delete_app - First observed
vibekit_delete_schedule - First observed
vibekit_deploy - First observed
vibekit_enable_database - First observed
vibekit_get_app - First observed
vibekit_get_skill - First observed
vibekit_get_task - First observed
vibekit_list_apps - First observed
vibekit_list_schedules - First observed
vibekit_list_skills - First observed
vibekit_list_tasks - First observed
vibekit_list_templates - First observed
vibekit_qa_status - First observed
vibekit_redeploy - First observed
vibekit_restart_app - First observed
vibekit_run_qa - First observed
vibekit_set_env - First observed
vibekit_start_app - First observed
vibekit_stop_app - First observed
vibekit_submit_task - First observed
vibekit_wait_for_task
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one checks database status, the other retrieves task results. No ambiguity.
Both tools use the consistent 'vibekit_' prefix followed by verb_noun pattern (database_status, get_task), showing good naming uniformity.
Only 2 tools for a server named 'VibeKit MCP' is too few, especially since a referenced tool (vibekit_submit_task) is missing, making the set feel incomplete.
The tool set is missing a critical tool (vibekit_submit_task) that is referenced in vibekit_get_task, and there are obvious gaps in domain coverage beyond database status and task retrieval.
Maintenance
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
Related MCP Servers
- AlicenseAqualityAmaintenanceDeploy static websites, landing pages, and prototypes instantly. Free, no account needed.4151,585 npm6MIT
- AlicenseBqualityDmaintenanceEnables the management of AI-powered VibeKit apps, allowing users to control deployments, monitor logs, and perform database operations directly from MCP-compatible clients. It facilitates interaction with hosted AI agents and the execution of headless coding tasks through natural language.4910 npmMIT
- AlicenseAqualityAmaintenanceAn MCP server for managing Modal — apps, containers, volumes, and secrets — and for deploying & running Modal apps directly from Claude Code and other MCP clients.1283 PyPI4MIT
- FlicenseNot gradedqualityDmaintenancePublish your Claude Code setup, browse a public feed, and pull setups in. Remote MCP server + web feed in one FastAPI app.1-