VibeKit MCP
vibekit-mcp
VibeKit용 MCP 서버로, 모든 MCP 클라이언트에서 앱을 배포하고, 호스팅을 관리하며, AI 에이전트와 채팅할 수 있습니다.
이 패키지는 VibeKit 클라우드/API 액세스용입니다. 로컬 Claude Code 인스턴스를 Telegram에 연결하지 않습니다. 로컬 머신 원격 제어는 vibekit-agent를 사용하세요.
원격으로 사용하기 (설치 불필요)
VibeKit은 호스팅형 원격 서버로도 실행되므로, 원격 MCP URL을 지원하는 클라이언트(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설정
VibeKit API 키를 받으세요 (위의 API 키 받기 참조).
MCP 클라이언트 설정(예: Claude Desktop)에 추가하세요 (macOS의 경우
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"vibekit": {
"command": "vibekit-mcp",
"env": {
"VIBEKIT_API_KEY": "vk_your_api_key_here"
}
}
}
}MCP 클라이언트를 다시 시작하세요
사용 가능한 도구
호스팅
도구 | 설명 |
| 호스팅된 모든 앱 나열 |
| 특정 앱에 대한 세부 정보 가져오기 |
|
|
| 템플릿에서 새 앱 생성 |
| GitHub 저장소를 호스팅에 배포 |
| 최신 코드로 앱 재배포 |
| 앱의 최근 배포 내역을 상태 및 커밋과 함께 나열 |
| 앱을 이전 배포로 롤백 |
| 애플리케이션 로그 가져오기 |
| 앱 다시 시작 |
| 앱 중지 |
| 중지된 앱 시작 |
| 앱 환경 변수 가져오기 |
| 앱 환경 변수 설정 |
| 앱 영구 삭제 |
에이전트
도구 | 설명 |
| 앱의 AI 에이전트와 채팅 |
| 에이전트 상태 가져오기 |
| 에이전트와의 채팅 기록 가져오기 |
데이터베이스
도구 | 설명 |
| 앱에 Postgres 데이터베이스 활성화 |
| 데이터베이스 상태 및 연결 정보 가져오기 |
| 데이터베이스 스키마 가져오기 (모든 테이블과 해당 열) |
| 읽기 전용 SQL 쿼리 실행 (SELECT만, 최대 200행) |
| 페이지네이션 및 정렬로 한 테이블의 행 탐색 |
QA
도구 | 설명 |
| 자동화된 QA 테스트 실행 |
| QA 테스트 결과 가져오기 |
작업
도구 | 설명 |
| 코딩 작업 제출 |
| 작업 상태/결과 가져오기 |
| 최근 작업 나열 |
| 작업 완료 대기 |
| 실행 중인 작업 취소 |
| 반복 예약 작업 생성 |
| 예약된 작업 나열 |
| 예약된 작업 삭제 |
계정
도구 | 설명 |
| 계정 정보 가져오기 (요금제, 크레딧, 사용량) |
| 구현 스킬 나열 |
| 특정 스킬 콘텐츠 가져오기 |
사용 예시
설정이 완료되면 다음과 같은 프롬프트를 사용할 수 있습니다:
"내 GitHub 저장소를 VibeKit에 배포하고 새 앱을 만들어줘"
"연락처 양식 추가에 대해 내 앱의 AI 에이전트와 채팅해줘"
"내 앱의 로그를 보여주고 오류가 있으면 다시 시작해줘"
"내 앱에 데이터베이스를 활성화하고 스키마를 보여준 다음 users 테이블을 조회해줘"
"내 앱의 최근 배포 내역을 나열하고 마지막으로 작동한 버전으로 롤백해줘"
"배포된 앱에서 QA 테스트를 실행해줘"
"내 VibeKit 계정 잔액을 확인하고 앱 목록을 보여줘"
"내 앱 성능을 개선하기 위한 주간 일정을 만들어줘"
환경 변수
변수 | 설명 | 기본값 |
| VibeKit API 키 (필수) | 없음 |
| API 기본 URL |
|
관련 패키지
vibekit-cli: VibeKit 클라우드 워크플로우용 터미널 클라이언트vibekit-agent: 자신의 머신에서 로컬 Claude Code를 위한 Telegram 브리지
링크
대시보드 (API 키 보기 또는 재생성)
개인정보 처리방침
VibeKit의 개인정보 처리방침: https://vibekit.bot/privacy
이 MCP 서버가 사용자 데이터로 수행하는 작업은 구체적으로 다음과 같습니다:
모든 도구 호출은 구성한 API 키로 인증되어 HTTPS를 통해 VibeKit API(
https://vibekit.bot/api/v1)로 전달됩니다. 도구 입력 및 출력은 위 개인정보 처리방침에 따라 앱과 에이전트를 실행하기 위해 VibeKit에서 처리됩니다.서버 자체는 상태를 유지하지 않습니다: 디스크에 기록되는 것이 없고, 이 패키지에 의해 수집되는 분석 또는 원격 측정이 없으며, API 키는 구성(
VIBEKIT_API_KEY/ 확장 프로그램의 키 필드)에서 읽어vibekit.bot에만 전송됩니다.데이터 보존, 제3자 공유 및 삭제는 위 정책에 따라 관리됩니다. 문의: 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-