stigg-mcp

Stigg MCP — 连接一次，随处使用

位于 https://mcp.stigg.io 的 Stigg MCP 服务可向任何兼容 MCP 的 AI 客户端开放 Stigg 环境。随后，Agent 无需编写 API 调用，即可通过自然语言创建客户、管理订阅、检查权益并报告用量。

状态：Stigg MCP 服务目前处于公开测试版。在依赖边缘行为之前，请通过 docs.stigg.io 再次确认。

开始之前

根据总览 stigg 技能：先搜索。如果用户已经有可用的 Mintlify Stigg 文档 MCP（search_stigg），请使用它确认最新的安装命令。如有疑问，请重新获取 MCP 服务文档页面。

三步设置

第 0 步 — 需要一个 Stigg 账户

如果还没有账户，请在 app.stigg.io 注册。新账户会获得一个默认沙盒环境。生产环境需使用 Scale 套餐。

如果 Agent 在完成第 0 步之前运行安装命令，烟雾测试会因 401 Unauthenticated 失败。

第 1 步 — 获取 API 密钥

1. 在 Stigg 应用中，前往 Integrations → API keys。
2. 选择环境（沙盒 / 预发布 / 生产）。AI 辅助开发时默认使用沙盒。
3. 复制 Full access 密钥，或点击 + Add scoped key（Scale 套餐）并仅授予 Agent 所需的权限。请像对待密码一样妥善保管密钥。

为实现更好的隔离，请为每个 AI 客户端创建专用的范围限定密钥（例如，“Claude Code – Dev”、“Cursor – Staging”）。

第 2 步 — 配置客户端（各 AI 客户端的配置片段）

Claude Code（HTTP 传输 — 首选）

claude mcp add stigg \
  --header "X-API-KEY: <YOUR_API_KEY>" \
  --transport http https://mcp.stigg.io

然后启动新的 Claude Code 会话，并运行 /mcp，确认 stigg 已连接且其工具已列出。

Claude Desktop

编辑：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 下添加：

{
  "mcpServers": {
    "stigg": {
      "url": "https://mcp.stigg.io",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

重启 Claude Desktop。

ChatGPT

在 Settings → Connectors 中添加新的 MCP 服务：

字段	值
服务 URL	https://mcp.stigg.io
连接方式	API Key（header）
Header 名称	X-API-KEY
Header 值	<YOUR_API_KEY>

Cursor / VS Code / Windsurf / Codex / 通用客户端（stdio 桥接）

这些客户端使用本地 stdio 桥接 @stigg/typescript-mcp（通过 npx 运行）。编辑相应的配置文件（Cursor 使用 ~/.cursor/mcp.json；VS Code 中使用 MCP: Open User Configuration；Windsurf/Codex 使用对应配置），并添加：

{
  "mcpServers": {
    "stigg_typescript_api": {
      "command": "npx",
      "args": ["-y", "@stigg/typescript-mcp"],
      "env": {
        "STIGG_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

重启客户端。对于原生支持 HTTP 传输的客户端，请优先使用 mcp.stigg.io HTTP 配置形式（与 Claude Desktop 配置片段的结构相同）。

权威且始终保持最新的安装配置表位于 docs.stigg.io/api-and-sdks/mcp-server。如果此处的配置片段无法使用，请从该页面重新获取。

烟雾测试

安装后，请确认：

1. **工具列表。**在 Claude Code 中运行 /mcp — stigg 应显示为已连接，且列出其工具。
2. **搜索文档。**询问：*“搜索 Stigg 文档中有关‘创建客户’的内容。”*如果 Agent 调用 search_docs（或同等工具）并返回文档片段，说明传输正常。
3. **无操作读取。**询问：*“列出此 Stigg 环境中的前 3 个客户。”*这会对实时环境执行读取操作。全新沙盒中的预期结果是空列表 — 这表示测试通过。

如果任何步骤失败，最常见的原因是：Header 名称错误（应为 X-API-KEY，而不是 Authorization）、密钥所属环境与预期不符，或编辑配置后没有重启客户端。

何时不应使用此 Skill

不要加载此 Skill，请直接改用其他 Skill，适用于以下情况：

• 你正在编写生产环境关键路径（门控、每次请求的用量报告）。MCP 的设计本就具有非确定性；请改用 Node SDK，参见 stigg-api。
• 用户明确要求使用 CLI，或任务明确属于确定性的 Shell 工作流（CI、定时 cron、运行手册）。请使用 Stigg CLI（brew install stiggio/tools/stigg — https://github.com/stiggio/stigg-cli），参见 references/cli-vs-mcp.md。其他情况下，即使是一次性运维任务，也默认使用 MCP 服务。
• 用户的问题与 REST 或 GraphQL API 本身有关，而不是 MCP 服务，参见 stigg-api。

如果你正在 AI 助手中进行建模、探索或一次性运维，MCP 服务就很合适。它不适合无人值守自动化或生产环境关键路径。

安全 — 连接生产环境前请先阅读

• 默认使用沙盒环境。 AI Agent 可能会根据被误解的自然语言指令，执行破坏性且难以撤销的操作。请先在沙盒环境中开发和测试。
• 每个 AI 客户端使用一个权限范围受限的密钥。 不要到处重复使用完整访问权限的密钥。如果密钥泄露，影响范围仅限于其权限范围。
• 密钥与环境绑定。 沙盒环境的密钥无法访问生产数据，反之亦然。
• 切勿提交密钥。 请将密钥视为密码。
• 定期轮换密钥，路径为 Settings → API keys。Stigg 支持通过可配置的宽限期实现零停机轮换。
• Agent 代表你执行操作。 Agent 没有独立身份。MCP 服务会使用你的密钥转发 API 调用，权限范围受该密钥限制。

多环境

每个 mcpServers 条目对应一个环境。要切换环境，请使用不同的密钥配置单独的条目（stigg-sandbox、stigg-production）。这种方式容易出错——Agent 可能不知道应该选择哪个环境。建议每个会话只使用一个环境，并且只添加你希望 Agent 操作的那个环境对应的密钥。

连接后 Agent 可以执行的操作

以下仅为部分示例（支持范围还在持续扩大，请重新查看文档页面）：

• 目录： 创建／更新／归档／列出计划、功能、附加项；发布和归档套餐。
• 客户与订阅： 配置客户，创建／预览／取消订阅（包括定时订阅和试用订阅），授予促销权益。
• 权益与用量： 检查权益、报告用量数据、报告计量事件。

当前简明的工具列表见 references/mcp-tools.md。请勿记住此列表——如有疑问，请从在线文档重新获取。

常见错误

错误	修正方法
使用了 Authorization: Bearer 标头	Stigg MCP 要求使用 X-API-KEY。
/mcp 中没有显示 stigg	编辑配置后忘记重启客户端。
每次调用都返回 401 Unauthenticated	密钥对应的是其他环境，或密钥已过期、已撤销。
Agent 错误地在生产环境中执行了操作	开发期间配置中只能包含沙盒密钥。请移除生产环境条目。
为 CI 脚本选择了 MCP	CI 请使用 CLI。MCP 的设计本就具有非确定性。
将密钥嵌入已提交到代码库的配置中	请使用环境变量或客户端的密钥存储。立即轮换已泄露的密钥。
将 TypeScript 类型检查未通过导致的 execute isError: true 误认为账户／权限错误	execute 会在沙盒中运行 TypeScript——类型检查错误表示代码片段无法编译，并不代表 API 或密钥有误。请修正 TS 后重新运行。