Subo

Subo MCP 服务

通过向 AI 应用提出请求，管理 Discord 社区的表单、问卷、投票和测验。描述你想向成员提出的问题，AI 应用就会在 Subo 中创建项目、检查脚本并发布。 你无需打开控制面板。

Subo 可在 Discord 和 Web 上原生运行对话式问卷、表单、测验和投票。MCP（Model Context Protocol）是 AI 应用用于连接外部工具的开放标准。 此存储库包含托管式 Subo MCP 服务的目录条目。服务本身运行在 Subo 的基础设施上，因此无需安装或自行托管。

• 端点： https://api.subo.ai/mcp（可流式传输的 HTTP）
• 身份验证： 使用 OAuth 登录（无需复制密钥），或发送 Authorization: Bearer sbo_live_… 并附上 Subo API 密钥
• 设置指南： https://subo.gg/blog/connect-discord-community-to-ai-agent/
• 注册表名称： 官方 MCP Registry 上的 gg.subo/survey-bot

AI 应用可以做什么

44 项操作，涵盖 Subo API 几乎所有功能，可在一个社区中使用：

• 创建、编辑、克隆、验证、开启、关闭和删除项目（问卷和投票）
• 逐块编写和编辑项目脚本
• 查看回复和 AI 分析
• 管理成员的 XP 和成就
• 浏览和克隆模板
• 管理 Webhook
• 查看和更改社区设置

明确禁止的操作

• 创建、轮换或删除 API 密钥
• 更改有权访问社区的人员
• 连接新的已验证受众来源（此操作需要有人登录）

每项操作都有标记

每项操作都带有四种标记之一，供 AI 应用读取：只读、常规更改、对外操作（会触达真实用户，例如发布项目或授予成员可见的 XP），或破坏性操作（会删除内容）。表现良好的 AI 应用会在执行对外操作和破坏性操作前征求你的同意。无论 Agent 如何操作，Subo 也会强制执行自己的规则：尚未关闭的项目根本无法通过 API 删除。

连接服务

连接需要在社区中拥有 Admin 角色。你可以选择授予连接 Admin 或 Creator 权限，因此可以限制 Agent 的权限范围，使其小于你自己的权限。

使用 OAuth 登录（claude.ai、Claude Desktop、Claude Code 和其他支持 OAuth 的应用）

无需创建或粘贴 API 密钥。

1. 添加服务。 在 claude.ai 或 Claude Desktop 中，打开 Settings → Connectors → Add custom connector，然后输入 https://api.subo.ai/mcp。在 Claude Code 中，在终端运行以下命令，然后 重启 Claude Code：

   claude mcp add --transport http --scope user subo https://api.subo.ai/mcp
   

2. 登录。 点击 Connect（在 Claude Code 中，输入 /mcp 并选择 subo 进行身份验证）。 浏览器会打开 Subo：使用 Discord 登录，选择社区，再选择 Admin 或 Creator 权限并批准。

3. 检查连接。 请 AI 应用列出你的 Subo 项目。在 Claude Code 中，/mcp 应显示 subo 已连接。

此连接会显示在 Subo Web 应用的账户页面 (https://app.subo.gg/app/account) 的 API Access 下，并标记为“Connected through OAuth”。你可以随时在此撤销连接。连续 90 天未使用的连接会要求你重新登录。

使用 API 密钥（适用于任何可以发送自定义标头的应用）

1. 创建密钥。 在账户页面（https://app.subo.gg/app/account）中，前往 API Access 并创建密钥。在“This key represents”下，选择 Bot or agent，并选择其访问级别。确认面板会显示已填入密钥的配置。

2. 添加连接。 Claude Code（在终端中运行，不要在聊天中运行，然后重启 Claude Code）：

   claude mcp add --transport http --scope user subo https://api.subo.ai/mcp --header "Authorization: Bearer sbo_live_…"
   

   其他 AI 应用：添加一个带自定义标头的远程（HTTP）服务。配置通常如下所示，不过文件位置和外层键的名称因应用而异：

   {
     "mcpServers": {
       "subo": {
         "type": "http",
         "url": "https://api.subo.ai/mcp",
         "headers": { "Authorization": "Bearer sbo_live_…" }
       }
     }
   }
   

3. 检查连接。 在 Claude Code 中输入 /mcp：subo 应显示为已连接，并提供 44 个工具。

我们已在 claude.ai、Claude Code 和 Grok Bot 中测试 Subo。完整操作指南（包括密钥安全和故障排查）见 https://subo.gg/blog/connect-discord-community-to-ai-agent/。

确保连接安全

无论采用哪种连接方式，一个连接对应一个社区，并以其所有者当前拥有的访问权限进行操作。使用 OAuth 时，你无需处理密钥。使用 API 密钥时，请将其保存在 AI 应用的配置文件中，切勿放入聊天、文档或屏幕截图中。无论采用哪种方式，如果不再信任某个连接，请在账户页面撤销该连接。

套餐

所有可以创建 API 密钥的套餐都包含 MCP 服务，无需额外购买或启用。请求共用套餐的 Public API 速率限制。请参阅 https://subo.gg/pricing/。

更多信息

• 公告：https://subo.gg/blog/subo-mcp-server/
• API 快速入门和示例：https://subo.gg/api/
• 面向 AI Agent：https://subo.gg/llms.txt
• 支持：https://subo.gg/support/