> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用 MCP 工具

将来自 [MCP 服务器](https://modelcontextprotocol.io/docs/getting-started/intro) 的外部工具连接到你的 Dify 应用程序。你可以使用不断增长的 [MCP 生态系统](https://mcpservers.org/) 中的工具，而不仅仅是内置工具。

<Note>
  本内容涵盖在 Dify 中使用 MCP 工具。要将 Dify 应用程序发布为 MCP 服务器，请参阅 [这里](/zh/3.10.x/use/publish/publish-mcp)。
</Note>

<Info>
  目前仅支持使用 [HTTP 传输](https://modelcontextprotocol.io/docs/learn/architecture#transport-layer) 的 MCP 服务器。
</Info>

## 添加 MCP 服务器

在你的工作空间中转到 **工具** → **MCP**。

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-list.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=4acdc2dacd230c4b9b427bb289762064" alt="MCP 服务器列表" width="3048" height="1988" data-path="images/use-dify/workspace/mcp-server-list.png" />
</Frame>

点击 **添加 MCP 服务器 (HTTP)**：

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-add-server-dialog.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=6c860f6050922b6bfb5d7b92b3fbd75f" alt="MCP 添加服务器对话框" width="1120" height="912" data-path="images/use-dify/workspace/mcp-add-server-dialog.png" />
</Frame>

**服务器 URL**：MCP 服务器的位置（如 `https://api.notion.com/mcp`）

**名称和图标**：给它一个有用的名称。Dify 会尝试自动获取图标。

**服务器 ID**：唯一标识符（小写字母、数字、下划线、连字符，最多 24 个字符）

<Warning>
  一旦开始使用服务器 ID，就不要更改它。这将破坏任何使用该服务器工具的应用程序。
</Warning>

## 接下来会发生什么

Dify 会自动：

1. 连接到服务器
2. 处理任何 OAuth 认证
3. 获取可用工具列表
4. 使它们在你的应用程序构建器中可用

一旦找到工具，你将看到服务器卡片：

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-card.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=f87d09ca887687a9a8e1397c215b2daf" alt="MCP 服务器卡片" width="1564" height="550" data-path="images/use-dify/workspace/mcp-server-card.png" />
</Frame>

## 管理服务器

点击任何服务器卡片可以：

**更新工具**：当外部服务添加新工具时刷新

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-server-tools-list.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=8b3ec3a060e5d0891a9ce584fbbcb82f" alt="MCP 服务器工具列表" width="916" height="942" data-path="images/use-dify/workspace/mcp-server-tools-list.png" />
</Frame>

**重新授权**：当令牌过期时修复认证

**编辑设置**：更改服务器详细信息（但不能更改 ID！）

**移除**：断开服务器连接（这会破坏使用其工具的应用程序）

## 使用 MCP 工具

连接后，MCP 工具会出现在你期望的所有地方：

**在 Agent 中**：工具按服务器分组显示（"Notion MCP » Create Page"）

**在工作流中**：MCP 工具作为节点可用

**在 Agent 节点中**：与常规 Agent 相同

## 自定义工具

添加 MCP 工具时，你可以自定义它：

<Frame>
  <img src="https://mintcdn.com/dify-4171f9f9/UBmmoVHERrjglfCJ/images/use-dify/workspace/mcp-tool-settings.png?fit=max&auto=format&n=UBmmoVHERrjglfCJ&q=85&s=7df42055157abdffbd44c385ab622336" alt="MCP 工具设置" width="798" height="1020" data-path="images/use-dify/workspace/mcp-tool-settings.png" />
</Frame>

**描述**：覆盖默认描述以使其更具体

**参数**：对于每个工具参数，选择：

* **自动**：让 AI 决定值
* **固定**：设置一个永不改变的特定值

**示例**：对于搜索工具，将 `numResults` 设置为 5（固定），但保持 `query` 为自动。

## 分享应用程序

当你导出使用 MCP 工具的应用程序时：

* 导出内容包含服务器 ID
* 要在其他地方使用该应用程序，需要添加具有相同 ID 的相同服务器
* 记录你的应用程序需要哪些 MCP 服务器

## 故障排除

**"未配置的服务器"**：检查 URL 并重新授权

**缺少工具**：点击"更新工具"

**应用程序损坏**：你可能更改了服务器 ID。使用原始 ID 重新添加它。

## 提示

* 使用永久的、描述性的服务器 ID，如 `github-prod` 或 `crm-system`
* 在开发/测试/生产环境中保持相同的 MCP 设置
* 为配置项设置固定值，为部署前测试 MCP 集成