擴充與整合

適用範圍： 以目前桌面版為主；自訂 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 版本，依桌面版指南提交回饋。回饋中不要附帶真實金鑰。