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

# 了解 MCP 规范

> 与您的内部工具和专有系统构建集成

## 什么是自定义 MCP 服务器？

自定义 MCP 服务器允许您将 Manus 的集成能力扩展到预构建的连接器之外。如果您的组织使用内部工具、专有 API 或标准 MCP 连接器未涵盖的专业服务，您可以构建一个自定义服务器，将 Manus 连接到这些系统。

自定义 MCP 服务器充当 Manus 与您的内部基础设施之间的桥梁，实现与预构建连接器相同的无缝多应用工作流——但它是根据您的特定工具和要求量身定制的。

## 为什么要构建自定义 MCP 服务器？

### 内部系统

许多组织依赖自定义构建的工具、内部数据库或专有软件。自定义 MCP 服务器允许 Manus 与这些系统集成，将内部数据引入您的 AI 工作流。

**示例**：

* 内部 CRM 或客户数据库
* 专有项目管理工具
* 自定义分析平台
* 带有 API 的遗留系统

### 专业服务

一些第三方服务没有预构建的 MCP 连接器。如果您使用专业工具或小众服务，您可以构建一个自定义服务器将其连接到 Manus。

**示例**：

* 行业特定软件
* 标准连接器未涵盖的区域服务
* 没有官方集成的新兴平台

### 自定义业务逻辑

自定义 MCP 服务器可以实现超出简单 API 调用的业务特定逻辑、数据转换或验证规则。这允许您在 Manus 集成中强制执行组织策略和工作流。

**示例**：

* 数据更新前的审批工作流
* 根据内部标准进行数据验证
* 自定义身份验证或安全要求
* 组织特有的多步骤流程

## 自定义 MCP 服务器的工作原理

自定义 MCP 服务器是一种轻量级服务，实现了模型上下文协议规范。它公开了 Manus 可以调用的端点，用于读取数据、执行操作或在您的系统中执行自定义逻辑。

### 架构

**您的内部系统** ↔**自定义 MCP 服务器** ↔**Manus**

MCP 服务器位于 Manus 和您的内部系统之间，将 Manus 请求转换为您工具中的操作，并以 Manus 理解的格式返回结果。

### 协议

自定义 MCP 服务器实现了一个标准化的协议，它定义了：

* **工具**：Manus 可以执行的操作（例如，“get\_customer\_data”，“update\_project\_status”）
* **资源**：Manus 可以读取的数据（例如，文档、记录、文件）
* **提示词**：常见操作的预定义模板

## 构建自定义 MCP 服务器

### 先决条件

* **API 访问** 到您想要集成的系统
* **开发环境** (Node.js、Python 或任何可以运行 Web 服务器的语言)
* **Understanding of the MCP specification** (可在 Manus 文档中获取)

### 基本实现

一个最小的自定义 MCP 服务器包括：

1. **服务器端点**: 响应 MCP 协议请求的 Web 服务
2. **工具定义**: Manus 可以执行的操作描述
3. **身份验证**: 安全处理凭证和 API 密钥
4. **请求处理程序**: 执行操作并返回结果的逻辑

### 示例：内部 CRM 集成

这是一个用于内部 CRM 的自定义 MCP 服务器的概念示例：

**公开的工具**:

* `get_customer_info(customer_id)`: 检索客户详情
* `update_customer_notes(customer_id, notes)`: 向客户记录添加备注
* `search_customers(query)`: 搜索客户数据库
* `create_follow_up_task(customer_id, task_description, due_date)`: 创建所有务

**身份验证**: 用于内部 CRM 的 API 密钥或 OAuth 令牌

**部署**: 托管在您的基础设施或安全的云环境中

部署后，您将此自定义服务器连接到 Manus，它将与预构建的连接器一起出现。然后您可以使用自然语言提示，例如：

* "获取客户 ID 12345 的客户信息"
* "搜索旧金山地区的客户"
* "使用我们最近的对话更新客户 67890 的备注"

## 连接自定义 MCP 服务器

### 步骤 1：部署您的服务器

将您的自定义 MCP 服务器托管在您控制的基础设施上。确保它可以通过 HTTPS 访问，并采取了适当的安全措施。

### 步骤 2：添加到 Manus

在 Manus 中，导航到**设置 → 集成 → 自定义 MCP 服务器** 并点击**添加服务器**。

### 步骤 3：提供服务器详情

输入以下信息：

* **服务器名称**: 描述性名称（例如，“内部 CRM”、“分析平台”）
* **服务器 URL**: 托管您的 MCP 服务器的 HTTPS 端点
* **身份验证**: 需要 API 密钥、Bearer 令牌或其他凭证

### 第 4 步：测试连接

Manus 将验证它是否可以与您的服务器通信并检索可用工具列表。

### 第 5 步：开始使用

连接后，您的自定义工具将出现在 Manus 的可用集成中。您可以像引用预构建的连接器一样在提示词中引用它们。

## 安全注意事项

### 身份验证

自定义 MCP 服务器应实施强大的身份验证：

* 使用 API 密钥、OAuth 令牌或其他安全方法
* 切勿在 URL 或日志中暴露凭证
* 定期轮换凭证

### 授权

实施适当的授权检查：

* 验证请求用户是否具有访问数据的权限
* 如果适用，强制执行基于角色的访问控制 (RBAC)
* 记录所有访问尝试以供审计

### 数据传输

* 所有通信均使用 HTTPS
* 加密静态和传输中的敏感数据
* 实施速率限制以防止滥用

### 网络安全

* 在您的安全网络边界内部署 MCP 服务器
* 使用防火墙和访问控制来限制谁可以访问服务器
* 对于高度敏感的集成，考虑使用 VPN 或专用网络连接

## 最佳实践

### 工具设计

**保持工具专注**：每个工具应执行一个明确的动作。不要使用单个“manage\_customer”工具，而是为“get\_customer”、“update\_customer”、“delete\_customer”创建单独的工具。

**提供清晰的描述**：Manus 使用工具描述来理解何时使用每个工具。编写清晰、具体的描述，解释工具的作用以及何时适用。

**优雅地处理错误**：返回有意义的错误消息，帮助 Manus（和用户）了解出了什么问题以及如何修复。

### 性能

**优化响应时间**：Manus 等待 MCP 服务器响应。通过缓存数据、使用高效查询和避免不必要的处理来保持操作快速。

**实施超时**：为 API 调用设置合理的超时时间，以防止如果您的内部系统缓慢或无响应时 Manus 无限期等待。

**对耗时的任务使用异步操作**：如果操作耗时超过几秒钟，请考虑立即返回任务 ID，并提供一个单独的工具来检查状态。

### 监控

**记录所有请求**：跟踪 Manus 正在请求什么以及您的服务器如何响应。这有助于调试和理解使用模式。

**监控性能**：跟踪响应时间、错误率和使用量，以便在问题影响用户之前识别它们。

**设置警报**：如果您的 MCP 服务器无响应或开始返回错误，您将收到通知。

## 示例用例

### 内部知识库

**场景**: 您的组织拥有一个内部维基或知识库，其中包含公司政策、程序和文档。

**自定义 MCP Server**: 提供工具来搜索知识库、检索特定文章并查找相关文档。

**Manus Workflow**: "搜索我们的内部知识库，查找费用报销政策并总结要点。"

***

### 自定义分析平台

**场景**: 您拥有一个专有的分析平台，用于跟踪标准工具中不可用的业务指标。

**自定义 MCP Server**: 公开工具来查询指标、生成报告并检索历史数据。

**Manus Workflow**: "提取我们第四季度的客户获取成本数据，并创建与第三季度进行比较的趋势分析。"

***

### 遗留系统集成

**场景**: 您的组织依赖于没有现代 API 或集成的遗留系统。

**自定义 MCP Server**: 充当遗留系统的包装器，将现代 API 调用转换为遗留系统可以理解的格式。

**Manus Workflow**: "检查遗留系统中产品 SKU 98765 的库存水平，如果库存低于 100 件，则创建重新订购请求。"

***

### 多步骤审批工作流

**场景**: 您的组织需要针对某些操作（例如，预算请求、数据访问）的审批工作流。

**自定义 MCP Server**: 实现创建审批请求、检查审批状态和执行已批准操作的工具。

**Manus Workflow**: "为营销活动创建一份 50,000 美元的预算请求，并通知财务团队进行审批。"

## 常见问题

<AccordionGroup>
  <Accordion title="我需要成为开发人员才能构建自定义 MCP 服务器吗？" icon="sparkles">
    构建自定义 MCP 服务器需要开发技能。但是，MCP 规范很简单，并且提供了示例实现来帮助您入门。
  </Accordion>

  <Accordion title="我可以使用现有 API 而无需构建自定义服务器吗？" icon="sparkles">
    如果服务具有完善的 REST API 文档，您可能无需自定义 MCP 服务器即可使用 Manus 的通用 API 调用功能。但是，自定义服务器提供了更好的集成、更清晰的工具定义和更可靠的工作流。
  </Accordion>

  <Accordion title="是否有性能要求？">
    自定义 MCP 服务器应在几秒钟内响应大多数操作。较长的操作应使用异步模式。Manus 将超时耗时过长的请求。
  </Accordion>

  <Accordion title="如何维护自定义 MCP 服务器？">
    像对待任何其他内部服务一样对待自定义 MCP 服务器：版本控制、自动化测试、监控和定期更新。使服务器与内部系统 API 的更改保持同步。
  </Accordion>
</AccordionGroup>