技能

安装 Showly Skill

将官方 Showly Skill 添加到 Claude Code、Codex 或其他 MCP 客户端。

Showly Skill 在 MCP 工具之上增加意图触发提示和发布安全规则。本页说明 如何在 Claude Code、Codex 以及其他支持 MCP 的智能体中安装。

授权如何运作

你不需要粘贴令牌。Showly MCP 是位于 https://mcp.showly.ai 的远程 HTTP 服务器，使用标准 MCP 授权握手（OAuth 2.1 + PKCE）。 智能体首次调用 Showly 工具时：

  1. 智能体连接服务器，收到 401，并自动发现 Showly 的授权服务。
  2. 它打开 showly.ai 浏览器页面，供你登录并批准请求的作用域。
  3. Showly 直接向智能体签发短时、带作用域的令牌，无需查看或复制。

因此安装程序只负责在智能体中注册服务器 URL；首次使用时再通过浏览器 完成登录。

先决条件

  • 一个 Showly 工作区和至少一个已连接站点。
  • 有权批准智能体访问。授权账号至少需要拥有 site:write；如果账号权限

更低，签发的令牌会自动缩减为该账号实际拥有的作用域。

Claude Code

官方安装程序位于 @showly/mcp-server 软件包（可执行文件 showly-mcp）中。Claude Code 使用 claude-code 目标：

npx @showly/mcp-server install --to claude-code

该命令会把 Showly MCP 服务器配置写入 Claude Code，不写令牌，也 无需单独执行登录命令。下次调用 Showly 工具时，智能体会启动上述 浏览器授权流程。

从内部Claude Code测试连接：

Showly，列出我的网站。

第一次调用会打开一个浏览器选项卡以批准访问；批准后，您应该会看到列出的网站，来源自mcp__showly__list_sites。

Codex

使用与 codex 目标相同的安装程序。它会为您将 Showly 服务器写入到您的 ~/.codex/config.toml 中：

npx @showly/mcp-server install --to codex

重启 Codex 以加载新服务器，然后调用一次 Showly 工具触发浏览器登录。

任何其他 MCP 主机

如果只想查看安装程序将写入的配置，可使用 stdout 目标：

npx @showly/mcp-server install --to stdout

把输出的 MCP 服务器块复制到客户端配置中。任何支持标准授权流程 （通过 WWW-Authenticate 发现服务并打开浏览器确认）的 MCP 客户端， 都能在不手动配置令牌的情况下连接 https://mcp.showly.ai。 如果运行智能体的机器没有浏览器，或者批准的人不在这台机器旁，请使用下面的无头登录。

无头登录（设备流程）

当智能体所在的机器没有浏览器（服务器、容器、CI、远程终端），或者批准的人 拿着手机而不在这台机器旁时，运行 npx @showly/mcp-server login --to claude-code。 它会打印页面地址和一个短码，然后一直等待，你在任意设备上批准后，它会把凭据 写入宿主配置。--to codex 写入 ~/.codex/config.toml，该配置从环境变量 SHOWLY_TOKEN 读取凭据而不是从文件读取，命令会同时打印对应的 export SHOWLY_TOKEN=…， 只有在启动 Codex 的环境中设置它，Codex 才能通过认证。--to stdout 只打印 配置片段而不写文件，--print-token 只打印令牌，便于 CI 直接捕获而不落盘。

只有页面上的短码与终端一致时才可批准。授权确认页会要求你显式勾选确认，因为 客户端显示的名称是它自己填写的，只有短码是你能核对的部分。短码有效期 15 分钟， 打开页面后还会再获得 10 分钟用于登录和批准；过期后重新运行该命令即可。

这不是客户端能自行发现的路径：MCP 客户端不会主动发起设备流程，只能通过 login 进入。它写入的凭据 90 天后过期，且 Showly 不签发刷新令牌，过期后重新运行 login。

故障排除

tool not found: mcp__showly__list_sites — 技能已安装，但 MCP 服务器尚未连接。在Claude Code中运行claude mcp list并检查showly条目；调用一次Showly工具来触发登录。

没有出现浏览器登录或提示“未授权” — 智能体可能不支持标准 MCP 授权流程。请升级到最新版本后重试；客户端必须能根据 401 → WWW-Authenticate 发现并打开授权确认页。

“您无权批准” — 批准帐户至少需要site:write。使用所有者/管理员/开发人员/成员帐户登录，或让具有该角色的队友批准。

“找不到网站” — 批准的范围或网站许可名单不涵盖您询问的网站。重新运行登录并批准所需的范围，或从 我的代理 页面 (/app/integrations) 扩大访问范围。

工具调用挂起 — MCP 服务器无法到达 Showly 的 API。检查您的网络；如果您已覆盖端点，请确认SHOWLY_MCP_URL（MCP服务器URL）和SHOWLY_API_URL（API基础）没有指向过时的地方。

撤销访问权限

要撤销访问权限，请打开我的智能体页面（/app/integrations），找到 对应智能体并断开连接。撤销立即生效，下次调用工具时会重新要求登录。 令牌无需手动轮换，智能体会通过浏览器授权流程取得新令牌，或在没有浏览器时 通过 npx @showly/mcp-server login 获取。无头登录得到的凭据 90 天后过期。