seldonframe-mcp

@seldonframe/mcp

适用于 Claude Code 和 Claude Desktop 的官方 SeldonFrame MCP 服务。

一条命令，一个真正的工作区。 首次运行时，无需 API 密钥。调用 create_workspace({ name: "Dental Clinic Laval" })，服务就会在 dental-clinic-laval.app.seldonframe.com 上创建一个真正托管的工作区——预装 CRM、Cal.diy 预约、Formbricks 接待表单和 Brain v2——并返回可用的 URL。没有注册门槛，没有“访客模式”，也无需认领。

60 秒快速入门

# 1. From the repo root
cd skills/mcp-server && npm install

# 2. Register with Claude Code — no env vars needed
claude mcp add seldonframe -s user -- node "$(pwd)/src/index.js"

# 3. In Claude Code, just ask:
#    create_workspace({ name: "My Business OS" })

该调用会返回类似以下内容：

{
  "workspace": { "id": "wsp_…", "slug": "my-business-os", "tier": "free" },
  "urls": {
    "dashboard": "https://my-business-os.app.seldonframe.com",
    "book": "https://my-business-os.app.seldonframe.com/book",
    "intake": "https://my-business-os.app.seldonframe.com/intake"
  },
  "installed": ["crm", "caldiy-booking", "formbricks-intake", "brain-v2"],
  "next": [ "…" ]
}

之后每次工具响应都会包含一个 next: 数组——沿着指引继续操作。

身份验证的工作方式

情况	结果
首次调用	create_workspace 在不进行身份验证的情况下发送 POST 请求。服务创建工作区并生成持有者令牌。MCP 将令牌存储在 ~/.seldonframe/device.json 中。
后续调用	MCP 会自动发送 Authorization: Bearer <workspace token>。
已设置 SELDONFRAME_API_KEY	优先使用此密钥，而非设备令牌。解锁 Pro 功能。

你无需切换模式。首个工作区永久免费。

何时需要 SELDONFRAME_API_KEY

• 添加第二个工作区
• 连接自定义域名
• 使用 Brain v2 完整智能功能（启发式 Brain 始终免费）
• 发布、导出、组织范围的密钥轮换

前往 https://app.seldonframe.com/settings/api 获取密钥，然后：

export SELDONFRAME_API_KEY=sk-…

重启 MCP 服务。现有工作区会继续正常运行，不受影响。

通过插件清单安装（一次性操作）

仓库根目录提供 .claude-plugin/plugin.json。在 Claude Code 中运行：

/plugin install <path-to-repo>

通过 npm 安装

claude mcp add seldonframe -- npx -y @seldonframe/mcp

这是营销网站、/docs/quickstart 页面和仓库 README 中提供的标准安装命令。该命令使用 npx -y，因此用户无需全局安装任何内容；系统会按需获取并运行最新版本。

环境

• SELDONFRAME_API_KEY （可选） — 启用 Pro 功能（第二个工作区、自定义域名、完整 Brain v2）。
• SELDONFRAME_API_BASE （可选） — 覆盖 API 基础 URL。默认为 https://app.seldonframe.com/api/v1。

工具

工作区： create_workspace、list_workspaces、switch_workspace、clone_workspace、link_workspace_owner、get_workspace_snapshot。 模块： install_caldiy_booking、install_formbricks_intake、install_vertical_pack。 自定义（类型化，无后端 LLM）： update_landing_content、customize_intake_form、configure_booking、update_theme。 Soul： fetch_source_for_soul、submit_soul。 运维： list_automations、connect_custom_domain、export_agent、store_secret、list_secrets、rotate_secret。

架构：后端 LLM 成本为零

自然语言推理在 MCP 会话中进行（用户端的 Claude Code）。后端只接受结构化命令并确定性地执行。不存在会在服务器端解析提示词的 seldon_it 端点；旧的 query_brain 已由 get_workspace_snapshot 取代，后者会返回原始状态，供 Claude 推理。Seldon 的免费层无需承担任何 LLM 费用——用户的 Claude Code 订阅就是推理引擎。

Soul 编译（Seldon 零成本）

Soul 编译在你的 Claude Code 会话中运行，而不是在 Seldon 的服务器上：

1. fetch_source_for_soul({ url }) — 最多返回 256KB 的规范化文本。
2. 你（Agent）提取结构化的 Soul 对象。
3. submit_soul({ soul }) — 将其保存到工作区。

故障排除

Seldon API 401 — 你的 SELDONFRAME_API_KEY 无效或已过期。前往 https://app.seldonframe.com/settings/api 重新生成，或取消设置此环境变量，以回退到设备令牌。

Seldon API 402 — 你尝试使用 Pro 功能，但没有密钥。设置 SELDONFRAME_API_KEY 并重启。

想重置设备状态？ 删除 ~/.seldonframe/device.json。托管工作区仍会在 app.seldonframe.com 上保持运行；只有本地令牌会被清除。

隐私政策

完整政策：https://www.seldonframe.com/privacy

• 数据收集。 连接器在本地运行，只会发送你要求它发送的内容：结构化工具命令和业务内容（工作区名称、你指定的 URL、你创建的联系人和预订详细信息）会通过 HTTPS 发送到 app.seldonframe.com。它在你的设备上只存储工作区持有者令牌，路径为 ~/.seldonframe/device.json。
• 使用与存储。 你提交的数据会存储在托管的 SeldonFrame 工作区中，并用于运行该工作区（网站、CRM、预订、Agent）。这些数据不会用于训练 AI 模型。
• 第三方共享。 我们不会出售你的数据。工作区功能依赖基础设施子处理商（托管、数据库，以及你配置的电子邮件／短信发送服务），详情见上述政策。
• 保留期限。 工作区处于活动状态期间，工作区数据会予以保留；删除账户或提出请求后，数据将被删除。你可以随时删除 ~/.seldonframe/device.json，移除本地设备令牌。
• 联系。 [email protected]

许可证

此软件包（skills/mcp-server，SeldonFrame MCP 连接器）采用 MIT 许可证。仓库其余部分中的 SeldonFrame 平台仍采用 AGPL-3.0 许可证，详见仓库根目录的 LICENSE。