跳转到主内容

添加自己的 MCP 服务器

通过自定义 MCP 服务器，您可以将 AI-Corporate 连接到内部应用程序、数据源或专用服务。请先根据使用场景选择合适的传输方式。

选择合适的传输方式​

传输方式Web移动端桌面端用途
Streamable HTTP是是是推荐用于托管服务器
stdio否否是本地进程和桌面集成
SSE仅限现有配置仅限现有配置是过时的传输方式；新服务器请选择 Streamable HTTP

Streamable HTTP 的要求​

请使用完整的公网端点，包括 MCP 路径，例如：

https://mcp.example.com/mcp

该端点必须使用 HTTPS，不可通过重定向访问，必须可通过公共 DNS 解析，并且能够正确响应 MCP initialize 握手。用户名和密码不应包含在 URL 中。将屏蔽本地地址、私有网络地址和云元数据端点。

添加服务器​

  1. 打开 偏好设置 → 工具。
  2. 选择 添加工具 或 添加 MCP 服务器。只有在您拥有 MCP 访问权限时才会看到此按钮。
  3. 查看可用的适用于组织的预设。
  4. 选择 自行添加 MCP 服务器。
  5. 填写名称、完整端点和身份验证方式。
  6. 保存配置并等待连接检查。
  7. 为您的默认工具集启用该服务器。

管理员可以通过 管理 → 工具 → MCP 为整个环境注册服务器。

身份验证和密钥​

AI-Corporate 支持连接器 OAuth 和静态密钥。OAuth 令牌、刷新令牌、API 密钥和密码都保存在仅服务器可访问的存储中。聊天只会收到已注册的 connectorId，绝不会收到秘密配置。

如果 URL 或身份验证发生变更，系统会先重新验证新配置。如果验证失败，之前已批准的配置可能会继续生效，直到问题解决。

工具权限和治理​

只授予员工真正需要的工具。MCP 服务器可以提供读取和写入操作。AI-Corporate 会根据服务器端允许列表过滤发现的工具，并在每次使用时检查租户、所有者和角色。组织仍需负责在源系统中设置适当的权限范围、日志记录、保留期限和授权。

本地桌面服务器​

本地 stdio 服务器安装在桌面应用中。渲染器不能启动任意 shell 命令：command、参数、environmentkeys 和请求的访问权限都会受到限制，并在批准前展示。密钥会在本地加密保存。

故障排除​

  • 端点无法访问：检查 HTTPS、DNS、防火墙以及完整的 /mcp 路径。
  • 需要重新连接：更新 OAuth 授权或已保存的密钥。
  • 属于其他环境：在当前环境中重新注册连接器。
  • 未显示任何工具：检查允许列表、角色访问权限和启用状态。
  • 仅在桌面端可用：服务器可能使用了 stdio 或本地地址。

开发资源​

另请参阅​

编辑时会获取已注册的服务器配置。已保存的密钥会保持隐藏：将密钥字段留空即可保留它。若 URL 或身份验证方式不同，则需要重新连接。单个 MCP 工具出错，并不意味着该服务器的所有工具都无法访问。

本页