Groove MCP by usefulapi

usefulapi 提供的 Groove MCP

在 Claude、Cursor 或任何 MCP 客户端中管理 Groove 支持对话 —— 查看共享收件箱中的对话、联系人、客服人员、渠道、标签、文件夹和团队，并关闭、开启、 暂停、加星标、分配或标记对话。托管服务，无需本地安装：使用你的 Groove API 令牌连接。

在线端点： https://groove-hq.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://groove-hq.usefulapi.io/mcp。
• Claude Code： 运行 claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将该 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "groove-hq": {
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Groove 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/groove-hq/

首次连接时，你需要粘贴 Groove API 令牌（Groove → Settings → API）。 系统会验证令牌，并按用户存储，且仅限你本人使用 — 配置文件中不会存放密钥。

工具

工具	类型	功能
groove_list_conversations	read	列出对话
groove_get_conversation	read	获取对话
groove_list_contacts	read	列出联系人
groove_get_contact	read	获取联系人
groove_list_agents	read	列出客服人员
groove_list_channels	read	列出渠道
groove_list_tags	read	列出标签
groove_list_folders	read	列出文件夹
groove_list_teams	read	列出团队
groove_close_conversation	write	关闭对话
groove_open_conversation	write	开启对话
groove_snooze_conversation	write	暂停对话
groove_star_conversation	write	为对话加星标
groove_assign_conversation	write	分配对话
groove_tag_conversation	write	为对话添加标签
groove_untag_conversation	write	移除对话标签
groove_usage_status	meta	使用情况（免费套餐用量）
groove_request_feature	meta	请求添加缺失功能
groove_upgrade	meta	升级到 Pro（无限使用*）
groove_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先征求确认）；meta 工具用于报告用量、管理订阅或提交功能请求。

定价

套餐	价格	限额
Free	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限使用*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 groove_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 groove_cancel_subscription 取消：Pro 服务将持续到付费期结束，当前付费期不予退款；在此之前运行 groove_upgrade 可撤销取消操作。也可以发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管方提供。