第24章 MCP 集成
MCP 集成 在 v0 中直接连接并使用 MCP 服务器
简介 MCP 代表 Model Context Protocol(模型上下文协议)。它允许 v0 连接提供工具和能力的外部服务器,从而增强交互体验。
v0 通过两种方式使用 MCP:
自带 MCP 服务器:你可以通过配置或选择预设来自建 MCP 服务器。这允许你托管自己的 MCP 服务器,或使用第三方提供的服务器。 来自 Marketplace 集成 的 MCP:v0 支持通过 Vercel Marketplace 安装的集成进行工具调用。这允许你将数据库、API 和其他平台等服务直接连接到 v0 聊天,无需额外设置。
自带 MCP 服务器 打开提示词输入框中的 + 菜单,并选择 MCPs 以使用你自己的 MCP 服务器。
在 MCP 菜单中,你可以配置自定义 MCP 服务器或选择预设。部分预设包括:
Contentful:用于管理结构化内容 Context7:用于搜索文档和知识库 Datadog:用于查询日志、指标、跟踪和监控器 Glean:用于查询公司内部数据 Granola:用于 AI 会议纪要和转录 Hex:用于数据分析和可视化 Linear:用于项目管理和问题跟踪 Mobbin:用于设计灵感和 UI/UX 参考 Nitrosend:用于电子邮件和短信营销自动化 Notion:用于访问和管理 Notion 数据库和页面 PostHog:用于产品分析和功能标志 Sanity:用于内容管理和检索 Sentry:用于错误跟踪和监控 Zapier:用于连接数千个应用程序并自动化工作流程
配置 MCP 服务器 如果不使用预设,你可以手动配置 MCP 服务器。v0 支持四种认证方式:
无认证:适用于不需要认证公开的 MCP 服务器 自定义 Headers:适用于需要 API 密钥或其他自定义网络头进行访问的 MCP 服务器 Bearer Token:适用于使用 Bearer Token 认证的 MCP 服务器 OAuth:适用于支持 OAuth 2.0 认证的 MCP 服务器
在生成过程中使用 MCP 目前,MCP 服务器仅提供 v0 在生成过程中使用的工具。当你开始新聊天或继续现有聊天时,v0 在生成响应时会自动考虑已连接的 MCP 服务器及其工具。
v0 创建的生成内容无法直接使用 MCP 工具。不过,你可以将 MCP 与其他功能(如 v0 的环境变量)配合使用,以便在生成过程中利用这些工具。
来自 Marketplace 集成 的 MCP v0 支持来自 Vercel Marketplace 集成的工具调用,允许你将 Vercel Marketplace 中的服务直接连接到 v0 聊天。这些集成为 v0 提供了专门的工具和能力,使其能与数据库、API 和其他外部平台进行交互。
通过原生集成,v0 可以:
查询和管理你的数据库(例如 Neon、Supabase、Upstash) 询问关于你的产品和营收的问题(Stripe) 与云服务和 API 交互 访问项目特定的资源和数据 在集成的服务中执行操作 为连接的工具提供情境感知辅助
入门指南 重要提示:为集成启用远程 MCP 可能会增加每条消息的成本,并赋予 v0 访问读取或更改外部数据的工具的权限。在使其工具可用之前,请审查集成功能并配置全局 Agent 权限。
连接集成
打开集成
打开 Project 菜单 → Settings → Integrations 浏览 Vercel Marketplace 中可用的集成
安装集成
从 Marketplace 中选择一个集成 跟随认证和设置流程 授予 v0 访问服务所需的权限
配置集成设置
连接后,点击集成以管理其设置 配置 MCP 工具的可用性(参见下文“可用性与批准”) 如适用,设置资源特定的访问权限
可用性与批准 MCP 工具可用性和工具调用批准是独立的控制项:
集成的 Remote MCP 设置决定其工具是否对 v0 可用。 聊天的全局 Ask、Auto 或 Full 权限模式以及 Agent 权限规则决定可用的工具调用是执行、请求确认还是被阻止。
禁用集成具有优先权,因为其 MCP 工具不会添加到 agent 中。任何全局权限模式都无法调用不可用的工具。
集成可用性 原生集成显示三种 Remote MCP 设置: 设置当前行为 Disabled集成保持安装状态,但其 MCP 服务器处于非活动状态,其工具不对 v0 可用。 Ask for Approval (Manual)MCP 服务器处于活动状态,其工具可用。这是新集成的默认设置。 Always Run (Auto)MCP 服务器处于活动状态,其工具可用。 Manual 和 Auto 是启用状态。在当前运行时,这些标签不会覆盖聊天的全局权限模式或其 Agent 权限规则。 对于自定义 MCP 服务器,其启用或禁用状态起相同的可用性作用。
全局工具批准 MCP 工具可用后,全局模式适用: 全局模式MCP 工具行为 Ask匹配允许规则(allow rule)的调用会执行,匹配拒绝规则(deny rule)的调用会被阻止,标记为 ask 或未匹配规则的调用需要确认。 Autoallow、ask 和 deny 规则仍然适用。未匹配的调用通常自动执行;运行时可能会要求对工具名称执行确认,如果其风险检查将其分类为潜在破坏性。 Full跳过工具批准评估,因此 MCP 调用会在不检查用户或团队的 allow、ask 和 deny 规则的情况下运行。 MCP 调用后没有单独的 5 秒取消窗口。潜在破坏性操作也不保证需要批准:allow 规则或 Full 模式可能会让其在没有确认的情况下运行。 参见 Terminal commands: Permission modes 了解 agent 工具使用的全局模式和规则优先级。
管理集成 配置对话框 要管理集成设置:
打开 Project 菜单 → Settings → Integrations 点击一个已连接的集成 Manage Integration 对话框显示: 集成详情:名称、描述和类别 实例信息:连接的资源名称和 ID 文档链接:直接链接到 Marketplace 列表 Remote MCP 切换开关:配置工具可用性 Configure 按钮:访问集成特定设置
更改可用性 要更改集成的 Remote MCP 设置:
打开 Manage Integration 对话框 找到 Remote MCP 部分(标有 “New” 徽章) 选择你首选的模式: 点击 🚫 图标用于 Disabled 点击 ✋ 图标用于 Ask for Approval 点击 ✓ 图标用于 Always Run 更改立即生效
断开连接集成 要移除集成:
打开 Manage Integration 对话框 点击 Configure 访问集成设置 在 Vercel 上跟随该集成的断开连接流程 该集成将从项目的 Integrations 设置中移除
集成作用域 许多 Marketplace MCP 在全球范围内运行,但 v0 将它们限定在特定的项目和资源中:
项目特定:集成关联到你的 v0 项目 资源特定:数据库集成针对特定的数据库实例 情境感知:v0 自动提供资源上下文,以确保命令指向正确的服务 当 v0 使用集成时,它包含诸如以下上下文: 资源 ID(例如,特定的数据库实例) 集成实例名称 项目关联 这确保了所有操作都正确地限定作用域,并防止意外的跨项目操作。
示例 数据库集成 连接 Neon 数据库集成后: 用户:“给我看看我的 users 表的架构” v0:[使用 neon_query 工具检查架构] “你的 users 表有这些列: - id (uuid, 主键) - email (varchar) - created_at (timestamp) - updated_at (timestamp)”
相关资源
Vercel Marketplace - 浏览可用集成 v0 MCP Server - 在 IDE 中将 v0 用作 MCP 服务器 Previous: GitHub Next: Pre-installed Agents