添加自有 MCP 服务器
通过自有 MCP 服务器，您可以将 AI-Public 连接到案件系统、档案、数据源或其他专业服务。首先选择适合使用场景的传输方式。
选择合适的传输方式
| 传输方式 | Web | 移动端 | 桌面端 | 用途 |
|---|---|---|---|---|
| Streamable HTTP | 是 | 是 | 是 | 推荐用于托管服务器 |
| stdio | 否 | 否 | 是 | 本地进程和桌面集成 |
| SSE | 仅限现有配置 | 仅限现有配置 | 是 | 过时的传输方式；新服务器请选择 Streamable HTTP |
Streamable HTTP 的要求
请使用完整的公共端点，包括 MCP 路径，例如：
https://mcp.organisatie.nl/mcp
端点必须使用 HTTPS，通过公共 DNS 可访问且无重定向，并能响应有效的 MCP initialize 握手。用户名和密码不得包含在 URL 中。本地地址、私有网络地址和云元数据端点将被阻止。
添加服务器
- 打开 偏好设置 → 工具。
- 选择 添加工具 或 添加 MCP 服务器。
- 查看可用预设。
- 选择 自行添加 MCP 服务器。
- 填写名称、完整端点和认证方式。
- 保存配置并等待连接检查。
- 启用服务器以用于您的默认工具集。
管理员可通过 管理 → 工具 → MCP 为整个环境注册服务器。
认证与密钥
AI-Public 支持连接器 OAuth 和静态密钥。OAuth 令牌、刷新令牌、API 密钥和密码存储于仅服务器可访问的存储中。聊天仅接收注册的 connectorId，绝不接收秘密配置。
当 URL 或认证信息更改时，系统会先重新验证新配置。若验证失败，之前通过的配置可继续生效，直到问题解决。
工具权限与信息安全
仅开放用户真正需要的工具。MCP 服务器可提供读写操作。AI-Public 会根据服务器端允许列表过滤发现的工具，并在每次使用时检查环境、所有者和角色。组织需负责适当的权限范围、日志记录、保留期限及源系统的授权。
本地桌面服务器
本地 stdio 服务器安装在桌面应用中。命令、参数、环境变量和请求的访问权限均有限制，并在批准前显示。密钥本地加密存储。
故障排除
- 端点无法访问：检查 HTTPS、DNS、防火墙及完整的
/mcp路径。 - 需要重新连接：刷新 OAuth 授权或存储的密钥。
- 属于其他环境：在当前环境中重新注册连接器。
- 无工具显示：检查允许列表、角色权限和激活状态。
- 仅桌面端可用：服务器可能使用 stdio 或本地地址。
