跳转到主内容

添加自己的 MCP-server

通过自有 MCP-server，你可以将 AI-School 连接到自己的应用、数据源或专业服务。先根据使用场景选择合适的传输方式。

选择正确的传输方式​

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

Streamable HTTP 的要求​

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

https://mcp.example.nl/mcp

端点必须：

  • 使用 HTTPS；
  • URL 中不能包含用户名或密码；
  • 不需要重定向；
  • 可通过公共 DNS 访问；
  • 正确响应 MCP initialize 握手；
  • 拥有明确的允许工具集合。

本地地址、私有网络地址和云元数据端点会被拦截。因此，你不能从 Web 应用中注册位于 localhost 的服务器。

添加服务器​

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

管理员也可以通过 管理 → AI 设置 → Tools → MCP 为整个环境注册服务器。

认证与密钥​

AI-School 支持连接器 OAuth 和静态密钥。OAuth 令牌、刷新令牌、API 密钥和密码都存储在仅服务器可见的存储中。聊天仅接收已注册的 connectorId，不会接触任何密钥配置。

当 URL 或认证发生更改时，会先重新检查新配置。如果检查失败，先前已批准的配置可以继续保持启用，直到问题解决。

工具权限​

只授予用户真正需要的工具。MCP-server 可能提供读写操作，例如删除文件、发送电子邮件或修改记录。AI-School 会将发现的工具与服务器端白名单进行过滤，但服务器管理员仍需负责合适的权限范围和授权。

本地测试​

本地 stdio-server 需要在桌面应用中测试。渲染器不能启动任意 shell 命令：安装必须通过已批准的预设或安全的桌面流程完成。在安装前会显示命令、参数、环境键以及所请求的访问权限。

故障排除​

  • 端点不可达：检查 HTTPS、DNS、防火墙以及完整的 /mcp 路径。
  • 需要重新连接：重新授权 OAuth 或更新已保存的密钥。
  • 属于其他环境：在当前环境中重新注册连接器。
  • 没有显示工具：检查工具白名单、你的 MCP 访问权限，以及服务器是否处于启用状态。
  • 仅在桌面端可用：服务器可能使用了 stdio 或本地地址。

开发资源​

另见​

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

本页