macOSのパワーユーザーやソフトウェアエンジニア、テクニカルマネージャーにとって、Raycastはキーボード主導のランチャーを超えたデスクトップの中枢です。しかし、多くのユーザーはRaycast AIを単なる「画面上のチャットボット」として利用しており、AIから得られた回答を基にGitHub、Linear、Notion、ターミナル、Finderを手動で行き来する非効率な作業を繰り返しています。
この分断を解消するのが AI Tools（Raycastマニュアルでは AI Extensions とも呼称）です。先進的なLLM（Claude 3.5 SonnetやGPT-4oなど）のファンクションコーリング（Function Calling）機能を活用し、チャット上の自然言語指示から、インストール済みのサードパーティSaaS拡張機能やローカルシステムコマンドを自律的に呼び出せます。
本記事では、macOS環境においてRaycast AI Toolsを導入・構成し、@ メンションによるツール連携、安全な権限管理と自動レビュー規則、拡張機能ごとのカスタム指示設定、さらには独自MCP（Model Context Protocol）サーバーの接続まで、実用的なステップを徹底解説します。
1. 前提条件とツールの仕組み
AI Toolsを正しく運用する前に、前提となる動作要件を把握しておきましょう。
- Raycast Proサブスクリプション: AI ChatやAI Extensionsによるツール実行機能はRaycast Proプラン限定の機能です。最先端モデル、広いコンテキストウィンドウ、ツール呼び出しエンジンへのフルアクセスが含まれます。
- ツール呼び出し対応モデルの選択: すべてのモデルが高度なツール呼び出しに対応しているわけではありません。Raycastの Settings → AI → Models またはAI Chatウィンドウ内で、ネイティブなツール呼び出しと高い推論能力を持つモデル（Claude 3.5 Sonnet、GPT-4oなど）が選択されていることを確認してください。
- 通常コマンドとAI Toolsの違い: 通常のRaycast拡張機能コマンドは、検索バーからユーザー向けの画面（リストや詳細ビュー）を立ち上げます。これに対し、AI Toolsは拡張機能がAI向けにバックグラウンドで公開するエンドポイントであり、モデルが文脈を解釈して引数を組み立て、自律的に呼び出します。
2. ツール対応拡張機能の発見とインストール
Raycastには、標準で用意されているmacOSシステム連携ツールと、Raycast Storeから追加できるクラウド連携ツールの2種類が存在します。
標準で備わっているシステム系AIツール
macOS環境において追加セットアップなしで即座に呼び出せる主なツールは以下の通りです：
@finder: macOS上のFinderファイルおよびディレクトリの検索、内容確認、管理。@file-search: システムインデックスを活用したローカルファイルの高速検索。@terminal: シェルスクリプトやコマンドの実行と、その出力結果の評価。@clipboard: クリップボード履歴の検索、特定項目の読み込み、内容の差し替え。@browser: 現在ブラウザで開いているタブのページ内容の読み取り・要約（無料のRaycast Browser Companion拡張機能が必要）。@screen-awareness: 最前面のアクティブウィンドウ情報、選択中のテキスト、ウィンドウのスクリーンショットの取得。@calendar: 今後のミーティング予定や空き時間の照会。@raycast-notes: Raycast内蔵ノートの検索、作成、追記。
Storeからサードパーティ製AI拡張機能を導入する手順
GitHub、Linear、Jira、NotionなどのSaaSと連携させる手順は以下の通りです：
- Raycastの起動ショートカット（
⌥ Spaceまたは⌘ Spaceなど）を押します。 Storeと入力してEnterキーを押します。- ナビゲーションバーで
⌘ Pを押し、カテゴリフィルターを開きます。 - AI Extensions カテゴリを選択します。これにより、AI Toolsが実装されている拡張機能のみが抽出されます。
- 目的の拡張機能（例: GitHub、Linear、Notion、Todoist、Spotify）を選択し、Enterキーを押してインストールします。
- アカウント認証を完了させます。インストール直後に表示されるプロンプトに従い、OAuthによるWeb認証、または設定画面でのAPIキーやPersonal Access Token（PAT）の登録を行ってください。
3. AI Chatでのツール呼び出しと複数ツールの連動
拡張機能の準備が整うと、その機能は AI Chat（AI Chat コマンド、またはQuick AI上で ⌘ J を押して開くワークスペース）から呼び出せるようになります。
@ メンション構文
AI Chatの入力欄で @ を入力すると、インストールされているすべてのAI対応拡張機能とツールの一覧がポップアップ表示されます。リストから選択するか、続けて識別名を入力します：
@github 自分にレビューが割り当てられているオープンなPull Requestを一覧表示し、マージをブロックしている指摘を要約してください。
@linear Platformチーム内に、優先度「High」で「Webhook取り込みのレート制限実装」というタイトルのチケットを作成し、現在のCycleに割り当ててください。
@browser 現在ブラウザで開いているAPIドキュメントを読み取り、今回のアップデートに伴う破壊的変更を箇条書きでまとめてください。
Enterキーを押すと、モデルが実行に必要なパラメータを自動生成し、拡張機能のツールをバックグラウンドで実行します。チャット画面上には実行カードがリアルタイム表示され、渡された引数やレスポンスの構造化データを確認できます。
1つのプロンプトで複数ツールを連鎖実行（チェイニング）
パワーユーザーにとって最大の恩恵は、異なるアプリケーション間での自動連携です。Raycastでは、1つのクエリ内に複数の @ メンションを組み合わせて指示を出せます：
@calendar @linear 本日の午後に1時間以上の空きスロットがあるか確認し、もしあれば現在のSprintで自分にアサインされている未完了タスクを抽出してください。
@terminal @github カレントディレクトリの git status を確認し、直近コミットの内容を要約した上で、GitHub向けの標準的なPR説明文を作成してください。
モデルは計画的にステップを実行します。まずカレンダーやGitの状態を照会して中間コンテキストを取得し、その情報を踏まえて次のツールを実行したり最終的なまとめを生成したりします。
4. 権限管理、自動レビュー規則、セキュリティ設定
AI Toolsはターミナルコマンドの実行、ローカルファイルの編集、外部SaaSデータの変更など強力な権限を持ちます。そのため、適切な安全境界線を設定することが不可欠です。
グローバル権限モード
Settings → AI → Tools に進み、システム全体のセキュリティポリシーを設定します：
| 権限モード | 動作の概要 | 推奨されるユースケース |
|---|---|---|
| Ask | 読み取り専用以外の操作、または個別許可されていないアクションに対し、必ず確認ダイアログを表示する。 | 高いセキュリティが求められる環境；機密データを扱う業務PC |
| Auto（Proデフォルト） | 安全性を自動評価。読み取り操作や安全なローカル作業は自動実行し、破壊的操作や認証情報アクセス時は確認を要求する。 | 開発者；パワーユーザーの日常業務；利便性と安全性の両立 |
| Always Allow | 確認ダイアログを一切挟まず、すべてのツール呼び出しを即座に自動実行する。 | サンドボックス検証環境；高度に自動化された特定ワークフロー |
Autoモードの自動審査基準
Raycastの Auto モードは以下のロジックで安全性を判断します：
- 確認なしで自動実行: 読み取り専用のクエリ（チケット照会、予定確認、ファイル検索など）、チャット内で指定された作業ディレクトリ内でのファイル編集、安全な日常的開発コマンド（
git status、git diff、npm testなど）。 - 必ず一時停止して確認を要求: 破壊的変更を伴う操作（ファイル削除、DBレコード削除、チケットクローズなど）、システム設定を変更するシェルスクリプト、機密情報へのアクセス試行（
.envファイル、SSH秘密鍵、クラウド認証情報など）。
さらに Settings → AI → Tools の Auto-review Rules を使うことで、特定のアクションに対して「自動許可」または「毎回確認」を自然言語ルールで細かく調整できます。
ツール承認の操作とショートカット
ツール呼び出しが承認待ちになった際、チャットは一時停止し、内容を説明するカードが表示されます：
Returnキー: 1回だけ許可（Allow）。今回の呼び出しのみを実行します。⌘ Returnキー: 常に許可（Always Allow）。対象ツールが Globally Allowed Tools リストに登録され、次回以降の確認が省略されます。Escキー: 拒否（Deny）。AIに実行拒否が伝えられ、ツールを使わずに会話を継続します。@terminal経由のシェルスクリプトの場合、Show Command をクリックして実行直前の生コマンドを確認できます。
チャットごとの権限オーバーライド
特定の作業セッションだけで安全基準を変更したい場合、グローバル設定を変える必要はありません。AI Chat画面右側のサイドバーにある Permissions（または ⌘ K から Change Permissions…）を開くことで、該当チャットのみを Inherited（グローバル継承）、Ask、Auto、Always Allow に切り替えられます。
5. 拡張機能ごとのカスタム指示（Custom Instructions）による最適化
LinearやGitHubなどのツールを使用する際、モデルはチーム固有のルールやデフォルト設定を把握していません。Raycastでは、拡張機能ごとに専用の指示文を定義できます：
- Raycast Settings → Extensions を開きます。
- 左側の拡張機能一覧から対象（例: Linear や Calendar）を選択します。
- 右側パネルに表示されるコマンド一覧の中から、拡張機能が提供する Ask ツールを探します。
- Custom Instructions テキスト入力欄を見つけます。
- モデルが該当ツールの使用を検討する際に常に適用すべき指示を記述します。
実践的なカスタム指示の例
Linear向け設定例:
チケットの検索および新規作成は、原則として「Platform Engineering」チームを対象としてください。優先度が指定されていない新規チケットは「Medium」とし、現在アクティブなCycleに紐付けてください。
Calendar向け設定例:
午前10:00より前、または午後17:30以降の時間帯にミーティングを設定・提案しないでください。連続する予定の間には、必ず15分以上のバッファ時間を確保してください。
GitHub向け設定例:
Pull Requestの検索対象は「octocorp-dev」オーガニゼーション配下のレポジトリに限定してください。自分宛てのレビュー待ち一覧を作成する際は、dependabotによる自動PRを除外してください。
この設定を行っておくことで、チャットで @linear や @calendar を呼び出すたびに指示内容がモデルの文脈へ自動注入され、毎回条件を手動入力する手間が省けます。
6. さらなる拡張：Model Context Protocol (MCP) の連携
公式ストアの拡張機能だけではカバーできない社内データベース、ローカルのマイクロサービス、プライベートな開発環境が存在する場合、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: ローカルプロセスの実行バイナリと引数（例:
npx -y @modelcontextprotocol/server-postgresやローカルのPython実行コマンド）。 - Environment: データベース接続文字列やAPIトークンなどの環境変数を入力。
- Name & Icon: チャット内で
⌘ Returnで保存すると、Raycastがバックグラウンドでプロセスを起動し、JSON-RPC経由でツールのスキーマを自動取得します。
接続が完了すると、ストア拡張機能と全く同じ感覚で @postgres 先週のアクティブユーザー数を集計して といった操作が可能になり、統一された権限管理の下で安全に運用できます。
7. 生産性を最大化する運用のヒント
- グローバルショートカットの設定:
Settings → Extensions → AI → AI Chatで専用ショートカット（例:⌥ Cや⌃ Space）を割り当てておくと、どのデスクトップ画面からでも即座に対話型ツール環境を呼び出せます。 - 画面認識と選択中テキストの併用: エディタやターミナルでエラーログを選択した状態でQuick AIを立ち上げ、
@github 選択したエラー内容に一致する解決済みIssueを検索してと入力すれば、ウィンドウの切り替えやコピー＆ペーストを最小限に抑えられます。 - 許可リストの定期的な見直し:
Settings → AI → Tools → See Allow Listを定期的に確認してください。拡張機能のアップデートや運用体制の変更時には Reset All をクリックし、最新の安全基準で再審査を行うことを推奨します。
Raycast AI Toolsを適切に設定することで、macOS上のFinder、ターミナル、ブラウザ、各種クラウドSaaSが1本のキーボード操作で有機的につながり、真の自律型デスクトップ中枢が実現します。