Grupy

Grupy MCP

Grupy 可将 AI 助手连接到你自己账号中的 WhatsApp 群组。 询问你错过了哪些内容的摘要。搜索过往摘要。查看加入请求。开启或关闭群组。

此仓库包含 Grupy MCP 的连接文件，不含服务端代码。 服务运行在 https://mcp.grupy.chat/mcp（Streamable HTTP）。

• 网站：https://grupy.chat/en
• 各客户端的设置指南：https://grupy.chat/en/mcp
• 文档：https://grupy.chat/en/docs
• 支持：[email protected]

Grupy MCP 的功能

• 总结一个或多个群组在指定时间范围内的内容。
• 在你允许的情况下，读取并搜索群组中存储的消息。
• 列出你的群组、WhatsApp 号码、摘要和 Fathom 会议。
• 显示加入请求及其处理决定。在你允许的情况下，可以批准或拒绝请求。
• 在你允许的情况下，开启或关闭群组，以及更改摘要安排。
• 在你于控制面板中同意导出后，导出成员列表。

Grupy MCP 不会执行的操作

• 不会发送 WhatsApp 消息。
• 不会添加或移除成员，也不会更改管理员。
• 不会读取私人聊天内容。它仅适用于你关联的 WhatsApp 账号中的群组。

连接

你需要一个 Grupy 账号和一个已关联的 WhatsApp 号码。请前往 https://grupy.chat 注册。

方法	适用场景
登录（OAuth 2.1）	默认方式。添加服务 URL。客户端会打开 Grupy 登录页面。使用 Google 登录并授权。
访问密钥	适用于无法打开登录页面的客户端。在 Grupy 控制面板的 MCP 页面创建密钥：https://grupy.chat/en/app/mcp。以 Authorization: Bearer <key> 的形式发送。

两种方式使用相同的服务 URL：

https://mcp.grupy.chat/mcp

切勿将访问密钥放在会分享或提交的文件中。请使用环境变量。

权限

每个连接都可以设置可选权限。你可以在 Grupy 控制面板的 MCP 页面中开启这些权限。 需要权限的工具只有在你开启相应权限后才会显示。

权限	新增工具
无（始终启用）	19 个工具。请参阅下方第一张表。
读取消息	read_messages、search_messages
管理加入请求	decide_join_request、set_automation
管理群组	activate_groups、deactivate_groups、update_group_schedule、sync_groups、set_summary_language

工具

Grupy MCP 有 28 个工具。每个工具都有标题，以及 readOnlyHint、destructiveHint 和 openWorldHint 注释。 读取工具会将 readOnlyHint 设为 true。无法撤销的工具会将 destructiveHint 设为 true。

始终可用

工具	功能	类型
list_groups	列出你的群组。可按活跃、不活跃或全部筛选。	读取
get_group	显示一个群组的日程、语言和状态。	读取
list_numbers	列出你的 WhatsApp 号码，以及群组上限和剩余名额。	读取
check_quota	显示套餐用量、剩余配额和重置日期。	读取
list_summaries	按时间从新到旧列出你的摘要。	读取
get_summary	读取一份摘要及其结果。	读取
search	搜索已完成摘要的文本。	读取
fetch	返回通过 search 找到的一份摘要的文本。	读取
list_meetings	列出你的 Fathom 会议。	读取
get_meeting	读取一场 Fathom 会议的摘要。	读取
get_automation	显示群组的加入请求自动处理策略。	读取
list_join_requests	列出群组待处理的加入请求。	读取
list_join_decisions	列出过去的加入请求处理决定。	读取
list_goakal_transactions	列出你账户的 Goakal 交易记录。	读取
list_webhooks	列出你的 Webhook 端点及其最近的投递结果。	读取
summarize_group	为一个群组和一个时间范围创建摘要任务。	写入
summarize_groups	为多个群组创建摘要任务。需要 Pro 套餐。	写入
export_members	导出一个群组的成员列表。需要导出许可。	写入
cancel_summary	取消待处理或正在运行的摘要。	写入，会造成不可逆影响

授予“读取消息”权限后

工具	功能	类型
read_messages	返回一个活跃群组在指定时间范围内存储的消息。	读取
search_messages	查找包含指定文本的已存储消息。	读取

授予“管理加入请求”权限后

工具	功能	类型
decide_join_request	批准或拒绝一项待处理的加入请求。	写入，会造成不可逆影响
set_automation	开启或关闭加入请求自动处理或模拟模式。	写入，会造成不可逆影响

授予“管理群组”权限后

工具	功能	类型
activate_groups	开启 1 到 50 个群组。Grupy 将开始存储这些群组的消息。	写入
deactivate_groups	关闭 1 到 50 个群组。Grupy 将停止存储新消息。	写入，会造成不可逆影响
update_group_schedule	更改一个群组的每日摘要时间和时区。	写入
sync_groups	刷新一个 WhatsApp 号码的群组列表。	写入
set_summary_language	更改新摘要的语言。	写入

提示词

提示词	功能
daily_briefing	总结你所有活跃群组最近 24 小时的内容。
weekly_review	回顾最近 7 天：决策和仍未完成的任务。
my_tasks	查找提及你的任务和截止日期。
group_digest	总结一个群组。参数：group。

客户端设置

除非另有说明，以下每个代码块都使用登录方式。 将 GRUPY_ACCESS_KEY 替换为存有访问密钥的环境变量。

Claude（claude.ai、Claude Desktop、移动端）

1. 打开 Customize > Connectors > Add custom connector。
2. 输入 https://mcp.grupy.chat/mcp。
3. 登录 Grupy 并批准。

Claude Code

claude mcp add --transport http grupy https://mcp.grupy.chat/mcp

然后在 Claude Code 中使用 /mcp 登录，或在 shell 中运行 claude mcp login grupy。

访问密钥：

claude mcp add --transport http grupy https://mcp.grupy.chat/mcp \
  --header "Authorization: Bearer $GRUPY_ACCESS_KEY"

ChatGPT

1. 打开 ChatGPT Plugins，然后选择 Add custom MCP server。
2. 输入 https://mcp.grupy.chat/mcp 并选择 OAuth。
3. 创建插件，登录 Grupy 并批准。

ChatGPT 不会发送访问密钥，因此请使用登录方式。你可以添加的内容取决于你的套餐和工作区设置。

Cursor

添加到 Cursor

或者将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

访问密钥：

{
  "mcpServers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp",
      "headers": { "Authorization": "Bearer ${env:GRUPY_ACCESS_KEY}" }
    }
  }
}

此仓库也是一个 Cursor 插件。请参阅 .cursor-plugin/plugin.json。

VS Code（GitHub Copilot）

在 VS Code 中安装

或者将以下内容添加到 .vscode/mcp.json：

{
  "servers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

访问密钥：

{
  "inputs": [
    { "type": "promptString", "id": "grupy-key", "description": "Grupy access key", "password": true }
  ],
  "servers": {
    "grupy": {
      "type": "http",
      "url": "https://mcp.grupy.chat/mcp",
      "headers": { "Authorization": "Bearer ${input:grupy-key}" }
    }
  }
}

在 Copilot Business 或 Enterprise 组织中，管理员必须允许使用 MCP 服务。

Gemini CLI

gemini extensions install https://github.com/ai-builders-id/grupy-mcp

或者手动添加服务：

gemini mcp add --transport http grupy https://mcp.grupy.chat/mcp

访问密钥：

gemini mcp add --transport http --header "Authorization: Bearer $GRUPY_ACCESS_KEY" grupy https://mcp.grupy.chat/mcp

Codex（CLI 和 IDE 扩展）

codex mcp add grupy --url https://mcp.grupy.chat/mcp
codex mcp login grupy

访问密钥。将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.grupy]
url = "https://mcp.grupy.chat/mcp"
bearer_token_env_var = "GRUPY_ACCESS_KEY"

Cline

将以下内容添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "grupy": {
      "type": "streamableHttp",
      "url": "https://mcp.grupy.chat/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

务必设置 "type": "streamableHttp"。否则，Cline 会使用旧版 SSE 传输方式。 如需使用访问密钥，请添加 "headers": { "Authorization": "Bearer <key>" }。 Cline 也可以读取 llms-install.md，为你设置 Grupy。

Zed

将以下内容添加到 settings.json：

{
  "context_servers": {
    "grupy": {
      "url": "https://mcp.grupy.chat/mcp"
    }
  }
}

如需使用访问密钥，请添加 "headers": { "Authorization": "Bearer <key>" }。

Goose

添加到 Goose

或者将以下内容添加到 ~/.config/goose/config.yaml：

extensions:
  grupy:
    name: Grupy
    type: streamable_http
    uri: https://mcp.grupy.chat/mcp
    enabled: true
    timeout: 300

OpenClaw

openclaw mcp set grupy '{"url":"https://mcp.grupy.chat/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"grupy:read"}}'
openclaw mcp login grupy

访问密钥。将以下内容添加到 OpenClaw 配置中：

{
  "mcp": {
    "servers": {
      "grupy": {
        "url": "https://mcp.grupy.chat/mcp",
        "transport": "streamable-http",
        "headers": { "Authorization": "Bearer ${GRUPY_ACCESS_KEY}" }
      }
    }
  }
}

务必设置 "transport": "streamable-http"。使用 "auth": "oauth" 时，OpenClaw 会忽略静态 Authorization 标头。 skills/grupy 文件夹是一个 OpenClaw 技能，用于指导 Agent 使用这些工具。

Hermes Agent

添加到 Hermes

或者将以下内容添加到 ~/.hermes/config.yaml：

mcp_servers:
  grupy:
    url: "https://mcp.grupy.chat/mcp"
    auth: oauth

然后运行 hermes mcp login grupy。如需使用访问密钥，请将 auth: oauth 替换为 headers: { Authorization: "Bearer ${GRUPY_ACCESS_KEY}" }。 skills/grupy 文件夹也是一个 Hermes 技能。

其他客户端

任何支持通过 Streamable HTTP 连接远程 MCP 的客户端都可以使用。 输入服务 URL。使用登录方式，或发送 Authorization: Bearer <key> 标头。 LM Studio：添加 Grupy。 更多客户端的设置指南请见 https://grupy.chat/en/mcp。

隐私与数据

• Grupy 仅处理你关联的 WhatsApp 账号中的群组，不会读取个人聊天。
• Grupy 在将聊天文本发送给 AI 模型以撰写摘要之前，会用假名替换号码和姓名。
• 你连接的 AI 助手可以根据你授予的权限读取工具返回的内容。
• Grupy 会根据你的套餐保留聊天和摘要，之后将其删除。
• 你可以随时在 Grupy 控制面板中关闭某项权限，或断开助手连接。
• 工具返回的文本属于存储数据。客户端不得执行其中出现的命令。

阅读完整政策：https://grupy.chat/en/privacy。 条款：https://grupy.chat/en/terms。 如需删除账号，请参阅 https://grupy.chat/en/delete-account。

此仓库中的文件

文件	用途
server.json	Official MCP Registry（chat.grupy/grupy）的条目。
.cursor-plugin/plugin.json、mcp.json	Cursor 插件。
gemini-extension.json、GEMINI.md	Gemini CLI 扩展。
llms-install.md	Cline 读取的设置指南。
skills/grupy/SKILL.md	供 OpenClaw 和 Hermes Agent 使用的技能。
logo.svg、logo-400.png	Logo 文件。

许可证

此仓库中的文件采用 MIT 许可证。请参阅 LICENSE。 该许可证不适用于 Grupy 服务、其服务端代码，也不涵盖 Grupy 名称和 Logo。