静觅
·
Discord Agent Proxy 使用文档
内容提要
Discord Agent Proxy 是一个独立部署服务，用于保管用户Discord账号凭据，并通过MCP和REST API接口让AI或程序操作Discord。部署时需获取账号凭据和访问令牌，支持发送消息、读取频道、管理服务器等工具。注意：自动化操作个人账号违反Discord条款，有封号风险，建议使用小号并控制频率。
延伸解读
凭据安全与风险提示
本服务需要你提供 Discord 账号的 authorization 凭据，这等同于账号的登录态。一旦泄露，他人即可完全控制你的账号。文章强调，自动化操作个人账号违反 Discord 服务条款，存在封号风险，建议使用专用小号并控制操作频率。务必妥善保管凭据，若泄露，可通过修改密码使其失效。
鉴权方式与常见错误
服务仅支持请求头鉴权，即 `Authorization: Bearer <令牌>`，不支持 URL 参数传递。直接在浏览器中访问接口会返回 401，这是正常现象。若返回 503，说明服务尚未连上 Discord，可检查 `/health` 接口的 `gateway_ready` 字段；若持续为 false，多为凭据无效。403/404 通常表示账号权限不足或 ID 错误，429 则触发频率限制，需按 `retry_after` 等待。
MCP 与 REST API 的适用场景
服务提供 MCP 和 REST API 两种调用方式。MCP 适合集成到 AI 客户端（如 Claude Code、Cursor），通过自然语言指令操作 Discord，适合交互式任务。REST API 则适合程序化调用，接口路径清晰，返回统一格式，便于自动化脚本集成。选择哪种方式取决于你的使用场景：需要 AI 理解指令用 MCP，需要精确控制用 REST。
Q&A
Discord Agent Proxy 是什么？
Discord Agent Proxy 是一个独立部署的服务，它保管你的 Discord 账号凭据，与 Discord 保持常驻连接，并通过 MCP 和 REST API 接口让 AI 或程序代替你操作 Discord。
如何获取 Discord 账号凭据？
在电脑浏览器中登录 Discord，按 F12 打开开发者工具，切换到 Network 面板，点击任意频道，在请求列表中找到发往 discord.com/api 的请求，在 Request Headers 中找到 authorization 字段，复制其值即可。
Discord Agent Proxy 支持哪些调用方式？
支持 MCP 和 REST API 两种调用方式。MCP 用于 AI 客户端（如 Claude Code、Cursor），REST API 用于程序直接调用。
使用 Discord Agent Proxy 有哪些风险？
使用程序自动化操作个人账号（self-bot）违反 Discord 服务条款，账号存在被封禁的风险。建议使用专门的小号，并控制操作频率，避免群发等敏感行为。
如何检查 Discord Agent Proxy 服务是否正常？
访问 /health 接口（无需鉴权），正常返回 {"status": "ok", "gateway_ready": true}。gateway_ready 为 true 表示连接正常，false 表示未连上 Discord，其他接口会返回 503。
Discord Agent Proxy 提供哪些主要工具？
提供发送消息、读取频道消息、编辑/删除消息、搜索消息、添加表情回应、置顶消息、创建私聊、发送私信、列出服务器/频道/成员、创建文字频道、查看当前账号等工具。
如何获取频道 ID 和用户 ID？
在 Discord 客户端中开启开发者模式（用户设置 → 高级设置），然后右键点击频道或用户，选择“复制 ID”。也可以通过调用 GET /api/guilds 和 GET /api/guilds/{guild_id}/channels 来枚举。
调用接口时返回 401、503、403、404、429 分别代表什么？
401 表示访问令牌不正确或未通过请求头传递；503 表示与 Discord 连接未建立；403/404 表示账号权限不足或 ID 错误；429 表示触发频率限制，需降低调用频率。
