扩展与集成

适用范围： 以当前桌面端为主；自定义 MCP 配置另提供 CLI 方法。浏览器和电脑操作示例以 macOS 桌面端为例。

通过项目规则、Skills、插件和 MCP 服务，让 Remy 按你的工作要求处理任务，并连接所需的工具。安装后，还应检查是否启用、是否完成授权，以及实际任务是否可以使用。

1. 选择合适的扩展方式

MCP 是一种连接工具和服务的方式。连接后能读取什么、能做什么，取决于该服务提供的能力、登录账号及授权范围。

2. 安装并管理插件

2.1 从目录安装

1. 打开 Settings → Plugins。
2. 点击 Browse，在目录中查找需要的插件。
3. 打开详情，查看用途、来源及包含的能力。
4. 点击安装按钮，等待安装结果。
5. 如果需要账号登录或其他配置，按详情中的提示完成。
6. Try now 可用时，点击进入任务，并说明你希望它完成什么。

例如，首次尝试资料服务时，可以先做范围清楚的读取任务：

请使用刚连接的资料服务，查找我有权访问的项目入门文档。
列出标题、来源和简短说明。只读取，不创建、修改或删除内容。

核对返回来源，确认连接到了正确的账号和资料范围，再继续更复杂的任务。

2.2 查看启用状态

在 Settings → Plugins 中，可按类型、来源和状态筛选。打开条目详情，查看其启用状态及提示。

插件、其提供的 Skill 和 MCP 服务可能分别有开关。子项已经打开，但所属插件被停用时，该子项仍可能不可用。以条目显示的实际状态和原因处理，不要只看某一个开关。

团队管理的能力可能受到组织规则限制。对应操作不可用时，阅读原因并联系团队管理员。

2.3 停用、卸载与断开连接

停用、卸载和断开连接是不同的操作。需要结束外部服务授权时，也应按该服务自身的授权管理方式检查；不要将关闭能力开关视为完成了所有授权清理。

3. 安装和使用 Skill

3.1 安装已有 Skill

1. 打开 Settings → Plugins，筛选 Skill 类型。
2. 点击 Install Skill…。
3. 选择提供给你的 Skill 目录或 .skill 文件，等待安装结果。
4. 打开该 Skill 的详情，阅读用途和使用条件。
5. 确认其处于可用状态，点击 Try now 并输入实际任务。

属于某个插件的 Skill，通过该插件的安装和管理入口处理。如果卸载操作不可用，先查看它的来源和管理说明。

3.2 创建自己的 Skill

Skill 筛选下提供 Create Skill 时，点击后在打开的对话中说明：

• 哪类任务会反复出现。
• 需要遵循的步骤或参考资料。
• 输出应采用的结构和完成标准。

例如：

请帮我创建一个整理周报的 Skill。
输入是我提供的工作记录；输出包含完成事项、当前问题和下周计划。
不要编造进度、负责人或日期，缺失信息标为待确认。
请先向我确认必要要求，再完成创建，并说明如何试用。

完成后，用一份真实但范围较小的材料试用，检查它是否按预期工作。安装或创建成功不代表每次任务都会自动采用；可以在请求中明确指明要使用的 Skill。

4. 连接 MCP 服务

4.1 使用插件提供的服务

1. 安装对应插件，打开插件详情中的 MCP 服务条目。
2. 需要账号授权时，点击 Not connected，或继续安装后自动打开的登录流程。
3. 在授权页面核对账号与权限，完成登录后返回 Remy。
4. 等待状态变为 Connected，再执行一个小任务检查实际读取或操作是否正常。

不需要账号登录的服务不一定显示授权按钮。需要额外配置时，按服务说明提供必要条件。

4.2 通过 CLI 添加自定义服务

先按 CLI 指南完成安装和登录。向服务提供方取得单个 MCP 服务的 JSON 配置对象，保存为本机文件，例如 my-mcp-server.json。

将下面的项目路径、服务 ID 和配置文件路径替换为实际值：

remy --workspace "/path/to/project" config mcp list
remy --workspace "/path/to/project" config mcp set my-server --file "./my-mcp-server.json"
remy --workspace "/path/to/project" config mcp show my-server

set 可以创建或替换同名自定义服务。执行前检查是否已有同名配置；不要用它改写属于插件的服务条目。

需要启用或停用时：

remy --workspace "/path/to/project" config mcp enable my-server
remy --workspace "/path/to/project" config mcp disable my-server

上面两条命令分别对应启用和停用，按需要选择一条。根据命令返回的信息核对写入结果和作用范围；相关配置需要新的运行会话读取，已有 Desktop 或 CLI 运行会话需要重新加载运行环境或重启后再验证。

配置文件可能含有凭据，不要将真实密钥直接写进命令参数或对话中。配置已保存也不等于远端服务已连接，仍需确认运行条件、授权和一次实际调用。

5. 使用项目规则

项目已有 AGENTS.md 或 CLAUDE.md 等约定时，在任务中要求 Remy 先读取适用说明，再开展工作。规则应说明项目结构、修改范围、检查方式和交付要求。

请先读取当前项目中适用的 AGENTS.md、CLAUDE.md 和 README。
概括本次任务需要遵循的约定及检查方法，再开始处理需求。
遇到冲突或缺少依据时，先说明问题。

项目规则表达工作要求；文件访问、命令执行和外部操作仍由实际权限控制。修改说明文件不能代替授权设置。

6. 浏览器与电脑操作

6.1 操作网页

根据任务说明要操作的网页及浏览器。Remy 的内嵌浏览器与通过扩展连接的 Chrome 是不同入口，不要假定两者具有相同的登录状态。

请在内嵌浏览器中打开我提供的网址，阅读帮助页并列出安装步骤。
只读取页面，不提交表单或修改账号设置。

需要使用本机 Chrome 时，在任务中明确说明。出现 Remy in Chrome — not installed 时，点击 Get the extension，完成扩展安装后返回并重新提出任务。如果提示已安装但无法连接，先确认 Chrome 正在运行，再检查连接提示；已安装不等于已连接。网页需要登录时，先在对应浏览器完成登录。

6.2 授予电脑操作所需的系统权限

1. 在 Settings → Plugins 中打开电脑操作能力的详情。
2. 找到 Permissions，查看 Accessibility 和 Screen Recording 的状态。
3. 需要授权时，点击 Open System Settings，在 macOS 系统设置中为对应应用或组件授权。
4. 返回 Remy，点击 Recheck 并检查状态。
5. 如果系统要求重新打开应用，按提示完成后再尝试任务。

这些权限由你在系统设置中授予，Remy 不能替你直接开启。出现 Helper missing 时，需要处理应用组件缺失，反复授权不能解决这一问题。

第一次使用时，可从读取某个已打开应用中的指定内容开始，核对结果后再授权修改。停止执行或关闭能力，不会自动撤销已经发生的外部操作。

7. GitHub 与 Slack 的使用入口

GitHub 仓库任务： 通过 Cloud 的连接入口完成 GitHub 授权，选择仓库与分支，再发起任务。具体步骤见 Cloud 指南，无需在本指南重复安装和上云流程。

在 Remy 中访问 Slack： 使用对应插件或 MCP 连接，完成账号授权后，在 Remy 对话中提出任务。可读写范围受 Slack 账号权限和连接范围约束。

在 Slack 中调用 Remy： Remy Tag 让已开通的 Slack 环境通过 @Remy 发起云端任务并查看结果。它与在 Remy 中连接 Slack 的方向不同；安装 Slack 插件不等于完成 Remy Tag 开通。

8. 常见问题

仍无法解决时，记录能力名称、所处步骤、错误提示和 Remy 版本，按桌面端指南提交反馈。反馈中不要附带真实密钥。