# MCP 集成 (/zh-CN/docs/verdent-for-vscode/advanced-features/mcp)

> 通过 Model Context Protocol 服务器和插件扩展 Verdent



### 你将学到什么 [#你将学到什么]

Verdent for VS Code 中 Model Context Protocol (MCP) 集成的概览，包括设置、配置和可扩展性选项。

<Info>
  完整的 MCP 文档正在编写中。本页提供 MCP 功能的概览，详细指南即将推出。如有具体的集成问题，请联系 [support@verdent.ai](mailto:support@verdent.ai)。
</Info>

***

## 什么是 MCP（Model Context Protocol）？ [#什么是-mcpmodel-context-protocol]

Model Context Protocol (MCP) 是一个集成系统，通过连接到外部工具、数据源和服务来扩展 Verdent 的能力。

**核心概念：**
MCP 让 Verdent 能够与其内置工具集之外的系统进行交互，从而实现与以下系统的无缝集成：

* 外部 API 和 Web 服务
* 数据库系统
* 云平台（AWS、Azure、GCP）
* 项目管理工具
* CI/CD 流水线
* 自定义内部工具

**架构：**
MCP 服务器充当 Verdent 与外部系统之间的桥梁。每个 MCP 服务器都暴露特定能力，Verdent 可以在编码会话期间调用这些能力，类似于 `file_read` 或 `bash` 等内置工具。

**配置存储：**
MCP 服务器配置存储在 `~/.verdent/mcp.json` 中，并通过设置菜单进行管理。

***

## MCP 集成的优势 [#mcp-集成的优势]

### 扩展能力 [#扩展能力]

**访问外部系统：**
将 Verdent 连接到内置功能无法提供的工具和服务。无需离开编码工作流，即可查询数据库、与云服务交互或集成特定于项目的 API。

**自定义工具开发：**
创建专门针对你项目独特需求的 MCP 服务器。为内部工具、专有 API 或特定领域系统构建专门的集成。

### 互操作性 [#互操作性]

**生态系统优势：**
接入不断壮大的 MCP 生态系统。社区开发的 MCP 服务器为热门工具和服务提供了预构建的集成。

**标准化协议：**
MCP 为工具集成提供一致的接口，确保新能力能与 Verdent 现有的工具系统顺畅整合。

### 工作流自动化 [#工作流自动化]

**无缝集成：**
MCP 服务器会成为 Verdent 工具集的一部分。智能体会在适当时自动使用 MCP 工具，你也可以针对特定任务显式调用它们。

**上下文感知操作：**
MCP 集成能够理解你的代码库上下文，从而基于当前开发状态智能地与外部系统交互。

***

## 设置 MCP 服务器 [#设置-mcp-服务器]

### 配置流程 [#配置流程]

**访问 MCP 设置：**

1. 在 Verdent 中打开设置菜单
2. 导航到 **MCP Servers** 部分
3. 查看或修改 `~/.verdent/mcp.json` 配置

**配置文件：**
MCP 服务器通过 `~/.verdent/mcp.json` 文件进行配置，该文件定义了服务器连接、身份验证和集成参数。

<Note>
  详细的 MCP 配置 schema 和设置说明正在最终确定中。如需立即获得 MCP 服务器设置方面的帮助，请查阅 MCP 协议规范或联系 Verdent 支持团队。
</Note>

### 配置管理 [#配置管理]

**添加服务器：**
通过在 `mcp.json` 中添加包含连接详情和身份验证凭据的条目来配置新的 MCP 服务器。

**多个服务器：**
Verdent 支持多个并发的 MCP 服务器，允许同时与多个外部系统集成。

**测试连接：**
在开发工作流中使用 MCP 服务器之前，验证其配置以确保连接成功。

***

## MCP 插件和扩展 [#mcp-插件和扩展]

### 可用插件 [#可用插件]

MCP 插件为常见工具和服务提供预构建的集成。

<Info>
  可用 MCP 插件的精选列表正在整理中。请查看 Verdent 官方文档或 MCP 生态系统资源以了解当前的插件可用情况。
</Info>

**预期插件类别：**

* **数据库集成：** PostgreSQL、MySQL、MongoDB 查询工具
* **云服务：** AWS、Azure、GCP API 交互
* **开发者工具：** GitHub、GitLab、Jira、Linear 集成
* **CI/CD 平台：** Jenkins、GitHub Actions、CircleCI
* **监控服务：** Datadog、New Relic、Sentry
* **通信：** Slack、Discord、Microsoft Teams 通知

### 插件安装 [#插件安装]

**安装方法：**
插件通过 MCP 设置界面进行安装和配置，通常需要：

* 插件标识符或来源
* 配置参数
* 身份验证凭据（如适用）

**依赖管理：**
MCP 插件可能依赖外部服务或库。安装过程会在可能的情况下自动处理依赖解析。

***

## 自定义 MCP 服务器开发 [#自定义-mcp-服务器开发]

### 创建自定义服务器 [#创建自定义服务器]

高级用户可以创建自定义 MCP 服务器，以集成专有工具或特定领域的系统。

**开发方法：**
自定义 MCP 服务器实现 MCP 协议规范，暴露 Verdent 可以调用的工具能力。

**自定义服务器的使用场景：**

* **内部 API 集成：** 连接到公司专属的 API 和服务
* **遗留系统桥接：** 让 Verdent 能够与遗留基础设施交互
* **专门数据源：** 访问专有数据库或数据仓库
* **工作流自动化：** 触发自定义的构建、部署或测试流水线

<Note>
  全面的自定义 MCP 服务器开发指南，包括协议实现要求、SDK 文档和测试工具，正在开发中。如有即时的自定义集成需求，请参阅 MCP 协议规范。
</Note>

### 集成模式 [#集成模式]

**工作区级别配置：**
MCP 服务器可以在工作区级别进行配置以实现特定于项目的集成，使团队能够通过版本控制共享 MCP 配置。

**工具互操作性：**
MCP 提供的工具与 Verdent 的内置工具（`file_read`、`bash`、`spawn_subagent`）无缝集成，从而支持组合多种工具类型的复杂工作流。

***

## MCP 工作流示例 [#mcp-工作流示例]

### 数据库查询集成 [#数据库查询集成]

**场景：** 查询生产数据库以调试数据问题。

**MCP 方法：**

```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]
```

MCP 数据库服务器负责处理身份验证、查询验证和结果格式化。

### 云服务交互 [#云服务交互]

**场景：** 检查 AWS Lambda 函数日志中的错误。

**MCP 方法：**

```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]
```

MCP AWS 服务器负责管理身份验证、API 调用和日志解析。

### CI/CD 流水线监控 [#cicd-流水线监控]

**场景：** 在部署变更前检查构建状态。

**MCP 方法：**

```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment
```

MCP CI/CD 服务器跟踪流水线状态并提供实时反馈。

***

## 安全注意事项 [#安全注意事项]

### 身份验证与授权 [#身份验证与授权]

**凭据管理：**
MCP 服务器负责处理对外部服务的身份验证。凭据安全地存储在 MCP 配置中，绝不会暴露在聊天历史或代码中。

**权限范围限定：**
为 MCP 服务器配置最低限度的必要权限。尽可能使用只读访问，并限制破坏性操作。

### 安全操作 [#安全操作]

**命令审查：**
涉及 MCP 工具的操作可以在 Manual Accept Mode 下于执行前进行审查，提供可见性和控制力。

**审计日志：**
MCP 服务器操作会出现在 Verdent 的聊天历史中，从而为外部系统交互创建审计轨迹。

***

## MCP 集成故障排查 [#mcp-集成故障排查]

### 常见问题 [#常见问题]

**连接失败：**

* 验证到 MCP 服务器的网络连接
* 检查 `mcp.json` 中的身份验证凭据
* 确保 MCP 服务器正在运行且可访问
* 验证配置文件语法

**权限错误：**

* 确认 API 密钥或凭据具有所需权限
* 检查服务配额或速率限制
* 验证防火墙规则允许 MCP 流量

**工具调用问题：**

* 确保 MCP 服务器正确暴露了预期的工具
* 检查工具参数格式是否符合服务器预期
* 查看 MCP 服务器日志以获取错误详情

### 获取帮助 [#获取帮助]

**支持渠道：**

* Verdent 支持：[support@verdent.ai](mailto:support@verdent.ai)
* [MCP 协议文档](https://modelcontextprotocol.io)
* [Verdent Discord 社区](https://discord.com/invite/NGjXEZcbJq)，获取实时支持

**诊断信息：**
报告 MCP 问题时，请提供：

* MCP 服务器类型和版本
* 配置详情（移除凭据后）
* 聊天历史中的错误消息
* MCP 服务器日志（如可访问）

***

## MCP 文档资源 [#mcp-文档资源]

### 官方文档 [#官方文档]

<Info>
  全面的 MCP 集成指南正在编写中，包括：

  * 完整的 MCP 协议规范
  * 服务器开发 SDK 文档
  * 插件市场和注册表
  * 集成示例和教程
  * 自定义服务器开发的 API 参考
</Info>

**即将推出：**

* 分步 MCP 服务器设置指南
* 插件安装和配置演练
* 自定义服务器开发教程
* MCP 集成最佳实践
* MCP 工作流的性能优化

### 临时资源 [#临时资源]

**当前 MCP 信息：**

* MCP 协议规范（外部）
* 社区开发的 MCP 服务器和示例
* MCP 生态系统 GitHub 仓库

**联系获取详情：**
如需立即获得 MCP 集成帮助，请联系 [support@verdent.ai](mailto:support@verdent.ai)，并说明你的具体使用场景和集成需求。

***

## 参见 [#参见]

<CardGroup cols="2">
  <Card title="工具参考" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    内置工具能力
  </Card>

  <Card title="可扩展性" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    其他扩展方法
  </Card>

  <Card title="配置" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    Verdent 设置与偏好
  </Card>

  <Card title="最佳实践" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    高效提示词技巧
  </Card>
</CardGroup>