對於 macOS 平台上的開發者、技術專家與重度工作者而言，Raycast 早已超越了單純的快速啟動器（Launcher），成為日常工作流程中的核心中樞。然而，許多使用者在體驗 Raycast AI 時，仍往往將其當作浮動在螢幕上的純文字聊天機器人：AI 給出了程式碼或分析結果後，使用者依然必須手動在 GitHub、Linear、Notion、終端機（Terminal）與 Finder 之間反覆切換並執行動作。
為了解決這種情境割裂，Raycast 深度整合了 AI Tools（亦稱為 AI Extensions，智慧代理工具呼叫體系）。透過原生函式呼叫（Function Calling）機制，Raycast AI（支援 Claude 3.5 Sonnet、GPT-4o 等先進大型語言模型）可以直接跨越應用邊界，自主探索、查詢並呼叫已安裝的第三方 SaaS 擴充功能與本機系統工具。
本篇指南將完整解析如何在 macOS 上啟用與設定 Raycast AI Tools，包含工具擴充功能安裝、@ 語法多工具串聯、權限管控與自動審查規則設定、擴充功能級自訂指令調校，以及串接自訂 MCP（Model Context Protocol）伺服器，助你將 Mac 打造為無縫連動的桌面智慧中樞。
1. 核心架構與事前準備
在設定 Raycast AI Tools 之前，必須先釐清其運作邏輯與基礎環境需求：
- Raycast Pro 訂閱需求：AI Tools 與 AI Chat 的完整工具呼叫功能屬於 Raycast Pro 專屬功能。Pro 訂閱提供高階前沿模型、延伸上下文長度以及智慧工具呼叫執行引擎的存取權限。
- 支援工具呼叫的模型選擇：工具連動取決於底層模型是否支援原生函式呼叫能力。在 Raycast Settings → AI → Models 或 AI Chat 視窗中，請確保當前選用具備工具呼叫與高邏輯推理能力的模型（例如 Claude 3.5 Sonnet 或 GPT-4o）。
- 一般擴充功能指令與 AI Tools 的區別：一般的 Raycast 擴充功能指令是透過搜尋列喚起圖形化介面（如列表清單或詳細檢視）；而 AI Tools 則是擴充功能開放給 Raycast AI 的背景呼叫端點，由大型語言模型在理解對話需求後自動傳入參數執行。
2. 探索與安裝具備 AI Tools 的擴充功能
Raycast 既內建了一整套開箱即用的本機系統級工具，也透過官方商店（Raycast Store）提供了豐富的第三方雲端整合套件。
內建的原生系統級 AI 工具
以下系統工具在 macOS 桌面環境下預設可用，無需額外安裝：
@finder：搜尋、檢索並管理本機 Finder 中的檔案與目錄結構。@file-search：利用系統索引進行極速的本機檔案搜尋。@terminal：直接在對話中執行 Shell 指令與腳本，並由 AI 評估執行輸出結果。@clipboard：檢索剪貼簿歷史紀錄、讀取特定內容或直接更新剪貼簿。@browser：讀取並分析目前正在瀏覽的網頁 DOM 內容（需搭配安裝免費的 Raycast Browser Companion 瀏覽器外掛）。@screen-awareness：擷取當前前景活動視窗的應用程式資訊、選取文字與視窗螢幕截圖。@calendar：查詢行事曆活動、會議時程與空閒時段。@raycast-notes：檢索、建立並管理 Raycast 內建筆記。
從 Raycast Store 篩選並安裝第三方擴充功能
若要讓 Raycast AI 能夠連動 GitHub、Linear、Jira 或 Notion 等遠端工作平台：
- 按下 Raycast 喚醒快速鍵（如
⌥ Space或⌘ Space）開啟主搜尋列。 - 輸入
Store並按 Enter 進入擴充功能商店。 - 按下快捷鍵
⌘ P，開啟導覽列的類別篩選面板。 - 選擇 AI Extensions 分類。此時商店會精確篩選出所有宣告了 AI Tools 介面的擴充功能。
- 找到目標擴充功能（如 GitHub、Linear、Notion、Todoist 或 Spotify），按 Enter 進行安裝。
- 完成帳號授權。安裝完成後，依提示透過 OAuth 完成網頁登入，或於擴充功能設定中填入個人存取權杖（PAT / API Key）。
3. 在 AI Chat 中呼叫與串聯多個工具
安裝完成後，擴充功能所提供的工具將自動註冊至對話內容中。使用者可以在 AI Chat（或於 Quick AI 按 ⌘ J 展開的完整對話視窗）中呼叫使用。
@ 提及語法
在 AI Chat 的輸入框中輸入 @ 符號，畫面會立即列出本機所有已安裝且可用的 AI 擴充功能與工具清單。你可以直接選取或繼續鍵入名稱：
@github 請列出當前指派給我審核的所有 Pull Request，並重點摘要阻擋合併的審查意見。
@linear 在 Platform 團隊中建立一張高優先級票券，標題為「實作 Webhook 流量限制」，並指派至當前進行中的 Cycle。
@browser 幫我總結當前在瀏覽器中開啟的 API 文件頁面，標記出本次更新的所有重大突破性變更。
按 Enter 送出後，模型會自動判斷所需的引數並向擴充功能發起請求。AI Chat 介面會以卡片形式即時展示工具執行狀態，點開即可檢視傳入的參數與回傳的原始資料。
單一 Prompt 跨工具鏈式串聯
深度使用者最核心的自動化場景在於跨應用的多工具協同。Raycast 允許在同一句提問中組合多個 @ 提及：
@calendar @linear 檢查我今天下午是否有超過1小時的連續空閒時間；如果有的話，列出目前 Sprint 中指派給我且未完成的 Linear 工作清單。
@terminal @github 檢查當前工作目錄的 git status，總結我剛剛提交的變更紀錄，並草擬一份標準的 GitHub PR 說明文字。
此時模型會自主規劃執行順序（Step-by-step Execution）：先查詢行事曆或取得 Git 狀態，將結果納入對話記憶，接著呼叫下一個工具或產出最終整合分析，徹底免除人工反覆搬移資料的繁瑣步驟。
4. 權限控管、自動審查規則與安全性
由於 AI Tools 具備執行系統終端指令、改動本機檔案以及修改遠端 SaaS 資料的強大能力，建立嚴密的安全性邊界是不可或缺的環節。
全域權限模式
進入 Settings → AI → Tools，可挑選適合全系統的權限策略：
| 權限模式 | 行為機制 | 建議適用情境 |
|---|---|---|
| Ask | 任何非唯讀動作或未列入信任清單的呼叫，皆暫停對話並跳出彈窗要求使用者確認。 | 高安全合規要求環境；涉及企業機密資產的電腦 |
| Auto（Pro 預設值） | 系統智慧評估安全層級。唯讀查詢與受限本機操作自動執行；具破壞性動作或存取敏感憑證時暫停要求授權。 | 技術開發人員；日常主力工作機；兼顧效率與安全 |
| Always Allow | 無條件自動執行所有工具呼叫，完全不跳出任何確認提示。 | 獨立沙盒測試環境；高度自動化腳本情境 |
Auto 模式的自動審查判斷邊界
Raycast 的 Auto 安全機制具備明確的審查原則：
- 自動放行無需確認：純唯讀性質的資料查詢（如讀取問題清單、瀏覽行事曆、搜尋檔案）；僅在當前對話綁定的專案工作目錄內修改檔案；標準安全的開發檢測指令（如
git status、git log、npm test）。 - 強制暫停要求確認：具破壞性的行為（如刪除檔案、清空資料庫資料、關閉問題）；包含修改系統環境的 Shell 腳本；嘗試讀取機密憑證的動作（如
.env設定檔、SSH 私鑰id_rsa或雲端服務金鑰）。
使用者亦可在 Settings → AI → Tools 的 Auto-review Rules 中，以自然語言自訂微調特定動作的放行或詢問規則。
工具審查互動與快捷鍵
當工具呼叫需要確認時，AI Chat 會暫停運作並顯示描述卡片：
- 按 Enter 鍵
Return：單次允許（Allow），僅授權執行本次呼叫。 - 按
⌘ Return：永遠允許（Always Allow）。該工具會被登記於 Globally Allowed Tools 白名單中，未來呼叫不再詢問。 - 按
Esc：拒絕（Deny）。AI 會收到拒絕通知，並嘗試在不使用該工具的情況下繼續回應用戶。 - 對於
@terminal呼叫的命令，可點擊 Show Command 預先檢查即將執行的完整 CLI 腳本。
個別對話視窗的權限覆寫
若在特定對話中需要採取不同於全域的寬鬆或嚴格策略，無需切換全系統設定。只要在 AI Chat 右側設定欄中的 Permissions（或於對話中按 ⌘ K 選取 Change Permissions…），即可將該對話單獨設定為 Inherited、Ask、Auto 或 Always Allow。
5. 透過自訂指令（Custom Instructions）微調擴充功能行為
當大語言模型在操作特定擴充功能時，往往缺乏團隊特有的業務背景（如專案代號、團隊分組或時區限制）。Raycast 允許為個別擴充功能設定專屬的 Custom Instructions：
- 開啟 Raycast Settings → Extensions。
- 在左側擴充功能清單中選取目標（例如 Linear 或 Calendar）。
- 在右側視窗中，找到與一般指令並列的 Ask 工具。
- 展開該工具，找到 Custom Instructions 文字欄位。
- 輸入該工具被呼叫時模型必須遵循的指導方針。
實際指令設定範例
Linear 設定範例：
所有查詢與新建工作票券的操作，預設指定給 "Platform Engineering" 團隊。新建票券時優先級預設為 "Medium"，並關聯至當前進行中的 Active Cycle。
Calendar 設定範例：
絕不在早上 10:00 之前或下午 17:30 之後安排或建議會議時段。在兩個相連的會議之間，必須預留至少 15 分鐘的緩衝間隔。
GitHub 設定範例：
查詢 Pull Request 時，僅專注於 "octocorp-dev" 組織底下的程式庫。列出待我審查的清單時，自動忽略由 dependabot 產生的自動相依性更新 PR。
設定完成後，只要在對話中呼叫 @linear 或 @calendar，Raycast 就會自動將這些指令載入模型的系統脈絡中，省去每次手動補充限制條件的精力。
6. 進階擴充：串接 Model Context Protocol (MCP)
當官方商店中的現成擴充功能無法滿足連動內部資料庫、內部微服務或專屬技術工具的需求時，macOS 深度使用者可以透過 Model Context Protocol (MCP) 伺服器擴充 Raycast AI。
- 在 Raycast 搜尋列輸入並執行 Install MCP Server 指令（或透過 Manage MCP Servers → Install New Server）。
- 設定伺服器連線資訊：
- Name & Icon：設定識別名稱與圖示，以便在聊天中使用
@提及。 - Transport：本機處理程序選擇 Standard Input/Output (stdio)；遠端伺服器選擇 HTTP。
- Command & Arguments：針對本機 CLI 工具，設定執行檔與參數（例如
npx -y @modelcontextprotocol/server-postgres或本機腳本路徑）。 - Environment：填入連線資料庫或外部 API 所需的環境變數與金鑰。
- Name & Icon：設定識別名稱與圖示，以便在聊天中使用
- 按下
⌘ Return儲存。Raycast 會在背景啟動連線，並透過 JSON-RPC 協議自動載入伺服器宣告的 Tools 清單。
設定完畢後，MCP 工具的互動體驗與原生擴充功能完全一致。你可以在聊天中直接下達 @postgres 統計上週新增的使用者數量，並同樣享有完善的權限審查機制。
7. 最佳實踐與效率建議
- 指派全域專屬快速鍵：至
Settings → Extensions → AI → AI Chat設定一組專屬快速鍵（例如⌥ C或⌃ Space），隨時從任何桌面角落一鍵開啟工具對話框。 - 搭配螢幕感知與選取文字：在編輯器或終端機中選取錯誤記錄，喚醒 Quick AI，輸入
@github 搜尋包含所選錯誤資訊的已解決 Issue，無需切換應用程式複製貼上。 - 定期檢視允許清單：定期前往
Settings → AI → Tools → See Allow List，檢視目前已被設為「永遠允許」的工具；在擴充功能更新或工作環境變更時，點擊 Reset All 重新恢復標準審查提示。
善用 Raycast AI Tools，你的本機 Finder、終端機環境以及雲端協同工具將被緊密串聯，將原本單純的搜尋啟動列昇華為強大的全方位桌面智慧體工作站。