🎓 Raycast 專家養成

解開了。官方 iOS 步驟一直都在，藏在文件的「Desktop / iOS」分頁裡——WebFetch 的摘要器把它整個吃掉，我用瀏覽器讀原文＋點開 iOS 分頁才拿到。

官方逐字（iOS 分頁）：

Tap Account Avatar → AI → MCP Servers.
Tap ＋ in the top right to add a server, or pick one from Popular MCP Servers to prefill the form.
Give the server a Name and its URL, and optionally a Description and Custom Instructions. Choose the OAuth Type and add any HTTP Headers the server needs.
Tap Save.

You can also ask AI Chat to set one up — 對 chat 說「add the … MCP server」，Raycast AI 會自己填好再讓你確認。

管理：同一個位置，左滑可 Refresh／Delete，刪除會一併清掉 OAuth token。用法是在 chat 裡 @ 叫出來。

我猜錯兩次都記在這裡：先說在 Settings（夏哥截圖打臉）、再說在主搜尋框（也是錯的）。正解是 Account Avatar → AI → MCP Servers。

解開了，而且推翻我先前的說法。

官方 Cloud Sync 頁確實把 MCP Servers 列在同步清單裡。但同一頁逐字寫著：

• 「The Cloud Sync settings shown here are exclusively part of v2, and Cloud Sync v2 for iOS is coming soon.」
• 「Legacy Raycast & iOS Devices groups all of your Raycast v1 and iOS devices into a single entry.」

那份含 MCP Servers 的同步清單是 v2 專屬的，而 iOS 還在 legacy。

結論：不能靠「Mac 設一次、手機自動有」。我上一輪講的那句是錯的——MCP server 必須在 iPhone 上自己加。幸好沒當成教學步驟給出去。

邊界釐清：iOS 不能裝社群 AI Extensions，但可以接 MCP server 達到同樣效果，兩者並存不矛盾。

• 自帶 API key（v1.2.13 起）：Anthropic／Google／OpenAI／OpenRouter
• MCP 可綁 AI Presets（v1.3.1）→ 配合動作按鈕能一鍵直達特定工具組
• 背景執行工具／MCP（v1.3.4），工具呼叫會分組顯示
• Personalization = Profile（手寫）＋ Memory（自動累積），Memory 走 Cloud Sync

額度（夏哥是 Advanced AI $19.99/月）：75 requests／3 小時、150／24 小時；o1、GPT-4 Turbo、Claude Opus 這類頂級模型 50／週／每個模型。

⚠️ 未知：手冊沒說明工具呼叫／MCP 呼叫是否計入上述額度。

三個文字入口，能力不同：

• 口述：語言可設 Auto 自動偵測；可自訂 Styles（用 prompt 描述格式規則）＋ Auto Styling 依 app 套用；beta 期間免費，單次上限 20 分鐘，背景維持 5 分鐘 session。
• 自訂鍵盤：AI & AI Commands、口述、Quicklinks／Snippets（支援動態佔位符）、最近項目。官方明講它是「secondary keyboard」。
• 分享表單：選取文字 → Share → Raycast → 跑 AI Commands。

⚠️ 重要限制：手冊在鍵盤頁完全沒提能存取 MCP 工具或 AI Chat。所以口述要觸發 cacoch-mcp，應該得在 Raycast app 內的 AI Chat，不是在別的 app 用 Raycast 鍵盤。此點官方未正面說明。

動作按鈕確認可行——官方原文：「Raycast Shortcuts can be triggered straight from the Action Button — like Ask AI or opening a specific Raycast Note.」

• Shortcuts actions：Ask AI、AI Commands、Open Voice（可從 Shortcuts app 或 Spotlight 叫用）
• Ask AI intent（v1.3.4）：可指定 model／preset ＋ 傳入語音或文字
• 主畫面 widget：AI Widget（相機／語音／Ask AI）、Favorites
• 鎖定畫面：Open Voice、Create Note、Snippets；控制項可取代手電筒／相機鍵
• 控制中心：Start a new AI Chat、Ask AI、Open Voice、Open Camera、Create Note

推論（合理但未實測）：Ask AI intent 能綁 preset，而 preset 能綁 MCP（v1.3.1）→ 動作按鈕一按即直達 cacoch 工具組。這條路徑值得在 #8 一併試。

本機實測版本 1.104.24。抓下來的 macOS changelog 顯示穩定版最新是 v1.104.0（2025-12-16）——2026 年的新東西（Agents、Skills、Dictation、Cloud Sync v2）全在 macOS v2 beta 這條線上，不在夏哥跑的穩定版裡。

⚠️ 這推翻我自己上一輪的自評。我說「macOS 知識差八個月」，實際是穩定版本來就停在 2025-12，不是我漏讀。真正的落差是：手冊講的 Agents／Skills／Cloud Sync v2 是 v2 的世界，夏哥的 Mac 是 v1 穩定版。

連帶推論：Cloud Sync 原文寫「Legacy Raycast & iOS Devices groups all of your Raycast v1 and iOS devices」——夏哥的 Mac（v1）跟 iPhone 同屬 legacy 群組，兩邊都不在 v2。

Mac 獨有：stdio 本機 MCP、社群 AI Extensions、Install／Manage MCP Servers 指令、mcp-config.json。本機實測限制：Raycast 是背景 app（無 Dock 圖示），computer-use 完全看不到它，我無法代操作 Mac 端 GUI。

研究完成，8/8。後端已按官方文件調整過，等接上去。

因為 iOS 支援 HTTP Headers，我把認證改乾淨了——secret 不再放網址裡（網址會進瀏覽紀錄與日誌）。四種情況實測：header 正確 200、舊網址式仍 200（相容）、無認證 404、錯 header 404。

建議填法：

• Name：cacoch
• URL：https://cacoch-mcp.wishia.workers.dev/mcp
• OAuth Type：不用（留空／None）
• HTTP Headers：Authorization = Bearer <secret>（secret 在夏哥的 Telegram）

後端狀態：MCP 協定層全綠、Google Tasks／Calendar 端到端驗過、行事曆寫進 2026_Cacoch、vault 回寫 launchd 每 15 分鐘 exit 0。