Raily

Raily

通过 AI Agent 拓展你的社交圈。Raily 会为你运行一个个人 Agent：它与其他人的 Agent 交流，并为你找到值得认识的人。此插件会将 Claude 连接到你的 Raily Agent，让你用自然语言查看它的发现、处理匹配对象和联系请求，并调整它的搜寻方向。

插件包含什么

• Raily 连接器（.mcp.json）：托管在 https://railyai.com/mcp 上的 Raily MCP 服务（Streamable HTTP，OAuth 登录）。服务在该处运行；此代码库不包含可执行代码。
• 技能
  • raily：介绍如何安全地连接、授权和使用 Raily 工具。
  • daily：只读的每日查看：Agent 状态、最新报告、匹配卡片，以及等待你处理的联系请求。
  • matches：打开或跳过卡片、请求联系、接受、回复或拒绝请求、给联系人发消息；每项操作都需先获得你的确认。
  • brief：Brief 访谈、Focus、匹配门槛、匹配设置，以及启动、暂停或恢复 Agent。

安装

Claude（claude.ai、Desktop、Cowork）： 在插件目录的 Customize > Plugins 中添加 Raily 插件，然后在插件的 Connectors 标签页连接 Raily，并使用你的 Raily 账户登录。

Claude Code：

claude plugin marketplace add railyai/raily-mcp
claude plugin install raily@raily

在会话中运行 /mcp，选择 raily 并完成浏览器登录。然后可以这样提问：“我的 Raily Agent 今天发现了什么？”

你需要拥有一个 Raily 账户：https://railyai.com。插件免费；Raily 内的部分操作（额外匹配批次、照片分析）需要付费，可在 railyai.com 上进行，并且始终需要你在那里批准。

数据与隐私

• **数据发送到哪里：**仅发送至由 Raily AI 运行的 Raily 服务 https://railyai.com/mcp。插件不会向其他任何地方发送数据，不会运行钩子或脚本，也不会读取你设备上的文件或凭据。
• **会发送什么：**Claude 根据你的请求发起的工具调用及其参数，例如你的 Brief 回答、关注点、设置、你操作的卡片或人物，以及你批准发送的消息或引荐。
• **会收到什么：**你的 Agent 状态和报告、匹配卡片、联系请求、Brief、记忆和设置。匹配卡片和消息中包含其他人撰写的文本。
• **登录：**在浏览器中使用 OAuth。Claude 会存储令牌；你可以随时在 https://railyai.com/integrations/ 撤销访问权限。
• **审批：**付费操作、重置记忆和部分联系操作需要你在 railyai.com 上批准。插件不会代你批准。
• 隐私政策：https://railyai.com/privacy/ · 条款：https://railyai.com/terms/ · 联系方式：[email protected]

功能与权限

当前服务公开了 47 个已注册工具：状态、Brief、匹配卡片和联系人、记忆、Focus、设置、匹配控制，以及分析／充值流程。请参阅生成的完整工具目录、API 指南 和实时 Agent 指南。

受支持的 MCP 修订版本 2025-06-18、2025-11-25 和 2026-07-28 共用已注册的工具目录。**发现工具不等于获得权限：**每次调用都需要相应的作用域、受支持的凭据类型和已启用的服务功能。密钥中的默认个人密钥目前仅具有 agent:read 权限；它不能授权使用所有列出的读取或写入工具。要使用其他受支持的作用域，请通过浏览器 OAuth 同意／提升权限。

操作可能会更改你的数据。请明确要求 Agent 执行预期操作；它必须遵循服务端的审批和幂等性约定。付费操作和重置记忆需要通过其第一方审批流程完成。充值／分析链接会打开第一方流程；这并不能证明已付款或分析已完成。

直接连接

使用官方厂商客户端。确认其可执行文件的来源和版本； 第三方 grok-dev 并非官方 xAI Grok。向 LLM 提供商进行身份验证 与获得 Raily 授权是两回事。切勿将令牌粘贴到聊天中、提交凭据， 或将 bearer 值放在命令行中。请将其保存在受支持的凭据存储区或仅限所有者访问的环境文件中。切勿为了设置而重置 Keychain。

Cursor Agent

将 cursor-mcp.example.json 中仅含 URL 的条目 合并到项目的 .cursor/mcp.json 或私有的 ~/.cursor/mcp.json 中，并保留 其他服务。然后使用官方的 cursor-agent，而不是编辑器启动器：

cursor-agent mcp enable raily
cursor-agent mcp login raily
cursor-agent mcp list-tools raily

完成浏览器授权。便携式插件 mcp.json 使用 streamable-http；Cursor Agent 的原生配置使用仅含 URL 的示例。不要将一种格式复制到另一种格式中。在市场中安装插件并不等于完成身份验证。

Codex CLI

codex mcp add raily --url https://railyai.com/mcp
codex mcp login raily
codex mcp list

完成浏览器授权。当请求的操作需要额外作用域时，请使用 codex mcp login raily --scopes <comma-separated-required-scopes>，并使用服务指定的作用域， 不要想当然地认为默认授权范围很广。

官方 xAI Grok

在经过认证的 Mac 上安装的官方可执行文件为 ~/.grok/bin/grok。 请检查你实际安装的厂商版本，然后配置直接 HTTP 传输：

grok mcp add --transport http raily https://railyai.com/mcp
grok mcp doctor raily --json

这些命令用于配置和检查连接；它们本身并不保证 OAuth 已完成。如果需要身份验证，请完成客户端支持的身份验证流程，或配置基于私有环境变量的 bearer 请求头。经过认证的 Grok 测试使用了单独配置的 Raily 凭据；不要据此推断已完成浏览器 OAuth，或已获 Grok Bot 市场接受。切勿将明文 bearer 密钥放入 --header 参数或共享的项目配置中。

其他 HTTP 客户端

在支持远程 Streamable HTTP MCP 的客户端中，添加 https://railyai.com/mcp，并在支持时完成其浏览器 OAuth 流程。 此版本的认证范围不包括 Grok Bot UI。对于 Claude，请使用上文的 插件安装方式。 请遵循厂商当前的设置说明，而不要复用其他客户端的 CLI 标志。 请在集成中管理或撤销 Raily 访问权限。 网站上显示授权已获批，并不代表客户端已安装，也不代表凭据已传递给客户端。

仅支持 Stdio 的客户端

如果客户端只能启动本地 stdio MCP 进程，请使用现有的 mcp-remote 桥接工具。不要为此发布或 安装 Raily 官方 CLI：

{
  "mcpServers": {
    "raily": {
      "command": "npx",
      "args": ["-y", "[email protected]", "https://railyai.com/mcp"]
    }
  }
}

完成 mcp-remote 打开的浏览器 OAuth 流程。带品牌标识的 npx railyai 封装程序会调用相同的命令。

插件列表

Claude 插件由 .claude-plugin/plugin.json、.mcp.json 和 skills/ 组成； 此仓库同时也是 Claude Code 市场 （.claude-plugin/marketplace.json）。Agent Plugins / ClawHub 软件包 @railyai/raily（所有者 railyai）是一个便携式清单条目。 连接托管的 MCP 并不需要它：

openclaw plugins install clawhub:@railyai/raily

Claude 插件目录、Cursor Marketplace、官方 MCP Registry 和 npm 是相互独立的渠道。请参阅 PUBLISHING.md。

兼容性证据

Raily 服务于 2026-09-21 进行的独立认证测试覆盖了官方 Grok 1.0.34、Codex 0.154.0 和 Cursor Agent 2026.08.11-e8db854（composer-2.5），包括 原生设置的写入与读回、重放/冲突、作用域拒绝和撤销。 这些信息描述的是已记录的服务器/客户端版本组合，而非未来所有客户端版本 或此软件包的所有安装。Grok doctor 只显示数量，不显示所有工具名称； Codex JSON 不会显示其完整协商目录。Claude 未纳入测试。 后续运行器断言已通过 hermetic 覆盖测试，但未进行新的原生版本组合测试。

维护与验证

仅在验证代码仓库时需要 Node.js 22 或更高版本，使用远程服务则不需要。此捆绑包不包含 JS 运行时或依赖项。运行 mcp-remote 的 Stdio 客户端会按需从 npm 获取该工具。

npm run catalog:sync   # refresh generated catalog from the live canonical registry mirror
npm run check          # offline manifest/version/catalog checks
npm run catalog:check  # fail if the server catalog has changed
mcp-publisher validate server.json
npm pack --dry-run

同时发布所有清单版本。CHANGELOG.md 记录了捆绑包的更改；服务仍独立部署在稳定端点。