Discord

最終更新 2026/10/07

1. 前提条件

• Discordアカウントを持ち、アプリケーションを作成する権限があること
• Agentic Engineプラットフォームの管理者権限
• Botを追加するための既存のDiscordサーバー（Server）

2. Discord Botを作成して認証情報を取得する

Discord Developer Portalにアクセスし、次の手順で操作します：

1. 「New Application」をクリックし、アプリケーション名を入力して作成します
2. アプリケーションの詳細に進み、左側のナビゲーションで「Bot」タブに切り替えます
3. Botページで「Reset Token」をクリックしてBot Tokenを生成し、コピーして保存します（Tokenは一度しか表示されないため、すぐに保存してください）
4. Botページで、次のPrivileged Gateway Intentsの権限スイッチをオンにします：

権限名	必須かどうか	説明
Message Content Intent	必ずオン	Botがメッセージ本文の内容を読み取ることを許可します
Server Members Intent	必要に応じて	サーバーのメンバー情報を取得します
Presence Intent	必要に応じて	ユーザーのオンライン状態を取得します

ヒント

Message Content Intentは必ずオンにしてください。オンにしないと、Botがユーザーのメッセージ内容を読み取れず、正常に動作しません。

1. ユーザーのOAuth連携に対応する場合は、左側の「OAuth2」→「General」ページで Client ID と Client Secret を控え、コールバックアドレスを「Redirects」に追加します：
   https://<your-domain>/api/discord-oauth/callback

ヒント

Bot TokenにはBotのすべての操作権限があります。コードリポジトリにコミットしたり、他人に漏らしたりしないでください。Tokenが誤って漏洩した場合は、すぐにDiscord Developer PortalでTokenをリセットし、プラットフォームの設定を更新してください。

3. プラットフォームでDiscordチャネルを追加する

管理者がAgentic Engineにログインし、「システム管理」→「チャンネル管理」に進みます：

1. 「新規チャンネル」をクリックし、チャンネルタイプで Discord を選択します
2. 次の構成項目を入力します：

構成項目	必須	説明
チャンネル名	必須	表示名。例：「Discordサーバー」
Bot Token	必須	Discord Botのアクセストークン。WebSocket Gatewayへの接続とメッセージの送信に使用します
Client ID	任意	DiscordアプリケーションのClient ID。OAuthによるユーザー連携のフローでのみ使用します
Client Secret	任意	DiscordアプリケーションのClient Secret。OAuthによるユーザー連携のフローでのみ使用します
デフォルトモデル	任意	入力しない場合は、システムのデフォルトモデルを使用します
チャネル入力の追加説明	任意	チャネル入力の各ターンに追加する説明として使われ、Agent自身のシステムプロンプトを置き換えるものではありません

警告

注意：同じ企業で複数のDiscordチャネルインスタンスを設定できますが、同じBotのアイデンティティを同じ実行環境で重複して設定することはできません。

4. ユーザーがDiscordアカウントを連携する

管理者がチャネル設定でClient IDとClient Secretを入力している場合、一般ユーザーは「チャネル連携」で自分のDiscordアカウントを連携できます：

1. ユーザーメニューを開いて「チャネル連携」に進み、対象のDiscordチャネルインスタンスを見つけて「連携」をクリックします
2. DiscordのOAuth認証ページに移動するので、Discordアカウントにログインして「認証」をクリックします
3. 認証に成功すると自動的にプラットフォームに戻り、連携ステータスが「連携済み」に変わります

連携が完了すると、ユーザーがDiscordでBotに送信したメッセージがプラットフォームのアカウントに関連付けられます。連携を解除するには、「チャネル連携」で該当するインスタンスを見つけて連携を解除します。

5. よくある質問

チャネルのステータス異常 / Botが接続できない

• Bot Tokenが有効か（リセットされていないか）確認します
• Botが対象のDiscordサーバーに正常に招待されていることを確認します
• Developer PortalでMessage Content Intentがオンになっていることを確認します

OAuthコールバックに失敗する

• コールバックアドレスがDiscordアプリケーションの「OAuth2 → Redirects」のホワイトリストに追加されていることを確認します
• コールバックアドレスは、プロトコル（https）とパスを含め、プラットフォームの実際のデプロイ先ドメインと完全に一致している必要があります

ユーザーがDiscordアカウントを連携できない

• チャネル設定でClient IDとClient Secretが入力されていることを確認します（どちらかが欠けているとOAuth連携は使用できません）
• OAuthのコールバックアドレスが正しく設定されていることを確認します

Botがメッセージを受信できない

• Message Content Intentがオンになっていることを確認します。オンになっていないと、Botはメッセージ内容を取得できません
• Botが対象のチャンネルで「Read Messages」と「Send Messages」の権限を持っていることを確認します

---

関連ページと次のステップ

• 他のプラットフォームの接続手順を確認する：チャンネル管理。
• チャネル接続と連携の全体的な流れを確認する：チャネルの概要と連携。
• 使用するAgentを設定する：Agent。
• プラットフォーム内での会話の使い方を確認する：会話。