---
title: MCP 集成
description: 通过 Model Context Protocol 服务器和插件扩展 Verdent
---



### 你将学到什么

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

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

---

## 什么是 MCP（Model 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 集成的优势

### 扩展能力

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

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

### 互操作性

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

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

### 工作流自动化

**无缝集成：**
MCP 服务器会成为 Verdent 工具集的一部分。智能体会在适当时自动使用 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 插件为常见工具和服务提供预构建的集成。

<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 协议规范，暴露 Verdent 可以调用的工具能力。

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

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

### 集成模式

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

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

---

## 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 流水线监控

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

**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.json` 中的身份验证凭据
- 确保 MCP 服务器正在运行且可访问
- 验证配置文件语法

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

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

### 获取帮助

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

**诊断信息：**
报告 MCP 问题时，请提供：
- MCP 服务器类型和版本
- 配置详情（移除凭据后）
- 聊天历史中的错误消息
- MCP 服务器日志（如可访问）

---

## MCP 文档资源

### 官方文档

<Info>
全面的 MCP 集成指南正在编写中，包括：
- 完整的 MCP 协议规范
- 服务器开发 SDK 文档
- 插件市场和注册表
- 集成示例和教程
- 自定义服务器开发的 API 参考
</Info>

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

### 临时资源

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

**联系获取详情：**
如需立即获得 MCP 集成帮助，请联系 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>