discord-mcp-messaging

name	discord-mcp-messaging
description	Discord MCP (mcp__discord__*) でテキストチャンネル・フォーラムスレッドへメッセージを送信する手順。チャンネルIDが未指定でも「カテゴリ名+チャンネル名」「フォーラム名+スレッド名」から解決して送信する。Use When: 「discordで〜と送って」「ja カテゴリの talk に送信」「tweet フォーラムの test1 スレッドに返信」「discord にメッセージ投げて」など、Discord へのメッセージ投稿を依頼されたとき。MCPセットアップ・ログインは対象外（既にログイン済み前提）。

前提

• Discord MCP (mcp-discord) が設定済みかつ Bot がログイン済み。discord_list_servers がエラーなくサーバー一覧を返せる状態。未ログインなら本スキルの対象外。
• mcp__discord__* は deferred tool。呼ぶ前に ToolSearch で schema をロードする。していないと InputValidationError で失敗する。

手順

Step 1. 必要なツールをロード

最初に呼びそうなものをまとめて 1 回でロードする（並列より 1 回でまとめた方が安い）。

ToolSearch({ query: "select:mcp__discord__discord_list_servers,mcp__discord__discord_get_server_info,mcp__discord__discord_send,mcp__discord__discord_list_forum_threads,mcp__discord__discord_reply_to_forum,mcp__discord__discord_create_forum_post", max_results: 10 })

追加で必要になったら都度 select:... で読み足す。

Step 2. 送信先の解決

ユーザー指示の形式で分岐する。

指示の形式	解決方法
channelId を直接渡された	そのまま使う。Step 3 へ
「サーバー名 X の Y チャンネル」	discord_list_servers → 該当 guild の id → discord_get_server_info(guildId)
「カテゴリ A の B チャンネル」	discord_get_server_info で categories.details.text から name === "B" && categoryId === (categoryで name === "A" の id) を 1 件選ぶ
「フォーラム F の スレッド T」	discord_get_server_info で forum id を特定 → discord_list_forum_threads(forumChannelId) で name === "T" の thread id

重要 (Gotcha): 多言語サーバ等では同名チャンネルが複数カテゴリに存在する（例: ja/talk, en/talk, zh-TW/talk）。name だけで決め打ちせず、必ず categoryId で絞る。1 件に絞れない場合はユーザーに確認する。

サーバーが 1 つしかない場合は discord_list_servers をスキップして直接 guildId を使ってよい（ただし初回のみ確認しておくと安全）。

Step 3. 送信

送信先の チャンネル種別 で使うツールが異なる。

種別	ツール	必須引数
テキストチャンネル (GuildText)	discord_send	channelId, message
フォーラムスレッド（既存スレッドへ返信）	discord_reply_to_forum	threadId, message
フォーラム（新規ポスト作成）	discord_create_forum_post	forumChannelId, title, content

やってはいけない:

• フォーラムチャンネル ID を discord_send に渡す → 失敗する。フォーラムへの投稿は新規ポスト作成 (discord_create_forum_post) または既存スレッドへの返信 (discord_reply_to_forum) のいずれか。
• フォーラム内のスレッド ID を discord_send に渡すのも避ける（discord_reply_to_forum を使う）。

Step 4. 結果確認

各ツールは成功時に message ID もしくは確認文字列を返す。失敗時はエラー文字列を返すので、エラーが返ったらユーザーに原因を伝えて止まる（リトライしない）。

特に Discord client not logged in. が返った場合はセットアップ問題。本スキルの範囲外なのでユーザーに報告する。

Gotchas

• 同名チャンネル問題: 多言語 Discord サーバでは talk などの同名 text channel がカテゴリごとに存在する。categoryId を必ず併用して一意化する。
• フォーラム ≠ テキストチャンネル: GuildForum 型のチャンネルに discord_send は通らない。スレッドを介して投稿する。
• deferred tool: mcp__discord__* は schema 未ロード状態では呼べない。Step 1 を飛ばして直接呼ぶと InputValidationError。
• discord_get_server_info のレスポンスは大きい: text/voice/category/forum 全列挙される。チャンネル数の多いサーバでは応答が長いので、結果を変数に取って必要箇所だけ参照する形でメモリにとどめる。
• 同じ会話内で繰り返し送る場合: 一度解決した channelId / threadId は会話コンテキストに残しておき、再度の discord_get_server_info を避ける。