SiteData MCP README

请直接在当前这台电脑完成 SiteData MCP OAuth 2.1 + PKCE 接入。我只会在浏览器确认授权；不要让我再粘贴命令、JSON、authorization code 或回调地址。

目标客户端：Codex
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"
运行位置：本机 Agent

请连续执行到需要重启为止：
1. 确认当前宿主确实是 Codex，并判断它运行在 Windows 原生、WSL、macOS 还是 Linux。配置和 OAuth 必须在当前 Codex 实际运行的同一环境完成，禁止跨 Windows 用户目录和 WSL Home 写入配置。Codex 客户端与 CLI 处于同一环境时共用 MCP 配置，不要重复添加。
2. 定位当前宿主实际使用的 codex 可执行文件绝对路径并读取版本；后续所有 Codex 命令均使用该路径。如果当前宿主没有可用 CLI，但提供官方 MCP 设置或宿主 API，则在同一配置域完成等价操作，不得编造命令。
3. 把连接名称、MCP 地址和 scope 作为纯数据处理。调用进程时使用参数数组，不拼接 shell 字符串；执行 shell 前关闭 xtrace。
4. 先使用参数数组 ["mcp","get","sitedata"] 检查连接。仅当连接不存在时，使用 ["mcp","add","sitedata","--url","https://mcp.sitedata.dev/mcp"] 添加。已有唯一同名连接且 URL 逐字正确时保留；URL 不一致或同名来源不唯一时停止并准确报告，不得覆盖。SiteData 支持动态客户端注册，不要虚构或写入固定 client_id、client_secret、认证请求头或 Token。
5. 检查认证状态及是否已有等待中的授权流程。配置、探测或添加操作已经触发 OAuth 时，只等待该流程。只有明确未认证或凭据失效且没有活动流程时，才使用 ["mcp","login","sitedata","--scopes","mcp:invoke"]；本次最多发起一次 OAuth。
6. 让登录进程打开本机默认浏览器并等待我登录 SiteData、选择账户及确认授权。由当前 Codex 环境自动接收 loopback 回调；不要让我复制 authorization code、authorization URL、callback 地址或第二段提示词，也不要自行拼接授权 URL。
7. OAuth 成功后，只确认登录进程正常退出和配置已持久化；不要在旧会话再次探测状态、重复登录或调用 MCP 工具。
8. 提醒我重启当前 Codex 会话或客户端一次，然后停止。重启后列出 sitedata 工具；只有 schema 与预期一致时，才调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"} 验证连接，不得改用任何写操作。
9. 全程不得在对话、日志、命令回显或普通配置中暴露 access_token、refresh_token、authorization code、authorization URL、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri。敏感输出只能静默处理，只汇报状态。
10. 到达重启点后只汇报：Codex 运行环境与版本、修改的配置位置、一次 OAuth 是否成功、已明确需要重启当前会话。不要回显任何凭据。

请直接在当前这台电脑完成 SiteData MCP OAuth 2.1 + PKCE 接入。我只会在浏览器确认授权；不要让我再粘贴命令、JSON、authorization code 或回调地址。

目标客户端：Claude Code
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"
运行位置：本机 Agent

请连续执行到需要重启为止：
1. 确认当前宿主是 Claude Code CLI 或 Claude Desktop 的 Code 页签。Claude Desktop 普通聊天窗口使用另一套连接器配置；如果当前不是 Claude Code，立即停止，不要写入错误产品。
2. 判断 Claude Code 实际运行在 Windows 原生、Git Bash、WSL、macOS 还是 Linux。配置和 OAuth 必须在同一环境完成，禁止跨 Windows 用户目录和 WSL Home 写入。
3. 定位当前宿主实际使用的 claude 可执行文件绝对路径并读取版本；后续命令始终使用该路径。
4. 把连接名称、MCP 地址和 scope 作为纯数据处理。调用进程时使用参数数组，不拼接 shell 字符串；执行 shell 前关闭 xtrace。
5. 检查 claude mcp --help、claude mcp add --help，再用 ["mcp","list"] 检查所有可见连接。仅当连接不存在且帮助确认参数可用时，使用 ["mcp","add","--transport","http","--scope","user","sitedata","https://mcp.sitedata.dev/mcp"] 添加。已有唯一同名连接且 URL 正确时保留；URL 不一致或同名来源不唯一时停止。不要虚构或写入固定 client_id、client_secret、认证请求头或 Token。
6. 检查 claude mcp login --help 和连接状态。只有明确未认证或凭据失效且没有活动流程时才登录，本次最多一次。若当前版本真实提供 mcp login，则把 sitedata 作为独立参数，并仅在帮助明确支持时请求 mcp:invoke；否则使用 Claude Code 当前真实存在的 /mcp 认证入口，不得手工实现 DCR/PKCE。
7. 让 Claude Code 打开本机默认浏览器并等待我登录 SiteData、选择账户及确认授权。由当前环境接收 loopback 回调；不要让我复制任何授权码、授权 URL 或回调地址。
8. 授权成功后，只确认流程正常结束和配置已持久化；不要在旧会话重复探测、登录或调用工具。
9. 提醒我重启当前 Claude Code 会话或客户端一次，然后停止。重启后列出工具；只有 schema 一致时，才调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"}，不得执行写操作。
10. 全程不得暴露 access_token、refresh_token、authorization code、authorization URL、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri，只汇报状态。
11. 到达重启点后只汇报：Claude Code 运行环境与版本、修改的配置位置、一次 OAuth 是否成功、已明确需要重启当前会话。

请直接在当前 Windows 或 macOS 的 Cursor 桌面端完成 SiteData MCP 接入，并让 Cursor 根据 MCP/OAuth 元数据管理 OAuth 2.1 + PKCE。我只会在浏览器确认授权；不要手工配置 DCR、PKCE、client_id 或回调地址。

目标客户端：Cursor 桌面端
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"

请按 Cursor 当前实际能力连续执行：
1. 确认宿主确实是 Windows 或 macOS 的 Cursor 桌面端，并确认 Cursor、当前 Agent 和工作区处于同一可验证配置域。WSL、SSH、Dev Container、原生 Linux 和 Cloud Agents 不能证明本机桌面端已完成接入。
2. 优先使用 Cursor 的 Customize → MCP 设置。只有 agent mcp --help 明确证明相关 CLI 和参数存在时才使用 CLI。检查所有来源中的 identifier、URL、启用状态和连接状态；同名候选不唯一时停止并请我选择作用域。如果 Agent 不能操作 Cursor UI，在需要 UI 时暂停，不得声称已操作。
3. 只有目标不存在时，才把下面的 URL-only 配置合并到确认生效的 mcp.json。已有唯一同名条目时先确认 URL 逐字一致并保留未知字段；URL 不一致、含固定 auth/headers、来源为 team/marketplace 或字段含义不明时停止。不得跨系统、用户或环境写入，不覆盖其他服务器，不写固定认证参数：
{
  "mcpServers": {
    "sitedata": {
      "url": "https://mcp.sitedata.dev/mcp"
    }
  }
}
4. 保存后确认 sitedata 已启用且生效来源正确。只有 CLI 帮助明确提供 enable 时才使用 CLI，否则在 Customize → MCP 中启用。
5. 使用当前版本真实提供的登录入口。只有 agent mcp --help 明确提供 login 时才通过 CLI 登录，否则在 Customize → MCP 中登录。让 Cursor 从 MCP 受保护资源元数据发现授权服务器和 mcp:invoke scope，并通过动态客户端注册管理 OAuth。
6. 已有有效连接直接复用；已有活动授权流程只等待当前流程。只有明确未认证且没有活动流程时才登录，本次最多一次。浏览器登录、账户选择、2FA/CAPTCHA 和最终授权由我完成。不得复制或回显授权 URL、code、callback、state、verifier 或 Token。
7. 授权成功后刷新 MCP 列表；无法热加载时提示我保存工作，再由我重启 Cursor 或新建会话一次。不要杀进程或重复登录。
8. 刷新或重启后确认 sitedata_rankings 和 sitedata_favorites 已加载。先核对 endpoint，再只允许调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"} 验证连接，不得使用写操作。工具或 schema 不一致时停止。
9. 全程不得复制、回显或持久化 access_token、refresh_token、authorization code、authorization URL、request_id、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri。
10. 只有 identifier、source、URL、配置、启用状态、OAuth、工具可见性和只读收藏查询均已验证，才报告安装完成；否则准确说明阻塞步骤，不回显收藏内容或凭据。