MCP ツールをスラッシュコマンドとして呼び出す

症状・対象

MCP server は追加したが、接続状態、tool 名、prompt の呼び方、権限のどこで止まっているか分からない人が対象です。まず接続済み server を一つ選び、読み取り tool だけを実行します。

最短解決

1. claude mcp list と /mcp で server が connected か確認する。
2. /mcp に表示された tool または prompt の正確な名前を使う。
3. 読み取り tool を一度実行し、必要ならその個別 tool だけを allow する。

コピペ例

claude mcp list

セッション内で詳細を確認します。

> /mcp

接続済み server に get_issue という読み取り tool が表示された場合の依頼例です。github と get_issue は、実際に表示された名前へ置き換えてください。

> mcp__github__get_issue を使って Issue 123 を読み、
> title、state、acceptance criteria だけを返して。更新はしないで。

個別 tool の自動許可が必要な場合は .claude/settings.json の既存 permissions へマージします。

{
  "permissions": {
    "allow": [
      "mcp__github__get_issue"
    ]
  }
}

期待結果

• claude mcp list に server 名と接続状態が表示される。
• 読み取り tool が一度だけ呼ばれ、指定した項目だけ返る。
• 書き込み tool は許可していないため、自動実行されない。

検証

/mcp で tool call 後も server が connected であることを確認します。HTTP server の場合は、失敗時に表示される status と URL を確認し、認証・接続・tool 権限を分けて切り分けます。

権限は次で確認します。

> /permissions

落とし穴

• MCP tool はモデルが呼ぶ機能です。server が公開する prompt だけが slash command として表示される場合があり、両者を混同しません。
• 記事にある古い package 名をそのまま install せず、利用する server の現行手順を確認します。
• mcp__github__* のような allow ワイルドカードに頼りません。server 全体または完全な tool 名を使います。
• token を JSON へ直書きしません。環境変数や OAuth を使い、ログにも出さないようにします。

次の一手

• MCP サーバーガイド — scope、transport、認証を設定する
• パーミッションモードを使い分ける — 書き込み tool の確認境界を作る