Twelfth

将团队已在使用的 AI 助手连接到 Twelfth 工作区。
Claude · ChatGPT · GitHub Copilot · Gemini · Cursor · Claude Code · 任意 MCP 客户端

---

Twelfth 是面向零售和品类团队的商业工作区。其托管 MCP 服务可让助手读取已登录用户本来就能查看的产品、供应商、销售、库存、定价、项目和待处理事项，从而根据您的 Twelfth 工作区回答问题，而不是依赖粘贴的电子表格。

端点	https://api.twelfth.ai/mcp（Streamable HTTP）
登录	使用您的 Twelfth 账号通过 OAuth 2.1 登录。选择工作区并批准工具；无需复制密钥
访问权限	默认只读。变更需选择启用：连接时勾选 允许变更，助手便能以您的身份创建、完成或暂缓您自己的待处理事项，以及运行您自己的例行流程。任何操作都不会下订单或更改价格
范围	一个工作区，以连接者的身份访问：其角色、职责范围和品类。所有者和管理员可以查看并结束每个连接
注册表	ai.twelfth/workspace，从 twelfth.ai 域名发布
文档	twelfth.ai/ai · MCP 指南

连接需要 Twelfth 工作区。如果您的团队还没有工作区，请预约演示。

连接方式

flowchart LR
    A["AI assistant<br/>Claude · ChatGPT<br/>Copilot · Cursor"] -- "1 · adds the URL" --> S["Twelfth sign-in<br/>pick workspace<br/>approve tools"]
    S -- "2 · scoped token" --> A
    A -- "3 · tool calls" --> M["Twelfth MCP<br/>api.twelfth.ai/mcp"]
    M -- "4 · as the member" --> W[("Your<br/>workspace")]
    ADM["Owner / admin"] -. "sees · ends any connection" .-> M

    classDef ink fill:#1e3b2c,stroke:#14291f,color:#f6efdd;
    classDef paper fill:#f6efdd,stroke:#1e3b2c,color:#1e3b2c;
    classDef gilt fill:#c8a24b,stroke:#1e3b2c,color:#1e3b2c;
    class A,ADM paper;
    class S,M ink;
    class W gilt;

安装

Cursor

将 Twelfth 添加到 .cursor/mcp.json。首次使用时，Cursor 会引导您前往 Twelfth 登录：

{
  "mcpServers": {
    "twelfth": { "url": "https://api.twelfth.ai/mcp" }
  }
}

Claude Code

/plugin marketplace add twelfth-ai/twelfth-mcp
/plugin install twelfth@twelfth

或者只添加服务：claude mcp add --transport http twelfth https://api.twelfth.ai/mcp

VS Code 和 GitHub Copilot

或者将其添加到 .vscode/mcp.json（或你的用户级 mcp.json）：

{
  "servers": {
    "twelfth": { "type": "http", "url": "https://api.twelfth.ai/mcp" }
  }
}

启动服务，在 VS Code 提示时登录 Twelfth，然后在 Agent 模式下通过 Copilot Chat 使用这些工具。

GitHub Copilot CLI

copilot plugin marketplace add twelfth-ai/twelfth-mcp
copilot plugin install twelfth@twelfth

这会添加服务和 twelfth-workspace 技能。首次运行工具时，Copilot 会要求你登录 Twelfth。

Gemini CLI

gemini extensions install https://github.com/twelfth-ai/twelfth-mcp

然后在 Gemini CLI 中运行 /mcp auth twelfth 以登录。该扩展会添加 服务和 twelfth-workspace 技能。

Claude、ChatGPT、Gemini 和其他客户端

添加自定义连接器，使用 URL https://api.twelfth.ai/mcp，并完成 Twelfth 登录。各助手的指南：twelfth.ai/ai。

服务和脚本

工作区所有者或管理员可以在 设置 → AI 和 Agent → 创建 API 密钥下创建带标签、限制可用工具的密钥，并通过 Authorization: Bearer <key> 发送。

安全与治理

控制项	工作方式
默认只读	除非用户在同意页面勾选允许更改，否则每个工具都只能读取。写入工具仅通过 OAuth 提供，且只有在选择启用后才可使用，并且只能执行用户自己的操作和日常流程。工作区密钥不会进行更改。订单、价格和其他商业决策仍由用户在 Twelfth 中确认
最小权限	OAuth 连接继承成员的角色和职责，并会在成员离开工作区后停止工作。用户在同意时选择工具
管理员可见性	所有者和管理员可以查看每个连接、连接时使用的客户端和版本，并可终止任何连接。连接终止后，其下一次请求将被拒绝
密钥	仅由所有者和管理员创建，按环境添加标签，限制为选定的工具，以哈希形式存储，且仅显示一次
审计	每次调用都会记录工具、结果、时间和持续时长。工具结果绝不会被存储或发送到分析系统；只记录其大小
合规	控制措施、分处理方以及我们的 SOC 2 / ISO 27001 计划：trust.twelfth.ai

技能

该插件包含八个 Agent Skills。服务也通过 MCP Skills 扩展（skills/list）提供这些技能，因此支持该扩展的助手无需安装即可使用。

零售分析。 这些技能适用于电子表格或粘贴的数据。无需 Twelfth 账户。

技能	用途
sales-decline-diagnosis	找出某个品类、供应商或产品销售下滑的原因：将变化拆分为销量、价格、结构和退货，再从成本最低的原因开始验证
category-review	审查一个品类：其角色、计分卡、可售情况、库存回报、产品组合和促销，以及接下来该怎么做
range-review	决定保留、淘汰或新增哪些产品线，同时考虑被淘汰产品线的顾客会转向何处，以及已购入的库存
supplier-offer-review	根据销售和库存覆盖情况，审阅供应商的库存清单或报价：买什么、买多少，以及还缺什么
competitor-price-check	检查对标产品的价格定位：商品信息错误、包装规格、会员价和促销价、加权指数，以及是否需要跟价

Twelfth。 这些技能需要连接 Twelfth。

技能	用途
twelfth-workspace	开始使用：了解已连接的工作区、工具可查看的内容，以及更改的运作方式
twelfth-weekly-trading-brief	撰写周一简报：到期行动、待回复的供应商、库存覆盖压力、价格定位，以及优先处理的三件事
twelfth-competitor-pricing	根据跟踪的产品集、竞品比较和价格历史回答定价问题

每个零售分析技能的末尾都会说明连接 Twelfth 后会有哪些变化。

此仓库包含什么

此仓库仅包含客户端配置；服务由 Twelfth AI Pty Ltd 托管和运营。

路径	内容
plugins/twelfth/	插件：适用于 Cursor（mcp.json）和 Claude Code（.mcp.json）的 MCP 配置，以及上述八个技能
.cursor-plugin/、.claude-plugin/	适用于 Cursor 和 Claude Code 的市场清单
gemini-extension.json、skills/	Gemini CLI 扩展。skills/ 是插件技能的副本；如果两者不一致，node scripts/validate-template.mjs 会失败

支持

• 问题和企业咨询：[email protected]
• 安全问题报告：security.txt
• 隐私：twelfth.ai/legals/privacy

_{Twelfth AI Pty Ltd · ACN 695 769 138 · 澳大利亚}

此仓库的内容采用 MIT 许可证。Twelfth 服务受其条款约束。

smithery-verification=0c586824f907c08ca5140641c9ddc0c07e5e1574fd305497c14360c7f4ded531