VULK

VULK MCP 连接器

VULK 根据书面需求构建应用和网站。登录并批准连接后，此连接器可让 AI 助手使用你自己的 VULK 账户。

• 服务 URL： https://app.vulk.dev/mcp（别名 https://mcp.vulk.dev/mcp）
• 传输方式： 远程、Streamable HTTP
• 身份验证： OAuth 2.0 授权码与 PKCE（S256）、动态客户端注册；无需 API 密钥
• 文档： https://support.vulk.dev/docs/api/mcp
• 隐私政策： https://vulk.dev/privacy-policy

助手可以做什么

• 列出你的项目，读取项目详情；付费方案还可读取项目源文件。
• 查看你的方案和续订日期、信用额度余额，以及过去 30 天的使用情况。
• 创建新项目，或向现有项目发送下一条指令。VULK 会像在自己的编辑器中一样进行构建，并使用你的方案已包含的信用额度。之后，助手可以读取进度、VULK 提出的问题，以及可在编辑器中打开结果的链接。
• 停止仍在运行的请求。

助手不能做什么

它无法发布网站、购买信用额度、更改方案或删除项目：这些操作都没有对应的工具。如果你的方案没有剩余信用额度，VULK 会拒绝请求。没有独立的图像、视频或音频生成工具；媒体只会在构建项目时作为设计素材生成。

连接

• Claude（claude.ai）： Customize › Connectors › Add custom connector，名称填写 VULK，URL 填写 https://app.vulk.dev/mcp。

• Claude Code：

  claude mcp add --transport http vulk https://app.vulk.dev/mcp
  

• Codex CLI：

  codex mcp add vulk --url https://app.vulk.dev/mcp
  codex mcp login vulk
  

• Cursor： 添加到 mcp.json：

  { "mcpServers": { "vulk": { "url": "https://app.vulk.dev/mcp" } } }
  

• 任何其他支持 OAuth 远程服务的 MCP 客户端： 添加上方的 URL。

首次连接时，系统会将你转到 app.vulk.dev，让你登录并查看连接的功能，然后再由你批准。

工具

工具	权限范围	功能
list_projects	projects.read	你的项目
get_project	projects.read	单个项目的详情和链接
get_project_files	projects.read	文件索引，或每次调用读取一个源文件（付费方案）
get_usage	usage.read	方案、续订日期、信用额度余额、30 天使用情况
open_billing	无	返回你自己的账单页面链接；不会进行任何更改
create_project	projects.write	根据你的需求开始构建新项目
continue_project	projects.write	向现有项目发送下一条指令或回答
get_operation	projects.read	读取你已启动的构建的持久化状态
stop_operation	projects.write	请求 VULK 停止仍在运行的构建

读取和构建需要单独授权：未获 projects.write 授权的连接不会显示需要该权限的工具；即使调用这些工具，也会返回指出缺少权限的工具错误。

权限、数据与撤销

• 连接最长可持续 90 天（每次使用时都会轮换刷新令牌）；你随时可以在 app.vulk.dev 的 Settings › Integrations › Connected apps 中移除连接。
• 连接器只会在已登录的账户内读取和写入数据：项目、方案、信用额度和使用情况。你要求助手构建的文本会作为项目需求发送给 VULK（最多 8,000 个字符）。
• 每个构建请求都带有一个 request_id；使用相同 ID 重复请求时，会返回同一份回执，而不会重复构建。

旧版本地软件包

npm 软件包 vulk-mcp-server（1.1.0 及更早版本）和 @vulk/mcp-server（1.0.0）是独立的本地命令行软件包（在你自己的计算机上运行），发布于此连接器之前。它们使用 API 密钥（VULK_API_KEY）而非 OAuth 进行身份验证，并提供不同的工具。本连接器不会使用这些软件包，本文也不介绍它们的工具名称和行为。

许可证

MIT。请参阅 LICENSE。