VibeKit MCP 服务器（vibekit-mcp）是 VibeKit 提供的 MCP（Model Context Protocol）服务端，用于在任意 MCP 客户端中部署应用、管理托管，并与 AI 智能体对话。该包面向 VibeKit 云/API 访问，不连接本地 Claude Code 实例到 Telegram；如需本地机器的远程控制，应使用 vibekit-agent。
用途 通过 MCP 客户端（如 Claude Desktop、Cursor 等）操作 VibeKit 云平台，完成应用的构建、部署、托管管理与 AI 智能体对话。每个托管应用拥有一个实时 URL 和其自有的持久化服务端智能体，可与该智能体聊天。
主要能力 配置完成后，可使用如下提示词触发操作：
- 将 GitHub 仓库部署到 VibeKit 并创建新应用
- 与应用的 AI 智能体对话，讨论添加联系表单
- 查看应用日志，并在出现错误时重启
- 为应用启用数据库，查看其 schema 并查询 users 表
- 列出应用最近的部署记录，并回滚到上一个可用版本
- 对已部署的应用运行 QA 测试
- 查看 VibeKit 账户余额并列出应用
- 创建每周计划以改进应用性能
使用方式
- 远程使用（无需安装）：VibeKit 也作为托管远程服务器运行，支持远程 MCP URL 的客户端（如 claude.ai 网页连接器、ChatGPT 等）无需安装。将该 URL 粘贴到客户端的“自定义连接器”/“远程 MCP 服务器”字段即可。支持设置请求头的客户端，也可以发送 Authorization: Bearer vk_your_api_key_here 并使用裸地址 https://mcp.vibekit.bot/mcp。
- 本地 stdio 安装（例如 Claude Desktop）：
- 获取 VibeKit API 密钥（见下）。
- 添加到 MCP 客户端配置（例如 Claude Desktop，macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）。
- 重启 MCP 客户端。
获取 API 密钥 密钥以 vk_ 开头，有两种获取方式：
- 即时、无需注册：一次请求即可返回密钥。curl -X POST https://vibekit.bot/api/v1/auth/register，响应示例：{"apiKey": "vk_...", "plan": "free", "credits": 0}。保存返回的密钥并复用。每次调用 /auth/register 都会创建一个全新账户，因此只调用一次，不要每个请求都调用。
- 从账户获取：如果已在使用 VibeKit，可在网页仪表盘或 iOS 应用设置中复制或重新生成密钥。
环境变量 资料中列出了“Environment Variables”小节，但未提供具体变量名与取值说明，暂未提供。
相关包
- vibekit-cli：VibeKit 云工作流的终端客户端
- vibekit-agent：用于本机本地 Claude Code 的 Telegram 桥接
数据与隐私 每次工具调用都会通过 HTTPS 转发到 VibeKit API（https://vibekit.bot/api/v1），并使用所配置的 API 密钥进行认证。工具输入与输出由 VibeKit 处理，以运行应用和智能体，并受其隐私政策约束。服务器本身不保留状态：不写入磁盘，本包不收集分析或遥测数据；API 密钥从配置（VIBEKIT_API_KEY / 扩展的 key 字段）读取，仅发送至 vibekit.bot。数据保留、第三方共享与删除由上述政策管辖。如有问题可联系 support@vibekit.bot。
适用场景 适合需要在 MCP 客户端内直接管理 VibeKit 托管应用、部署与回滚、查看日志、启用数据库、运行 QA 测试、与每个应用的服务端 AI 智能体对话，以及查看账户余额和创建定时任务的用户。
限制 该包仅用于 VibeKit 云/API 访问，不用于将本地 Claude Code 实例连接到 Telegram；本地机器远程控制请使用 vibekit-agent。资料未提供具体收费、价格、平台支持范围、效果或详细使用步骤，暂未提供。
