Discord

AI Agent を Discord に接続する方法は 2 つあります。

1. あなたの Discord サーバーに追加：おすすめのワンクリックの手順です。Developer Portal も Bot トークンも不要で、1 分もかからず稼働できます。
2. 独自の Discord アプリを使う：自分で Discord アプリケーションを作成し、Bot トークンを用意する高度な手順です。

ワンクリックの手順をおすすめします。高度な機能が必要になった場合は、あとから自分のアプリに切り替えられます。

Quickchat AI をはじめて使いますか？まず 無料アカウントを作成 してから、このページに戻ってください。Quickchat AI for Discord でも詳しく紹介しています。

Discord に接続（推奨）

Quickchat AI ダッシュボードの左サイドバーで 外部アプリ を開き、Discord を見つけて開きます。Connect で、AI Agent の名前が入力された 新しいサーバーでのボット名 を確認します。名前は変更でき、空欄にすると Quickchat AI が使われます。その後、あなたの Discord サーバーに追加 をクリックします。対象サーバーで Manage Server 権限が必要です。

共有の Quickchat AI アプリを認可するため、Discord にリダイレクトされます。追加したいサーバーを選び、認可を確定します。ボットが一度だけ案内メッセージ “Ready! @mention me or use /ask to chat. Powered by Quickchat AI.” を投稿する前に、Quickchat が選択した名前を適用します。その後 Quickchat AI に戻ります。

次に表示される内容は、セットアップの進捗によって異なります。新規アカウントのセットアップがまだ完了していない場合、Quickchat は接続したサーバーを確認し、ウェブサイトをナレッジベースに追加するよう案内します。ウェブサイトを追加して通常のセットアップを続けるか、今はスキップ をクリックして プランを選択 のステップに直接進みます。プランのステップが終わると、AI Preview でセットアップが完了します。セットアップがすでに完了している場合はダッシュボードに戻り、サーバーが接続済みと表示されます。

この時点で認可は完了しています。🎉 Discord で AI Agent が稼働中です。 メンバーはチャンネルで @メンション して会話を開始でき、Bot はチャンネルまたはスレッドで返信します。

Discord のすべての会話は Quickchat AI の受信トレイに表示されます。AI Agent が会話をチームメンバーに引き継ぐと、そのメンバーは受信トレイで対応を引き継ぎ、同じ Discord チャンネル、スレッド、または DM に直接返信できます。

Quickchat AI に新しく登録した方には、この手順に直接進める Discord ブランドのセットアップが表示されるため、オンボーディング中に最初のサーバーをすでに接続している場合があります。

メンバーがボットに話しかける方法

ボットはチャンネル内のすべてのメッセージに返信するわけではありません。 返信するのは、@メンションされたとき、誰かが /ask コマンドを使ったとき、誰かがボットの投稿に返信したとき、そしてボット自身が作成したスレッド内です。それ以外は意図的に無視し、活発なサーバーでも邪魔にならないようにしています。

このことはメンバーにも伝えておく価値があります。普通のメッセージに返事がないと、話しかけられるのを待っているボットではなく、壊れたボットに見えてしまうためです。

/ask のほうが見つけやすいことが多く、どのチャンネルでも / を入力すると一覧に “Ask the Quickchat AI agent a question” と表示され、メッセージ内容が制限されている場所でも動作します。ワンクリックのボットでのみ利用できるため、独自の Discord アプリを使う場合は @メンションを使ってください。

メッセージ上限

すべての返信は言語モデルによって生成され、プランの AI メッセージ上限に計上されます。利用の多いサーバーでは無料枠をすぐ使い切り、上限に達するとボットは返信の代わりにその旨をチャンネルに伝えます。上限は毎月リセットされます。

サーバーの管理

Discord ページの 接続済みのサーバー に、共有ボットが稼働しているすべてのサーバーが一覧表示されます。ここから次のことができます。

• ボット名は後から変更できます。このサーバーでのボット名 に 32 文字以内で入力し、適用 をクリックしてください。空欄にして 適用 をクリックすると、共有名の Quickchat AI に戻ります。
• 別のサーバーに追加：同じワンクリックの手順を使います。認可前に 新しいサーバーでのボット名 を確認できるため、1 つの AI Agent がサーバーごとに異なる名前を使えます。
• サーバーからボットを 削除：ボットはそのサーバーから退出して返信を停止します。いつでも再度追加できます。

1 つの Discord サーバーは、同時に 1 つの AI Agent にのみ接続できます。“この Discord サーバーは、すでに別の AI Agent に接続されています” と表示された場合は、まずその Agent から削除するか、別のサーバーを選んでください。

Discord がサーバーを接続してもボット名を適用しなかった場合は、接続済みサーバーの 適用 をクリックして再試行してください。Discord から権限の問題が報告された場合は、別のサーバーに追加 をクリックし、同じサーバーを選択してもう一度認可してください。ボットを先に削除しなくても、そのまま権限が更新されます。

独自の Discord アプリを使うべきケース

ワンクリックのボットは共有の Quickchat AI アプリとアバターを使用しますが、接続したサーバーごとに異なる名前を設定できます。次のような場合は、自分の Discord アプリを設定してください（以下参照）。

• 独自のボットアバター
• ダイレクトメッセージ
• Discord AI Actions。共有ボットは、これらの Actions が必要とする {{discord_bot_token}} System Token としてトークンを公開しないため、自分のアプリが必要になります。
• 1 つのサーバーに複数のボット

共有ボットと自分のボットは並行して稼働できます。自分のアプリがサーバーを引き継ぐのは、そのサーバーから共有ボットを削除したときだけです。

独自の Discord アプリを使う（高度なセットアップ）

これは高度な手順で、10 分ほどかかります。ダッシュボードで 外部アプリ → Discord を開き、高度なセットアップ のリンクから 独自の Discord アプリを使う を開きます。自分の Discord アプリケーションを作成し、サーバーに追加して、Bot トークンで Quickchat AI に接続します。

Play

Discord サーバーを作成

統合を始めるには Discord サーバーが必要です。アカウントがない場合は discord.com で作成してください。ログイン後、こちらのガイドに従ってサーバーを作成します。

Discord アプリケーションを作成

discord.com/developers/applications にログインした状態でアクセスし、新しいアプリケーションを作成します。

Discord アプリケーションを設定

Bot をサーバーに追加する前に、アプリケーションで Message Content Intent を有効にしてください。これにより、Bot はサーバー上のユーザーが送信したメッセージを読み取ることができます。

Bot を あなたの Discord サーバーに追加

次に、Bot をサーバーに追加します。以下の Discord URL を作成してブラウザに貼り付けてください。

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

権限番号はどこから来る？

権限番号（309237713920）は、次の権限を要求することで得られます。

• View Channels
• Send Messages
• Create Public Threads
• Send Messages in Threads
• Read Message History

これは Bot が正しく動作するために必要な最小限の権限です。実際に、discord.com/developers/applications にアクセスし、アプリケーションを選択して左側の Bot をクリックし、下にスクロールすると確認できます。

自分の CLIENT ID はどこ？

最も簡単なのは、ブラウザのアドレスバーを見て、URL の一部になっている長い数字をコピーする方法です。

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

この例では client id は 1234567890123456789 なので、Bot を追加するための完全な URL は次のとおりです。

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

Discord Bot を Quickchat AI と連携

Quickchat AI と接続するには、Developer Portal で Discord Bot Token を取得します。

1. Bot Settings → Reset Token → Copy Token に移動

2. Quickchat AI ダッシュボード で 外部アプリ → Discord を開き、高度なセットアップ から 独自の Discord アプリを使う を選択し、トークンを貼り付けます。Quickchat AI はボットを起動し、起動時にそのステータスを表示します。

AI Bot がオンラインになりました！

Discord に戻ると、Bot が オンライン になりチャットの準備ができています。@メンションして会話を開始してください。🤖💬

デフォルトでは、@メンションされると Bot は同じチャンネルで返信します。これは連携の 返信モード 設定で変更できます。チャンネルで返信（デフォルト）または スレッドで返信 から選べます。スレッドで返信 にすると、Bot はスレッド内で返信し、ユーザーは Bot を再度メンションせずにそこで会話を続けられます。

Discordアクション

独自の Discord アプリを接続したら、アクションとMCP で + Add Action をクリックし、Discordアクションを選びます。サポートとモデレーションの完全なアクションをインストールできます。

• サポートとチケット: サーバーとテキストチャンネルを選択し、必要に応じてメンション可能なサポートロールを選択します。1 回のインストールで、プライベートスレッドを開き、依頼者を追加し、必要に応じてサポートに通知する 3 つの編集可能な Action が作成されます。
• モデレーション: タイムアウト、キック、BAN、BAN 解除、ロール割り当て、スローモード、アナウンス送信。各テンプレートで 1 つの編集可能な Action が作成されます。

Quickchat は各 Action のメソッド、URL、ヘッダー、body、パラメータ、説明、レスポンス処理、次の場合のみ実行の条件を backend で入力します。作成された Action は通常のエディターを使用し、すべて編集できます。

すべてのモデレーションテンプレートには、最初から author_is_admin is true 条件が含まれます。Discord が現在のメッセージ送信者についてこの値を提供し、Quickchat が Action の呼び出し前に確認します。公開チャットと API メタデータからこの値を設定することはできません。別の信頼できる認可境界を設計していない限り、この条件を維持してください。テンプレートには、確認メッセージ、replay protection、再試行処理、権限とロール階層に関する専用ポリシーは追加されません。Discord は引き続き Bot 自体の権限とロール位置を確認します。

注意

Discordアクションには、独自の Discord アプリの高度なセットアップにある Bot Token が必要です。共有のワンクリック Bot だけでは、この Token を提供できません。Discord サーバー上で管理者アカウントと管理者ではないアカウントの両方を使ってモデレーション Action をテストしてください。AI Preview では認可済みの Discord 送信者を利用できません。

Support Ticket は特別なワークフロー runtime の代わりに、メモリに保存と次の場合のみ実行を使用します。最初の Action が Discord から返されたスレッド ID を discord_ticket_thread_id として保存します。次の 2 つの Action はその値を読み取り、依頼者を追加して通知を投稿します。Agent のメインプロンプトにも同じ順序を記載してください。結果が不明な場合は、再試行する前に Discord と Action ログを確認してください。保存されたスレッド ID は自動的に消去されないため、このテンプレートで作成できるチケットは Quickchat の会話ごとに 1 件です。別のチケットには新しい Discord の会話またはスレッドを開始するか、必要なメモリのライフサイクルを追加するよう Action を編集してください。

Support Ticket では、選択したチケットチャンネルで Bot に View Channels、Send Messages、Read Message History、Create Private Threads、Send Messages in Threads、Manage Threads を付与してください。ロールへの通知は任意です。サポートロールを選択した場合は、そのロールをメンション可能にし、そのメンバーがプライベートスレッドにアクセスできるようにします。ロールを選択しない場合やメンション可能なロールがない場合も、ロールに通知せずチケットは通常どおり開かれます。選択画面にはテキストチャンネルとメンション可能なロールが表示されますが、チャンネルの権限上書きをすべて検証するわけではありません。

生成される設定と MVP の制限については、アクションを参照してください。

トラブルシューティング

Quickchat AI が Discord 連携ページでエラーを報告すると、下の該当セクションに直接リンクします。

ワンクリック接続

ワンクリックの手順でエラーが出ることはめったにありません。接続が完了しない場合は、次を確認してください。

• “この Discord サーバーは、すでに別の AI Agent に接続されています”：そのサーバーは別の Agent に割り当てられています。まずその Agent から削除するか、別のサーバーを選んでください。
• “この AI Agent に Discord を接続する権限がありません”：チャンネルの接続は editor の操作です。アカウントの admin または editor に接続を依頼し、選んだ Discord サーバーで Manage Server 権限を持っていることを確認してください。
• “Discord の認証がキャンセルされました”：完了する前に Discord の認可画面を閉じています。何も接続されていないため、あなたの Discord サーバーに追加 をクリックしてもう一度お試しください。

以下のセクションは 独自の Discord アプリを使う の手順に適用されます。

ボットはサーバーにいるのに、まったく返信しない

ほとんどの場合、まだ誰も話しかけていないだけです。ボットが応答するのは、@メンション、/ask、自分の投稿への返信、そして自分が作成したスレッド内のメッセージで、それ以外は無視します。@ でメンションして応答するか確認してください。

それでも返信しない場合は、そのチャンネルでボットのロールとチャンネルの権限の上書きが View Channel、Send Messages、Read Message History を許可しているか確認してください。

以前は返信していたのに黙ってしまった場合は、その月の AI メッセージ上限を使い切っていないか確認してください。

/ を入力しても /ask が出てこない

ボットが参加してからすべてのクライアントにコマンドが行き渡るまで、Discord では最大 1 時間かかることがあります。Discord クライアントを再起動すると早く表示されることが多いです。それまでは @ でボットをメンションしてください。

Message Content Intent

PrivilegedIntentsRequired：ボットは接続できましたが、Message Content Intent がオフのためメッセージを読み取れません。Developer Portal でアプリケーションを開き、Bot → Privileged Gateway Intents に移動して Message Content Intent をオンにし、保存してください。ボットは自動的に再起動します。1分ほどお待ちください。

無効なボットトークン

InvalidToken：Quickchat AI が保持しているトークンが間違っているか、再生成されています。ボットトークンは一度しか表示されず、リセットすると古いトークンは無効になります。Developer Portal でアプリケーションを開き、Bot に移動して Reset Token をクリックし、新しいトークンをコピーしてから、Quickchat AI で Reconnect をクリックして貼り付けてください。

Require OAuth2 Code Grant

ボット追加時に “Integration requires code grant” と表示される場合、アプリケーションで Require OAuth2 Code Grant が有効になっており、シンプルなボット招待フローがブロックされています。Developer Portal でアプリケーションを開き、Bot に移動して Require OAuth2 Code Grant をオフにして保存し、招待 URL をもう一度開いてください。

認証ページにケーキや “baked” のメッセージが表示される

その風変わりな画面は Discord の成功ページで、ボットは追加されています。確認するには、サーバーの サーバー設定 → 連携サービス → ボットとアプリ を開き、リストにボットがあるか確認してください。

セットアップ後にボットが応答しない

ボットはトークンや設定を変更するたびに再起動するので、保存後は最大 1 分ほど待ってください。それでもオンラインにならない、または応答しない場合：

1. Quickchat AI ダッシュボードで 外部アプリ → Discord を開き、接続ステータスを確認します。無効なトークンやインテントの不足は、正確な対処方法へのリンクとともにそこに表示されます。
2. Message Content Intent がオンであること（上記参照）と、トークンが最新であること（不安な場合は Reset Token）を確認します。
3. ボットがアクセスできるチャンネルで @メンションし、ロールとチャンネルの権限に Send Messages、Create Public Threads、Send Messages in Threads、Read Message History が含まれているか確認します。
4. 外部アプリ → Discord の 返信モード 設定で、チャンネルとスレッドのどちらで返信するかを選びます。

ヒント

Quickchat AI ダッシュボードの Discord 連携ページには、ワンクリックボットの 接続済みのサーバー が表示され、高度なセットアップ の下には自分のアプリの Bot Token 入力欄、返信モード セレクター（チャンネルで返信 または スレッドで返信）、そしてヘルプ用に Discord コミュニティへ参加するリンクが表示されます。

---

Quickchat AI を最大限に活用する方法について学ぶために、私たちの Discord サーバーに参加してください 👉 discord.gg/KqkHwvPRNH