連接
透過工具閘道將系統連接到使用者的應用程式：一個單一的 MCP 伺服器 (Composio)，從中授權每個應用程式。一次前進一個步驟，並在下一個步驟之前等待使用者確認。
開始之前
- 讀取
opencode.json和memory/wiki/conexiones.md（如果存在）。如果 Composio 已啟用，則跳到步驟 4。 - 用一句話告訴使用者你將要做什麼，以及最低目標是連接一個應用程式。
步驟 1 · 帳戶和金鑰
請使用者在瀏覽器中執行以下操作：
- 前往 https://composio.dev 並使用他們的個人 Gmail 建立帳戶（大學郵件可能會封鎖授權）。免費方案不需要信用卡。
- 在儀表板中，開啟 AI Clients 並複製他們的 consumer API key。
不要要求使用者在聊天中貼上金鑰。 這裡寫的內容可能會留在歷史記錄中。
步驟 2 · 將金鑰儲存在使用者的電腦上
金鑰放在環境變數中，位於儲存庫之外。根據使用者的系統提供命令，並讓他在另一個終端機中執行：
# macOS / Linux (zsh)；在 bash 中使用 ~/.bashrc
echo 'export COMPOSIO_CONSUMER_KEY="貼上你的金鑰"' >> ~/.zshrc && source ~/.zshrc
# Windows (PowerShell)
setx COMPOSIO_CONSUMER_KEY "貼上你的金鑰"
在 Windows 上，setx 僅適用於新的終端機：必須關閉並重新開啟終端機。
步驟 3 · 啟用 Composio
請求許可，並將 opencode.json 中的 mcp.composio 區塊更改為 "enabled": true。不要更改任何其他內容。
然後請使用者關閉 OpenCode 並在一個新的終端機中，於此資料夾內重新開啟它，然後執行：
opencode mcp list
Composio 應該顯示為已連接。如果沒有：
opencode mcp debug composio會顯示錯誤。- 如果它說缺少金鑰，則表示變數沒有傳遞到此終端機：重複步驟 2 並開啟一個新的終端機。
步驟 4 · 連接第一個應用程式
當使用者回來時，詢問他想要先連接哪個應用程式（建議 Google 日曆）。使用管理連接的 Composio 工具來產生授權連結，將連結提供給使用者，並等待使用者在瀏覽器中授權然後返回聊天。
透過簡單的讀取來驗證：今天的活動，或郵件中最近的三個主題。向使用者顯示結果。
如果時間允許，對第二個應用程式重複此步驟。
步驟 5 · 記錄
建立或更新 memory/wiki/conexiones.md，內容包括：哪些應用程式已連接、連接日期以及它們的用途。不包含金鑰或電子郵件。 從 memory/index.md 連結到該檔案。
以「試試 /brief 來查看你的一天」作結。
備用方案 · 不使用 MCP
如果 MCP 無法連接，Composio CLI 同樣有效：
curl -fsSL https://composio.dev/install | sh # 然後開啟一個新的終端機
composio login # 如果沒反應：composio logout 然後 composio login --no-wait
composio link googlecalendar
composio search "list today's calendar events"
composio execute <SLUG> --dry-run -d '{...}'
規則
- 先讀後寫。 對於檢查連接，僅執行讀取操作。
- 未經使用者明確批准，絕不執行任何發送、建立、更新或刪除的動作，即使 OpenCode 已經在請求你的許可。
- 絕不將金鑰寫入儲存庫檔案中。如果使用者在聊天中貼上金鑰，告訴他在儀表板中重新產生一組。
- 如果某個操作失敗兩次，停下來，告訴使用者失敗的原因，並提供備用方案。不要臨時變更設定。