你将得到什么

• Claude Code 或 Codex 里出现名为 pomerado 的 MCP 连接
• 连接指向官方 keyless 端点（免账号试用）
• 能让 agent 调用 find_website_tool 等工具（下一课再跑通一次查询）

课前准备

1. 已安装 Claude Code 或 Codex（二选一即可；也可两个都配）。
2. 终端能执行 claude 或 codex 命令。
3. 本课使用官方免密钥 URL，不要把真实 API Key 写进笔记或截图。

说明： Keyless 只能跑公开、只读、且不需要网站登录的工具，并有每日试用额度。构建新工具、写操作、需要登录的站点都要求注册账号（官方：sign_in_required / 免费注册）。

一、Pomerado 是什么（30 秒）

Pomerado 把「在某个网站上完成一件事」做成可复用的 tool，再通过 MCP 或 REST 交给你的 agent：

相对「让模型每次打开浏览器点点点」，托管工具更确定、通常更快。详见 Introduction。

二、Claude Code：添加 keyless MCP

官方推荐命令（与首页 setup prompt / Try without a key 一致）：

claude mcp add --transport http pomerado 'https://mcp.pomerado.ai/mcp/keyless'

然后在 Claude Code 对话里执行（这是 聊天内命令，不是 shell）：

/mcp

选中 pomerado，确认连接状态为已连接/可用。

对照结果：

• claude mcp list（若你的版本提供该子命令）里能看到指向 mcp.pomerado.ai 且路径含 /keyless 的条目。
• 向 agent 提问：「列出 Pomerado 现在可用的工具名」——应能提到类似 find_website_tool、run_read_only_website_tool、get_job 等（名称以客户端实际列出为准）。
• 若误把 API Key 配到 keyless URL，官方会返回 keyless_url_credentials：去掉 /keyless 或去掉 Key，二选一。

三、Codex：添加 keyless MCP

codex mcp add pomerado --url 'https://mcp.pomerado.ai/mcp/keyless'

对照结果：

• codex mcp list 中可见 pomerado，URL 含 /keyless。
• 新开一轮对话后，agent 能引用 Pomerado 工具（具体 UI 因 Codex 版本而异）。

四、Cursor / VS Code（可选）

若你用 Cursor，可在 MCP 设置中加入（OAuth/账号版 URL；试用可先走 Claude Code keyless）：

{
  "mcpServers": {
    "pomerado": {
      "url": "https://mcp.pomerado.ai/mcp/keyless"
    }
  }
}

VS Code 示例（.vscode/mcp.json）：

{
  "servers": {
    "pomerado": {
      "type": "http",
      "url": "https://mcp.pomerado.ai/mcp/keyless"
    }
  }
}

对照结果： 客户端工具列表出现 Pomerado；浏览器打开 MCP URL 若看到 405 属正常（MCP 吃 POST，不是给人浏览的页面）。

五、以后要升级成正式账号时（了解即可）

官方路径：让 agent 调用 sign_in，浏览器打开链接、注册/登录并批准；客户端改连 https://mcp.pomerado.ai/mcp（无 /keyless），用 OAuth 或 Dashboard 签发的 Bearer Key。详见 Connect。本课 不必 完成注册。

本课检查清单

• 已执行 claude mcp add …/keyless 或 codex mcp add …/keyless
• /mcp（Claude Code）或等价列表里能看到 pomerado
• 未在笔记中粘贴真实 API Key
• 理解：keyless = 公开只读试用，有每日上限

下一课：用 find_website_tool + run_read_only_website_tool 完成一次只读查询。