Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Twelfth
概览
作者提供的说明(英文原文)
Read Twelfth workspace products, sales, inventory, suppliers, pricing, projects and actions.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i1 项中通过 1 项依据公开信息检查;尚未扫描代码
- 使用情况i尚未统计★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 网店与支付
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:1 项中通过 1 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 注册中心没有列出需要填写的密钥。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
- 打开 Settings → Connectors
- 点击 Add custom connector
- 粘贴下面的地址,然后点击 Add
- 如果要求登录,请登录作者的服务
https://api.twelfth.ai/mcp在终端中运行这条命令
claude mcp add --transport http workspace https://api.twelfth.ai/mcp或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"workspace": {
"url": "https://api.twelfth.ai/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"workspace": {
"type": "http",
"url": "https://api.twelfth.ai/mcp"
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
- 打开网页版 ChatGPT → Settings → Connectors (Apps)
- 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
- 粘贴下面的地址,起个名字,然后保存
- 如果要求登录,请登录作者的服务
https://api.twelfth.ai/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
我们还没有读取这个服务器的工具列表;我们会轮流检查各个端点。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 twelfth.ai 验证(注册中心会核实域名所有权)
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
端点有响应
尚未检查;我们会轮流检查各个端点
- … 尚未检查
使用 OAuth 登录
尚未检查;我们会轮流检查各个端点
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
与“网店与支付”中的其他服务器比较i
- 星标数多于此分类中其他 1748 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 1748 个服务器的 51% 更新
- 基础检查结果等于或优于此分类中其他 1748 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Twelfth 安全吗?
它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(1.0.1)于32天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Connect the AI assistants your team already uses to its Twelfth workspace.
Claude · ChatGPT · GitHub Copilot · Gemini · Cursor · Claude Code · any MCP client
Twelfth is a commercial workspace for retail and category teams. Its hosted MCP server lets an assistant read the products, suppliers, sales, inventory, pricing, projects and open actions that the signed-in person can already see, so questions are answered from your Twelfth workspace rather than from a pasted spreadsheet.
| Endpoint | https://api.twelfth.ai/mcp (Streamable HTTP) |
| Sign-in | OAuth 2.1 with your Twelfth account. Choose the workspace and approve the tools; no key to copy |
| Access | Reads by default. Changes are opt-in: tick Allow changes when connecting and the assistant can create, complete or snooze your own actions and run your own routines, as you. None raises an order or changes a price |
| Scope | One workspace, as the person who connected: their role, remits and categories. Owners and admins see and can end every connection |
| Registry | ai.twelfth/workspace, published from the twelfth.ai domain |
| Docs | twelfth.ai/ai · MCP guide |
You need a Twelfth workspace to connect. Book a demo if your team doesn't have one yet.
How it connects
flowchart LR
A["AI assistant Claude · ChatGPT Copilot · Cursor"] -- "1 · adds the URL" --> S["Twelfth sign-in pick workspace approve tools"] S -- "2 · scoped token" --> A A -- "3 · tool calls" --> M["Twelfth MCP api.twelfth.ai/mcp"] M -- "4 · as the member" --> W[("Your 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;
Install
Cursor
Add Twelfth to .cursor/mcp.json. Cursor sends you to Twelfth to sign in on first use:
{
"mcpServers": { "twelfth": { "url": "https://api.twelfth.ai/mcp" } } }
Claude Code
/plugin marketplace add twelfth-ai/twelfth-mcp
/plugin install twelfth@twelfth
Or just the server: claude mcp add --transport http twelfth https://api.twelfth.ai/mcp
VS Code and GitHub Copilot
Or add it to .vscode/mcp.json (or your user mcp.json):
{
"servers": { "twelfth": { "type": "http", "url": "https://api.twelfth.ai/mcp" } } }
Start the server, sign in to Twelfth when VS Code asks, then use the tools from Copilot Chat in agent mode.
GitHub Copilot CLI
copilot plugin marketplace add twelfth-ai/twelfth-mcp
copilot plugin install twelfth@twelfth
This adds the server and the twelfth-workspace skill. Copilot asks you to sign in to Twelfth the first time a tool runs.
Gemini CLI
gemini extensions install https://github.com/twelfth-ai/twelfth-mcp
Then run /mcp auth twelfth inside Gemini CLI to sign in. The extension adds the server and the twelfth-workspace skill.
Claude, ChatGPT, Gemini and other clients
Add a custom connector with the URL https://api.twelfth.ai/mcp and complete the Twelfth sign-in. Per-assistant guides: twelfth.ai/ai.
Servers and scripts
A workspace owner or admin can create a labelled, tool-limited key under Settings → AI & agents → Create an API key and send it as Authorization: Bearer .
Security and governance
| Control | How it works |
|---|---|
| Reads by default | Every tool reads unless the person ticks Allow changes on the consent page. Write tools are offered only over OAuth, only after that opt-in, and act only on the person's own actions and routines. Workspace keys never make changes. Orders, prices and other commercial decisions are still committed by people inside Twelfth |
| Least privilege | An OAuth connection inherits the member's role and remits and stops working when they leave the workspace. Tools are chosen at consent |
| Admin visibility | Owners and admins see every connection, the client and version that connected, and can end any of them. An ended connection is refused on its next request |
| Keys | Created only by owners and admins, labelled by environment, limited to selected tools, stored hashed and shown once |
| Audit | Each call is logged with tool, outcome, time and duration. Tool results are never stored or sent to analytics; only their size is recorded |
| Compliance | Controls, sub-processors and our SOC 2 / ISO 27001 programme: trust.twelfth.ai |
Skills
The plugin ships eight Agent Skills. The server also serves them over the MCP Skills extension (skills/list), so an assistant that supports it gets them without installing anything.
Retail analysis. These work on a spreadsheet or pasted data. No Twelfth account is needed.
| Skill | Use it to |
|---|---|
sales-decline-diagnosis | Find out why sales of a category, supplier or product fell: split the change into units, price, mix and returns, then test the causes cheapest first |
category-review | Review a category: its role, scorecard, availability, return on stock, range and promotions, and what to do next |
range-review | Decide which lines to keep, cut or add, using where a cut line's shoppers would go and stock you've already bought |
supplier-offer-review | Read a supplier's stock list or offer against your sales and cover: what to buy, how much, and what's missing |
competitor-price-check | Check price position on matched products: listing errors, pack sizes, member and promo prices, a weighted index, and whether to match |
Twelfth. These need the Twelfth connection.
| Skill | Use it to |
|---|---|
twelfth-workspace | Get started: which workspace is connected, what the tools can see, and how changes work |
twelfth-weekly-trading-brief | Write Monday's brief: actions due, suppliers waiting, cover pressure, price position and three things to do first |
twelfth-competitor-pricing | Answer pricing questions from tracked sets, competitor comparisons and price history |
Each retail-analysis skill ends with what changes when Twelfth is connected.
What's in this repo
This repository holds client configuration only; the server is hosted and operated by Twelfth AI Pty Ltd.
| Path | What |
|---|---|
plugins/twelfth/ | The plugin: MCP config for Cursor (mcp.json) and Claude Code (.mcp.json), and the eight skills above |
.cursor-plugin/, .claude-plugin/ | Marketplace manifests for Cursor and Claude Code |
gemini-extension.json, skills/ | The Gemini CLI extension. skills/ is a copy of the plugin's skills; node scripts/validate-template.mjs fails if they drift |
Support
- Questions and enterprise enquiries: hello@twelfth.ai
- Security reports: security.txt
- Privacy: twelfth.ai/legals/privacy
Twelfth AI Pty Ltd · ACN 695 769 138 · Australia
The contents of this repository are MIT licensed. The Twelfth service is governed by its terms.
smithery-verification=0c586824f907c08ca5140641c9ddc0c07e5e1574fd305497c14360c7f4ded531