Schematic

Schematic MCP 服务

警告

已弃用。 Schematic 现已托管 MCP 服务，地址为 https://api.schematichq.com/mcp — 请参阅 Schematic MCP 文档了解如何连接。此本地 stdio 服务仍可使用，但不再接收新工具或修复。

一个 MCP 服务，可将 AI 助手连接到 Schematic —— 用于管理计费、计划、功能和权益的平台。

使用此服务，Claude、Cursor 或任何兼容 MCP 的客户端都可以通过自然语言查询公司、管理计划权益、设置覆盖项、创建功能等。

快速入门

前提条件

1. 获取 Schematic 密钥 API 密钥：注册 Schematic 账户，并从 Schematic 控制面板获取密钥 API 密钥。注意：请使用密钥 API 密钥，而不是可发布密钥。

安装

选项 1：使用 Claude CLI（推荐）

1. 从 npm 安装软件包：

   npm i @schematichq/schematic-mcp
   

2. 将 MCP 服务添加到 Claude：

   claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-secret-api-key-here -- npx @schematichq/schematic-mcp
   

   将 your-secret-api-key-here 替换为你的实际 Schematic API 密钥。

选项 2：手动配置

Claude Desktop / Claude Code

将以下内容添加到 Claude 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-secret-api-key-here"
      }
    }
  }
}

Cursor

将以下内容添加到 Cursor MCP 配置（Settings > MCP Servers，或直接编辑文件）：

• macOS：~/.cursor/mcp.json
• Linux：~/.cursor/mcp.json
• Windows：%USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-secret-api-key-here"
      }
    }
  }
}

添加配置后，重启 Cursor 以加载服务。

配置

此服务需要 Schematic 密钥 API 密钥（而非可发布密钥）。它会按顺序检查两个来源：

1. 环境变量（推荐）：SCHEMATIC_API_KEY
2. 配置文件（备用）：~/.schematic-mcp/config.json

{
  "apiKey": "your-secret-api-key-here"
}

你可以在 Schematic 控制面板中找到密钥 API 密钥。

自定义 API 基础 URL（可选）

默认情况下，此服务指向生产环境的 Schematic API。若要将其指向本地或非生产环境的 API，请设置 SCHEMATIC_API_URL：

{
  "command": "npx",
  "args": ["@schematichq/schematic-mcp"],
  "env": {
    "SCHEMATIC_API_KEY": "your-secret-api-key-here",
    "SCHEMATIC_API_URL": "http://localhost:8080"
  }
}

未设置时，将使用 SDK 的生产环境默认值。

工具

公司查询

工具	说明
get_company	通过 ID、名称、Stripe 客户 ID 或自定义键查询公司。返回详细信息、计划、试用状态和链接。
create_company	创建（插入或更新）由键（keyName/keyValue）标识的公司，可选填写 name 和 traits。如果键已存在，则更新该公司。
get_company_plan	获取公司当前使用的计划。
get_company_trial_info	检查公司是否正在试用，以及试用何时结束。
count_companies_on_plan	统计使用指定计划的公司数量。
link_stripe_to_schematic	查找与 Stripe 客户 ID 对应的 Schematic 公司，或反向查询。

公司覆盖项

工具	说明
list_company_overrides	按公司或功能列出覆盖项。
set_company_override	为公司在指定功能上设置或更新覆盖项。支持布尔值（on/off）、数值和 unlimited 值。
remove_company_override	移除覆盖项，使公司恢复使用计划权益。

计划管理

工具	说明
list_plans	列出所有计划。
create_plan	创建新计划。
add_entitlements_to_plan	向计划添加功能权益。自动检测功能类型并设置相应的值类型。

功能管理

工具	描述
list_features	列出所有功能。
create_feature	创建新的功能标志。支持布尔型（开/关）、基于事件型（计量）和基于特征型。自动创建关联的标志。

标志管理

工具	描述
list_flags	列出所有标志及其定向摘要 — 对于每个标志：键、默认值、关联的功能，以及其解析结果是始终开启、始终关闭还是定向。可用于审计始终开启的标志（在代码中检查它们是多余的）或未使用的标志（可考虑删除）。
get_flag	按键获取单个标志的完整定向详情：默认值、每条规则（类型、值、优先级、条件数量）、上次检查时间，以及始终开启/始终关闭/定向的判定结果。

示例提示词

配置完成后，尝试向 AI 助手提问：

• “Acme Corp 使用的是哪个套餐？”
• “列出我的所有套餐及其功能”
• “创建一个名为 ‘Advanced Analytics’ 的布尔型功能”
• “为 Acme Corp 设置覆盖项，使其拥有无限 API 调用次数”
• “有多少家公司使用 Pro 套餐？”
• “查找与 Stripe 客户 cus_abc123 关联的 Schematic 公司”
• “列出所有标志，并告诉我哪些始终开启”
• “显示 billing.credits 标志的定向规则”

开发

# Install dependencies
yarn install

# Build
yarn build

# Run in development mode (auto-recompile on changes)
yarn dev

# Run tests
yarn test

许可证

MIT