社区管理AI接口

圆形MCP

Circle.so社区的人工智能操作界面。

通过自然语言检查、诊断和操作您的Circle社区。运行社区审计，检测未解决的问题，评估入职健康状况，识别内容差距，发布内容，而无需在仪表板之间切换。

v0.3.1 | 16工具 | 非破坏性写入 | 与Claude Code和Claude Desktop配合使用 | MIT许可证

为什么重要

社区操作员每周都会浪费几个小时点击管理仪表板来回答基本问题： 哪些空间是空的？成员们得到答案了吗？我们的社区结构到底是什么样子的？

Circle MCP免除了仪表板税。用自然语言提问，得到结构化的答案，采取行动——所有这些都来自一次对话。没有脚本，没有标签切换，没有手动导出。

除了简单的数据访问外，Circle MCP还包括内置的智能——社区健康快照、未答复的事后检测、内容差距分析——这些智能将多个数据点聚合成可操作的操作员见解，而这些见解是任何单一仪表板视图都无法获得的。

这是给谁的

• 社区经理 运行日常健康检查和内容操作
• 顾问和机构 审计客户社区并在几分钟内提供见解
• 教育工作者 管理课程空间、回答学生问题和发布课程内容
• AI原生创始人 在没有专门的社区团队的情况下保持社区的活力
• 操作员厌倦了仪表盘疲劳 谁想要一个社区情报接口

要求： Git、Node.js>=18、终端舒适度和Circle Admin API令牌。

你能做什么

这些工作流程已针对实时Circle社区进行了验证：

社区架构审计

“按空间组列出我的Circle空间。确定任何结构或入职问题。”

生成空间、空间组、类型、URL和图标的完整清单。表面空白、命名不清和结构间隙。

入职审计

“检查我的入职相关空间，并提出改进建议。”

评论入门空间、欢迎流程和介绍性内容。识别新成员可能陷入困境或失去上下文的地方。

社区健康快照

“生成社区健康快照并突出参与风险。”

将成员数量、帖子数量、空间活动和未回答的问题汇总到一个操作员简报中。

未应答检测

“检测未回复的帖子，并优先考虑需要操作员注意的内容。”

扫描所有空格（或特定空格）以查找没有评论的帖子。表面忽略了问题和参与差距。

内容差距分析

“识别削弱会员体验的空白或未充分利用的空间。”

将空间结构与后活动和参与进行交叉引用。查找内容沙漠，并建议在哪里投入精力。

种子含量规划

“根据社区审计，为最需要内容的空间建议5个种子帖子。”

使用审计见解为服务不足的空间推荐特定内容。使用书写工具立即起草帖子。

安全内容操作

“在公告栏中创建一个标题为“第二季度更新”的帖子草稿，其中包含我们最近的里程碑。”

通过Claude创建帖子、更新现有内容和添加评论。发布前，帖子默认为草稿状态以供审阅。

快速开始

1.获取您的Circle API代币

以管理员身份登录您的Circle社区。首选 设置 > API > 生成新令牌.

2.克隆和构建

git clone https://github.com/iamnortey/circle-mcp-server.git
cd circle-mcp-server
npm install && npm run build

3.联系克劳德

4.验证连接

Give me a health snapshot of my Circle community

如果您看到您的社区名称和统计数据，则表示您已连接。

工具

跨四个功能层的16个工具：

所有工具都以前缀 circle_。不公开任何删除操作。看 工具参考 查看完整的参数和示例。

示例提示

操作员诊断：

“显示按空间组分组的所有空间。哪些空间没有最近的帖子？”

参与度监控：

“问答空间中是否有未回复的帖子？按年龄排序。”

内容审核：

“搜索有关入职培训的帖子。存在哪些内容，差距在哪里？”

成员见解：

“本月有多少会员加入？显示最近的注册人数。”

内容创建：

“在公告中创建一个标题为“每周更新”的帖子草稿，总结本周的活动。”

社区简报：

“给我一个可以在客户会议上展示的摘要：健康指标、未回复的帖子和最近的活动。”

看 提示入门包 适用于30+即用型工作流。

验证状态

在生产环境中使用Claude Code和Claude Desktop对实时Circle社区进行了验证：

• 读取路径： 社区健康快照、带有图标和URL的全空间清单、未回复的帖子检测、内容差距分析、入职审核和战略建议——所有这些都证实对实时Circle社区有效。
• 写入路径： 帖子创建（草稿和发布）和帖子更新已确认有效。第一个工作流程草案已被验证可安全用于生产。评论创建是公开的，但受已知的Circle API限制（管理令牌返回401-请参阅下面的限制）。
• 克劳德桌面： 已成功加载并验证。所有16个工具可见且可操作。
• 测试套件： 95次离线测试+19次API现场测试通过。

限制（v0.3.1）

• 无破坏性操作（删除、存档、批量删除）
• 无审核（隐藏、标记、删除内容）
• 无成员管理（禁止、邀请、更改角色）
• 没有空间或社区设置更改
• 无活动或课程（计划用于v0.4）
• 无历史分析（快照为时间点）
• 无文件或图像上传

写回复警告： Circle的API可能不会在成功写入后立即响应有效负载中完全回显渲染的正文内容。帖子已正确创建/更新，但API响应可能会省略或截断正文字段。这是Circle API行为，而不是服务器缺陷。如果需要确认完整呈现的内容，请在创建后获取帖子进行验证。

评论创建警告： 这 circle_create_comment 该工具包含在v0.3.0中，但Circle的Admin API v2返回401（“您不能执行此操作”），用于使用管理员令牌创建评论。端点存在，该工具通过清晰的消息和解决方法（通过Circle web界面创建注释）优雅地处理此错误。阅读操作以获取评论(circle_list_comments, circle_get_comment)正常工作。这是Circle API权限限制，而不是服务器缺陷。

故障排除

“身份验证失败”或结果为空

您的Circle Admin API令牌可能已过期或不正确。

1. 在Circle管理>设置>API中生成新令牌
2. 更新您的配置：
   • 克劳德代码： claude mcp remove circle 然后使用新令牌重新添加
   • 克劳德桌面： 编辑 claude_desktop_config.json 并替换令牌值，然后重新启动Claude Desktop

环境变化后的过期令牌

如果您在远程部署中更新Circle API令牌（例如铁路环境变量），则该更改会 不 传播到您本地的Claude Desktop或Claude Code配置。本地MCP配置独立存储令牌。您必须在这两个位置更新令牌。

工具未出现

确保构建成功完成(npm run build 应该产生一个 dist/ 目录）。检查Claude配置中的路径是否指向正确的 dist/index.js 文件。

反应缓慢

Circle Admin API偶尔会出现延迟峰值。服务器通过30秒的超时和读取操作的自动重试来处理此问题。如果仍然存在，请检查 圆形平台状态.

运作原理

您携带您自己的Circle Admin API代币。服务器在您的机器上本地运行，没有数据通过第三方基础设施。您的社区数据位于您、Claude和Circle的API之间。

You (Claude Code / Claude Desktop)
        ↓ natural language
Circle MCP Server (runs on your machine)
        ↓ authenticated HTTPS
Circle Admin API v2

文档

高级选项

远程HTTP传输（实验）

用于多个操作员共享单个端点的团队部署或机构设置。部署到Railway、Render或任何Node.js主机并运行 npm run start:http。参见 部署文档 了解详情。

HTTP传输没有身份验证层，不应暴露在不受信任的网络中。

史密斯利市场

此服务器列在 史密瑟里.Smithery管理配置并通过stdio启动服务器。

引导式设置和入职培训

想要为您的团队配置和运行Circle MCP吗？提供引导式设置、操作员培训和托管部署服务。看 服务_免费.md 了解详情。

技术细节

• 语言： TypeScript（严格模式）
• 运行时间： Node.js>=18（原生 fetch)
• MCP-SDK： @modelcontextprotocol/sdk v1.12.1
• 验证： Zod v3.24与 .strict() 模式
• 运输： stdio（初级，生产测试），流式HTTP（实验）
• 测试套件： 95次离线测试+19次API现场测试
• 依赖关系： 2运行时，3开发

路线图

• v0.4： 活动、课程和扩展内容操作
• v0.5： Webhook订阅和实时事件流
• 未来： npx 安装、多社区支持、文件上传、审核工具

看 路线图 了解详情。

许可证

麻省理工学院——见 许可证 了解详情。

贡献

问题和拉取请求欢迎访问 github/iamnortey/circle-mcp服务器.

支持

如果Circle MCP为您节省了时间，请考虑支持正在进行的开发。捐款有助于为维护、文档和新工作流程提供资金。

• GitHub赞助商