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