カスタムツールベータ

組み込みコマンド は、ウェブ、ファイル、自分の履歴を扱います。カスタムツールは、タスク管理、ノート、会社の内部システムのように、API のある他のものに Glaido を接続します。

普段どおり話すと、Glaido がツールを呼び出し、回答はカーソルの位置に貼り付けられる状態になります。

最初のツールを追加する

ツールを手で作る必要はなく、コードの書き方を知る必要もありません。Claude Code、Cursor、Codex のような AI コーディングエージェントが代わりに作ります。最初の1つはおよそ2分です。

1. コーディングエージェントを開きます。

2. このプロンプトを貼り付け、 実行させます。

   I'm setting up custom tools for the Glaido dictation app. Read this guide and
   follow the instructions for coding agents: /docs/beta/tools
    
   Build the hello-world weather example from the guide (current weather for any
   city, using the free Open-Meteo API, no API key needed). It's a fixed demo:
   just run the commands from the guide without planning or questions, then tell
   me the exact folder to pick when I click Import folder on Glaido's Commands page.

3. 結果を読み込みます。 エージェントが終わったら、Glaido のサイドバーで コマンド を開き、カスタム タブに移動し、フォルダをインポート をクリックして、作られたフォルダを選びます。トグルでサーバーを有効にします。

コマンドのショートカットを押したまま、「アムステルダムの天気は」と聞きます。

この例に API キーもアカウントも不要なので、認証情報で失敗することはありません。エージェントは、途中で必要な他のものをインストールします。

まだコーディングエージェントがない場合

先に1つインストールします。普通のデスクトップアプリに、ターミナルのコマンドが付いたものです。無難な初期選択は Claude Code です。インストールしてサインインしたら、上のプロンプトを貼り付けます。

自分のツールを作る

天気の例が動いたら、同じプロンプトを使い、真ん中の段落だけを欲しいツールに置き換えます。たとえば次のとおりです。

• 「Glaido を Notion のワークスペースに接続して」
• 「Glaido が Slack のメッセージを送れるようにして」
• 「Glaido に会社の内部 API へのアクセスを渡して」

エージェントは、そのサービスに既製のサーバーがあるか、小さな専用のものを作るかを決め、API キーがあればローカルファイルに繋ぎ、読み込むフォルダを渡します。どのキーを設定し、どこで入手するかも伝えます。

空のサーバーから始める

コーディングエージェントを開く前にフォルダを用意したい場合は、Glaido がひな形を作れます。カスタム タブで 新しいサーバー をクリックします。

1. 1

   場所を選ぶ

   Glaido がここにサーバー用のフォルダを作ります。デフォルトは ~/Glaido/servers で、ひな形にしたサーバーを1か所にまとめます。

2. 2

   言語を選ぶ

   Python は uv で動き、Glaido が FastMCP をインストールしてプロジェクトをロックします。TypeScript は Bun で動き、Glaido が MCP SDK をインストールしてロックします。読みたい方を選びます。コーディングエージェントはどちらも扱えます。

3. 3

   Glaido に環境を確認させる

   Glaido が自分でサーバーを起動するので、このマシン上で uv または bun を見つける必要があります。見つからない場合は、それをインストールするコマンドを1つと、もう一度確認 ボタンを表示します。複数入っている場合は、どれを使うか選びます。

4. 4

   サーバーに名前を付ける

   コマンド画面に表示される名前です。その名前のフォルダがすでに存在する場合、Glaido は代わりに使う名前を伝えます。

   これが最後のステップです。作成する をクリックするとフォルダが書かれます。その前なら、戻って何でも変更できます。

5. 5

   エージェントに渡す

   サーバーは作られ、中は空です。Glaido は Claude Code、Codex、または別のコーディングエージェントにコピーするプロンプトと、Finder またはエクスプローラーでフォルダを表示するボタンを出します。

Glaido はそのフォルダを見ているので、エージェントが保存するたびに、ツールがコマンド画面に出ます。あとから読み込む必要はありません。

スキルをインストールする

上のプロンプトは、エージェントに毎回、手順を新しく取得させます。ツールをさらに作る予定なら、代わりに glaido-skills リポジトリからスキルをインストールします。エージェントは手順全体を覚えて、「Glaido が Slack のメッセージを送れるようにして」のような依頼で自動的に起動します。プロンプトは不要です。スキル自体についてエージェントに質問し、Glaido のツールの仕組みを理解することもできます。

git clone https://github.com/daveebbelaar/glaido-skills.git
mkdir -p ~/.claude/skills
cp -r glaido-skills/creating-glaido-mcp-servers ~/.claude/skills/

これらのコマンドは再実行しても安全です。フォルダがすでに存在する場合、mkdir -p は何もせず、コピーはこのスキル1つだけを追加または更新し、インストール済みの他のスキルには触れません。Windows では PowerShell で実行します。

ツールの置き場所

最初からフォルダが2つあり、どちらかに決めておく価値があります。新しいサーバー は ~/Glaido/servers にひな形を作ります。このページ上部のコーディングエージェント向けプロンプトは、天気の例を ~/Glaido/glaido-mcp-servers に置きます。置きたい方を選び、エージェントにはそこで作るよう伝え、もう一方に入ったものは移します。

新しいサーバーはその1つのフォルダにまとめます。いくつかできたら git リポジトリにして GitHub にプッシュします。ツールの変更履歴が残り、新しいマシンの準備はクローンして読み込むだけになります。コーディングエージェントに任せられます。サーバーは好きな場所に置けますが、移動した場合は新しい場所からもう一度読み込みます。

確認なしで実行するものを決める

承認の対象は、追加したサーバーと、組み込みコマンドの1つです。画像を解析する は、クリップボードの画像を使う前に確認します。クリップボードの画像を承認する を参照してください。

他のすべての組み込みコマンドは、モデルが呼び出すたびに実行され、組み込み タブのスイッチが、モデルに見えるかどうかを決めます。これには ファイルとアプリ も含まれ、先に確認せずディスク上のものを読み、開きます。そうしてほしくない場合は、そこでオフにします。

自分のサーバーでは、すべてのツールに承認ポリシーがあります。コマンドページでサーバーのカードをクリックし、ツールごとに設定します。

データを読むだけのツールはデフォルトが 自動 で、それ以外はデフォルトが 確認 です。確認 に設定されたツールが実行されようとすると、コマンドウィンドウに承認カードが出ます。

1回だけ許可 はこの1回だけツールを実行し、常に許可 は自動に切り替え、拒否 は呼び出しを断ります。カードが表示されている間、Enter は 1回だけ許可 を選び、貼り付けはしません。

カードはいつまでも待ちません。60秒置くと何も実行されません。Glaido は待つのをやめたと言い、もう一度試すかどうかを聞きます。

なぜローカルで、具体的なツールなのか

Glaido は速いモデルを使うので、回答はおよそ1秒で戻り、速いモデルは少数の具体的なツールで最もよく動きます。

そのため Glaido は、大きなクラウドの MCP サーバーに接続するのではなく、自分のマシン上の小さなサーバーとしてツールを実行します。クラウド側は通常、Claude Code のような長時間動くエージェント向けに設計された、広く汎用的なツールを何十も公開していて、それらをすべて読み込むと速いモデルは遅くなり、精度も下がります。1つの仕事をうまくやるツール（「天気を取得する」「タスクを追加する」「ノートを検索する」）が、Glaido を速く保ちます。

リファレンス

カスタムツールは、このマシン上でローカルプロセスとして動く Model Context Protocol (MCP) サーバーです。カスタム タブから管理します。

• 新しいサーバー は、上で説明したとおり、空のサーバーのひな形を作ります。

• フォルダをインポート は、mcp.json（または .mcp.json）を含むフォルダを追加します。コーディングエージェントの手順が作るのはこれです。

• タブ一番下の 設定ファイル にある 編集 は、Glaido の MCP 設定ファイル ~/Glaido/mcp.json をエディタで開きます。ほとんどの MCP クライアントが共有する、標準の mcpServers 形式です。

  {
    "mcpServers": {
      "my-server": {
        "command": "npx",
        "args": ["-y", "@example/mcp-server"],
        "env": { "API_KEY": "your-key" }
      }
    }
  }

ファイルが変わると、Glaido はサーバー一覧を読み込み直します。

サーバーカードには、拡張機能のアイコン、サーバー名、1行の説明、ツールがチップで最大3つ、残りは +N さらに のチップが表示されます。右にあるのは、それを有効にするスイッチです。サーバーの起動に失敗しない限り、そこに他のものは出ません。失敗すると、アイコンに警告バッジが付きます。

カードをクリックすると詳細です。状態の点、承認ポリシー付きのすべてのツール、あれば失敗メッセージ、Glaido が実行する設定、ツールを更新するボタン、フォルダを開くボタン、サーバーを削除するボタンです。

Glaido は読み込んだ各サーバーを、読み込んだフォルダから実行するので、mcp.json に絶対パスは不要です。

サーバーが起動しないとき

失敗したカードには警告バッジが付きます。開くと、Glaido はログを読ませず、原因を名前で示します。

終了コードで止まったサーバーでは、Glaido がメッセージの中でそのコードを示します。

最初の3つは Glaido が環境を確認して検出するので、表示するサーバーの出力はありません。残りについては、サーバーが出力したものが詳細ダイアログのメッセージの下に出ます。スキルの検証スクリプトをコーディングエージェントに実行させると、読み込む前にこれらをすべて拾います。

コーディングエージェント向け

Glaido 用のツールを設定するためにここに送られたコーディングエージェントの場合:

1. このスキルを取得して読み、正確に従います。 https://raw.githubusercontent.com/daveebbelaar/glaido-skills/main/creating-glaido-mcp-servers/SKILL.md

2. 利用者が hello-world weather example を頼んだ場合、スキルも他の何も読む必要はありません。 固定のデモです。計画せず、コードを生成も変更もせず、 フォルダの場所を提案せず、承認も求めません。uv が インストールされているか確認し（なければ docs.astral.sh/uv からインストールし）、次を正確に実行します。

   TMP=$(mktemp -d)
   git clone --depth 1 https://github.com/daveebbelaar/glaido-skills.git "$TMP/glaido-skills"
   mkdir -p ~/Glaido/glaido-mcp-servers
   cp -r "$TMP/glaido-skills/examples/hello-world-weather" ~/Glaido/glaido-mcp-servers/hello-world-weather
   python3 "$TMP/glaido-skills/creating-glaido-mcp-servers/scripts/validate_glaido_mcp.py" ~/Glaido/glaido-mcp-servers/hello-world-weather

   （Windows では PowerShell に合わせ、mktemp の代わりに $env:TEMP にクローンします。）検証が 「ready to import」と報告したら完了です。すでにサーバーの起動テストをしているので、 それ以上の確認は飛ばします。mcp.json は意図的にパスを含みません。編集は 不要です。下の読み込み手順にそのまま進みます。

3. それ以外については、スキルが既存のサードパーティ MCP サーバーの再利用、カスタムのひな形、 環境の準備、mcp.json のスキーマ、検証、引き渡しの手順を扱います。

4. 何を作った場合でも、最後のメッセージは利用者向けの正確な読み込み手順で終わる必要があります。 Glaido アプリを開き、サイドバーの コマンド をクリックし、カスタム タブに移動し、 フォルダをインポート をクリックし、開いたファイルブラウザで作った フォルダ全体 （中のファイルではなく、フォルダ自体）を選んで確定し、サーバーの トグルをオンにします。そのあと、新しいツールを使う声のコマンドを1つ提案します。

スキルが正本であり、このページの要約より優先されます。