---
title: MCP（模型上下文协议）
---

import { Image } from '@/components/ui/image'
import { Callout } from 'fumadocs-ui/components/callout'

模型上下文协议（[MCP](https://modelcontextprotocol.com/)）允许您使用标准化协议连接外部工具和服务，从而将 API 和服务直接集成到您的工作流程中。通过 MCP，您可以通过添加自定义集成来扩展 Sim 的功能，使其与您的代理和工作流程无缝协作。

## 什么是 MCP？

MCP 是一项开放标准，使 AI 助手能够安全地连接到外部数据源和工具。它提供了一种标准化的方法来：

- 连接数据库、API 和文件系统
- 访问外部服务的实时数据
- 执行自定义工具和脚本
- 维护对外部资源的安全、受控访问

## 配置 MCP 服务器

MCP 服务器提供工具集合，供您的代理使用。您可以在工作区设置中进行配置：

<div className="flex justify-center">
  <Image
    src="/static/blocks/mcp-1.png"
    alt="在设置中配置 MCP 服务器"
    width={700}
    height={450}
    className="my-6"
  />
</div>

1. 进入您的工作区设置
2. 转到 **MCP 服务器** 部分
3. 点击 **添加 MCP 服务器**
4. 输入服务器配置详情
5. 保存配置

<Callout type="info">
您还可以直接从代理模块的工具栏中配置 MCP 服务器，以便快速设置。
</Callout>

## 在代理中使用 MCP 工具

一旦配置了 MCP 服务器，其工具将在您的代理模块中可用：

<div className="flex justify-center">
  <Image
    src="/static/blocks/mcp-2.png"
    alt="在代理模块中使用 MCP 工具"
    width={700}
    height={450}
    className="my-6"
  />
</div>

1. 打开一个 **代理** 模块
2. 在 **工具** 部分，您将看到可用的 MCP 工具
3. 选择您希望代理使用的工具
4. 代理现在可以在执行过程中访问这些工具

## 独立的 MCP 工具模块

为了更精细的控制，您可以使用专用的 MCP 工具模块来执行特定的 MCP 工具：

<div className="flex justify-center">
  <Image
    src="/static/blocks/mcp-3.png"
    alt="独立的 MCP 工具模块"
    width={700}
    height={450}
    className="my-6"
  />
</div>

MCP 工具模块允许您：
- 直接执行任何已配置的 MCP 工具
- 向工具传递特定参数
- 在后续工作流步骤中使用工具的输出
- 将多个 MCP 工具串联在一起

### 何时使用 MCP 工具与代理

**在以下情况下使用带有 MCP 工具的代理：**
- 您希望 AI 决定使用哪些工具
- 您需要复杂的推理来决定何时以及如何使用工具
- 您希望与工具进行自然语言交互

**在以下情况下使用 MCP 工具块：**
- 您需要确定性的工具执行
- 您希望使用已知参数执行特定工具
- 您正在构建具有可预测步骤的结构化工作流

## 权限要求

MCP 功能需要特定的工作区权限：

| 操作 | 所需权限 |
|--------|-------------------|
| 在设置中配置 MCP 服务器 | **管理员** |
| 在代理中使用 MCP 工具 | **写入** 或 **管理员** |
| 查看可用的 MCP 工具 | **读取**、**写入** 或 **管理员** |
| 执行 MCP 工具块 | **写入** 或 **管理员** |

## 常见使用场景

### 数据库集成
连接到数据库以在工作流中查询、插入或更新数据。

### API 集成
访问没有内置 Sim 集成的外部 API 和 Web 服务。

### 文件系统访问
读取、写入和操作本地或远程文件系统上的文件。

### 自定义业务逻辑
执行特定于您组织需求的自定义脚本或工具。

### 实时数据访问
在工作流执行期间从外部系统获取实时数据。

## 安全注意事项

- MCP 服务器以配置它的用户权限运行
- 安装前始终验证 MCP 服务器来源
- 对于敏感的配置数据，请使用环境变量
- 在授予代理访问权限之前，审查 MCP 服务器功能

## 故障排除

### MCP 服务器未显示
- 验证服务器配置是否正确
- 检查您是否具有所需权限
- 确保 MCP 服务器正在运行且可访问

### 工具执行失败
- 验证工具参数格式是否正确
- 检查 MCP 服务器日志中的错误消息
- 确保已配置所需的身份验证

### 权限错误
- 确认您的工作区权限级别
- 检查 MCP 服务器是否需要额外的身份验证
- 验证服务器是否已为您的工作区正确配置