什么是自定义 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 服务器包括：- 服务器端点: 响应 MCP 协议请求的 Web 服务
- 工具定义: Manus 可以执行的操作描述
- 身份验证: 安全处理凭证和 API 密钥
- 请求处理程序: 执行操作并返回结果的逻辑
示例：内部 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): 创建所有务
- “获取客户 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 美元的预算请求，并通知财务团队进行审批。“常见问题
我需要成为开发人员才能构建自定义 MCP 服务器吗？
我需要成为开发人员才能构建自定义 MCP 服务器吗？
构建自定义 MCP 服务器需要开发技能。但是，MCP 规范很简单，并且提供了示例实现来帮助您入门。
我可以使用现有 API 而无需构建自定义服务器吗？
我可以使用现有 API 而无需构建自定义服务器吗？
如果服务具有完善的 REST API 文档，您可能无需自定义 MCP 服务器即可使用 Manus 的通用 API 调用功能。但是，自定义服务器提供了更好的集成、更清晰的工具定义和更可靠的工作流。
是否有性能要求？
是否有性能要求？
自定义 MCP 服务器应在几秒钟内响应大多数操作。较长的操作应使用异步模式。Manus 将超时耗时过长的请求。
如何维护自定义 MCP 服务器？
如何维护自定义 MCP 服务器？
像对待任何其他内部服务一样对待自定义 MCP 服务器：版本控制、自动化测试、监控和定期更新。使服务器与内部系统 API 的更改保持同步。