# chatgenius-mcp 中文文档

规范地址：https://npmcn.com/package/chatgenius-mcp/

版本：0\.2\.2
npm 元数据更新时间：2026-11-03T07:26:27.365Z
中文译文更新时间：2026-11-03T07:35:53.899Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/chatgenius-mcp
原文对照：https://npmcn.com/package/chatgenius-mcp/?lang=original
项目主页：https://sumgenius.ai/docs/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：189 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：1 个
- 首次发布：2026-09-07T21:08:05.016Z
- 最新版本发布：2026-11-03T07:26:27.210Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

用于ChatGenius的MCP服务器：在您的Instagram， Facebook， WhatsApp和SMS收件箱，联系人，约会，流量，帖子和知识库上提供Claude， Cursor， Gemini CLI或任何MCP客户端工具。mcprush.com-claim-chatgenius-mcp-9c350531077363b4ce7537cb

## 安装

```sh
npm install chatgenius-mcp
```

也可以使用：`pnpm add chatgenius-mcp`、`yarn add chatgenius-mcp`、`bun add chatgenius-mcp`

## README

# chatgenius-mcp

MCP服务器 [ChatGenius](https://sumgenius.ai/)． 将其添加到Claude Desktop， Claude Code, Cursor, Zed， Gemini CLI或任何讲模型上下文协议的客户端，您的助手可以阅读和操作您的Instagram， Facebook， WhatsApp和SMS收件箱，联系人，约会，流量，评论自动化，Content Studio帖子和知识库。

它是一层薄薄的包装纸 [ChatGenius REST API](https://sumgenius.ai/docs/rest-api)． 每个工具都是一个API调用。我们不会存储任何东西，也不会运行任何东西，而且您的API密钥永远不会离开您的机器。

宁愿不运行任何东西？相同的工具托管于 `https://sumgenius.ai/api/mcp` 使用连接按钮（OAuth）：将该URL粘贴到claude中。ai、ChatGPT、Cursor或任何采用远程MCP服务器的客户端。文档: [https://sumgenius.ai/docs/mcp](https://sumgenius.ai/docs/mcp)

## 安装

您需要Node 18或更新版本和ChatGenius API密钥。在门户中创建密钥 **Webhook +发送API，凭据** （Webhook & API插件是必需的）。

**克劳德桌面** （`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "chatgenius": {
      "command": "npx",
      "args": ["-y", "chatgenius-mcp"],
      "env": { "CHATGENIUS_API_KEY": "sgwh_..." }
    }
  }
}
```

**克劳德代码** （插件，提示输入键）：

```
claude plugin marketplace add SumCodeAI/chatgenius-claude-plugin
claude plugin install chatgenius@sumgenius
```

**光标**， **Zed**， **风帆冲浪** 其余的在它们自己的MCP设置中使用相同的命令、args和env。

## 环境

| 变量 | 要求 | 意义 |
| --- | --- | --- |
| `CHATGENIUS_API_KEY` | 是 | 您的API密钥。其范围(`read`， `write`， `admin`)限制了工具的功能。 |
| `CHATGENIUS_MAX_SCOPE` | 否 | `read`， `write` 或者 `admin`． 隐藏该范围以上的所有工具，因此a `write` 钥匙 `CHATGENIUS_MAX_SCOPE=read` 提供只读助手。 |
| `CHATGENIUS_API_URL` | 否 | 基础URL。默认为 `https://sumgenius.ai/api/v1`. |

## 它能做什么

10组105个工具。读取工具可以安全地自由运行。编写工具创建或编辑记录。破坏性工具到达一个真实的人，发布内容或更改正在运行的内容，并标记以便客户端首先询问您。

| 集团 | 工具 |
| --- | --- |
| 账户 | `get_account`， `get_overview` |
| 联系人 | `list_contacts`， `get_contact`， `upsert_contact`， `update_contact`， `list_tags`， `create_tag`， `tag_contact`， `untag_contact`， `delete_tag`， `list_custom_fields`， `create_custom_field`， `update_custom_field` |
| 收件箱 | `list_conversations`， `get_conversation`， `list_messages`， `update_conversation`， `send_message`， `assign_conversation`， `list_team_members`， `list_blocked_users`， `block_user`， `unblock_user`， `list_opt_outs` |
| 任命 | `list_appointments`， `get_availability`， `get_appointment`， `update_appointment`， `book_appointment`， `reschedule_appointment`， `cancel_appointment` |
| 流 | `list_flows`， `get_flow`， `get_flow_definition`， `get_flow_node_catalogue`， `validate_flow`， `create_flow`， `update_flow`， `publish_flow`， `activate_flow`， `pause_flow`， `duplicate_flow`， `discard_flow_draft`， `delete_flow`， `get_flow_analytics`， `list_flow_sessions`， `get_flow_session`， `list_flow_session_events`， `list_flow_events` |
| 评论 | `list_comment_triggers`， `get_comment_trigger`， `simulate_comment`， `create_comment_trigger`， `update_comment_trigger`， `duplicate_comment_trigger`， `delete_comment_trigger`， `get_comment_trigger_stats`， `list_recent_posts`， `list_handled_comments`， `get_handled_comment`， `get_comment_manager_stats`， `approve_comment_reply`， `reject_comment_reply`， `bulk_approve_comment_replies`， `bulk_reject_comment_replies` |
| 内容工作室 | `list_posts`， `get_post`， `get_posting_capabilities`， `create_post`， `update_post`， `schedule_post`， `publish_post`， `unschedule_post`， `retry_post`， `delete_post` |
| 市场的英特尔 | `list_competitors`， `get_competitor`， `get_competitor_leaderboard`， `get_follower_history`， `get_wins_and_opportunities`， `get_audience_demographics`， `get_top_posts`， `get_account_insights`， `add_competitor`， `remove_competitor`， `refresh_market_intel` |
| 知识库 | `list_faqs`， `create_faq`， `update_faq`， `list_services`， `list_knowledge_gaps`， `get_knowledge_usage`， `get_faq`， `delete_faq`， `get_service`， `create_service`， `update_service`， `delete_service`， `list_documents`， `get_document`， `update_document`， `delete_document` |
| 人工智能设置 | `get_ai_config`， `get_ai_channels` |

可以尝试的事情：

-   “这周谁在Instagram上给我们发了信息，我们还没有回复？”
-   “预约玛丽亚星期四下午两点来会诊，然后告诉她。”
-   “建立一个流程，用我们的套餐回答‘价格’问题，并收集电子邮件。”
-   哪些评论回复正在等待批准？批准前三个。”
-   “过去30天的知识差距是什么？”为他们起草常见问题解答。”

构建流的工作方式与开发人员一样：助手读取节点目录，编写定义，验证它，直到错误列表为空，保存草稿，并在您指定时发布。在门户中打开流，它就被布置在画布上。

## 安全

-   每次写都有一个 `Idempotency-Key`，因此重试的工具调用不能重复发送。
-   API在服务器端强制键的作用域。 `CHATGENIUS_MAX_SCOPE` 是第二个，本地帽。
-   结果中的消息和评论文本由您的客户编写。服务器告诉模型将其视为数据，而不是指令。在客户的批准提示符后面放置破坏性工具。
-   团队、webhook端点和API密钥管理，以及打开或关闭AI，都没有公开。使用门户。

## 开发

```
npm install
npm run build:tools     # regenerate tools.json from the live OpenAPI spec
npm run check           # fail if tools.json drifted from the spec
CHATGENIUS_API_KEY=... npm run smoke
```

`src/tools.js` 是策划的工具表。 `tools.json` 是由它产生的，加上 `https://sumgenius.ai/api/v1/openapi.json` 这是什么船。将工具添加到表中，运行 `build:tools`，两者都做。

## 许可证

麻省理工学院。由SumGeniusAI LLC，拉斯维加斯制造。

## 常见问题

### chatgenius-mcp 是什么？

用于ChatGenius的MCP服务器：在您的Instagram， Facebook， WhatsApp和SMS收件箱，联系人，约会，流量，帖子和知识库上提供Claude， Cursor， Gemini CLI或任何MCP客户端工具。mcprush\.com-claim-chatgenius-mcp-9c350531077363b4ce7537cb

### 如何安装 chatgenius-mcp？

在项目目录运行 npm install chatgenius-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 chatgenius-mcp，可以用 npx chatgenius-mcp 直接运行。

### chatgenius-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chatgenius-mcp 是否存在。

### chatgenius-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### chatgenius-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### chatgenius-mcp 可以商用吗？

chatgenius-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### chatgenius-mcp 还在维护吗？

最新版本 0\.2\.2 发布于 2026/11/03（今天）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/09/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。