MCP2Skill 文档MCP 服务
远程服务与 OAuth 授权
了解远程 MCP 服务接入方式、授权状态和常见问题
远程服务与 OAuth 授权
当你添加的是远程 MCP 服务时，除了连接本身，还要考虑授权问题。当前版本里，远程接入主要集中在 SSE 和 Streamable HTTP 两类服务上。
截图占位：远程 MCP 服务详情页，展示 OAuth 状态徽章、授权按钮和网关端点区域。
视频占位：添加一个需要 OAuth 的远程服务，从点击授权到回到 MCP2Skill 查看已授权状态的全过程。
哪些服务属于远程服务
通常只要你填写的是远程 URL，而不是本地命令，就属于远程服务。
常见情况包括：
- 你接的是云端 MCP 服务
- 服务本身运行在其他机器或服务器上
- 需要附带请求头
- 需要浏览器登录或 OAuth 授权
添加远程服务时要准备什么
最常见需要确认的信息有：
- 正确的服务 URL
- 是否需要额外请求头
- 是否需要 OAuth 授权
- 当前网络环境能否访问目标地址
如果其中任何一项不确定，先不要急着创建多个服务，建议先拿一个目标服务做验证。
OAuth 相关状态怎么理解
在需要授权的服务中，你可能会看到以下状态：
| 状态 | 说明 |
|---|---|
| 需要授权 | 服务可识别，但当前没有可用授权 |
| 授权中 | 系统浏览器已经打开，等待完成授权 |
| 已授权 | 授权信息已经就绪，服务可尝试重新连接 |
| 已过期 | 旧授权已不可用，需要重新处理 |
如果服务不需要 OAuth，一般不会显示这些额外状态。
标准授权流程
典型流程通常如下：
- 在 MCP2Skill 中添加远程服务
- 保存后看到该服务需要授权
- 点击授权按钮
- 系统浏览器打开授权页面
- 在浏览器中完成登录或授权确认
- 回到 MCP2Skill 查看状态是否变为已授权
- 再次确认工具列表是否已经正常加载
完成授权后，最好立刻进入服务详情页检查工具列表，而不是只看状态徽章。
什么时候需要重新授权
以下场景通常需要重新处理授权：
- 远程服务显示已过期
- 服务原本可用，后来突然开始报鉴权错误
- 你主动撤销了本地授权
- 远程服务侧修改了授权策略
如果只是网络抖动导致的临时失败，不一定要马上重新授权，可以先刷新状态再判断。
撤销授权会发生什么
撤销授权后：
- 本地保存的授权信息会被清除
- 服务会回到待授权或不可用状态
- 工具列表通常不会继续保持可调用
撤销适合用于切换账号、清理旧授权或排查异常状态。
远程服务连不上时怎么判断原因
可以按这个顺序判断：
- URL 是否填写正确
- 当前网络是否可达
- 自定义请求头是否缺失或错误
- 服务是否要求 OAuth 授权
- 授权是否已过期
- 远程服务本身是否在运行
如果你已经授权完成，但工具列表仍然为空，优先怀疑 URL、请求头或远端服务状态。
常见建议
- 先用一个远程服务打通流程，再批量添加
- 每次完成授权后都检查工具列表
- 如果同一服务多次失败，先停用再重新编辑配置
- 不要把调试中的敏感请求头随意复制到其他环境
相关章节
- 想了解服务基础管理：看 MCP 服务管理
- 想把远程服务暴露给外部 AI 应用：看 连接外部 AI 客户端
- 想排查连接错误：看 常见问题与故障排查