跳转到主内容

添加自有 MCP-server

通过自有 MCP-server，您可以将 AI-Public 连接到案件系统、档案、数据源或其他专用服务。请先选择最适合使用场景的传输方式。

选择正确的传输方式​

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

Streamable HTTP 的要求​

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

https://mcp.organisatie.nl/mcp

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

添加服务器​

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

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

身份验证和 secrets​

AI-Public 支持 connector-OAuth 和静态 secrets。OAuth token、refresh token、API 密钥和密码都保存在仅服务器可访问的存储中。聊天只会收到已注册的 connectorId，绝不会收到密钥配置。

当 URL 或身份验证发生更改时，新配置会先重新检查。如果检查失败，之前已批准的配置仍可保持启用，直到问题解决为止。

工具权限和信息安全​

只授予用户实际需要的工具。MCP-server 可能提供读写操作。AI-Public 会根据服务器端 allowlist 过滤发现的工具，并在每次使用时检查环境、所有者和角色。组织仍需负责在源系统中设置适当的 scope、日志记录、保留期限和授权。

本地桌面服务器​

本地 stdio-server 需安装在桌面应用中。系统会限制并在批准前显示 command、参数、环境键和所请求的访问权限。secrets 会在本地加密。

故障排查​

  • 端点不可达：检查 HTTPS、DNS、防火墙以及完整的 /mcp 路径。
  • 需要重新连接：刷新 OAuth 授权或已保存的 secret。
  • 属于其他环境：请在当前环境中重新注册 connector。
  • 未显示任何工具：检查 allowlist、角色权限和启用状态。
  • 仅在桌面端可用：服务器可能使用的是 stdio 或本地地址。

开发资源​

另见​

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

本页