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 認証を行います。ワークスペースを選び、ツールを承認してください。コピーするキーはありません
アクセス	デフォルトでは読み取り専用です。変更はオプトインです。接続時に 変更を許可 にチェックを入れると、アシスタントはあなたとして、あなた自身のアクションの作成、完了、スヌーズ、およびルーティンの実行を行えます。注文の発注や価格の変更は行いません
範囲	接続したユーザーとして、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 にサインインしてから、エージェントモードの 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。

サーバーとスクリプト

ワークスペースのオーナーまたは管理者は、Settings → AI & agents → Create an API key でラベル付きの、使用ツールを制限したキーを作成し、Authorization: Bearer <key> として送信できます。

セキュリティとガバナンス

制御	仕組み
デフォルトでは読み取り専用	同意ページで本人が Allow changes にチェックを入れない限り、すべてのツールは読み取り専用です。書き込みツールは OAuth 経由でのみ提供され、本人がオプトインした後に限り、本人自身の操作とルーティンに対してのみ動作します。ワークスペースキーでは変更は行われません。注文、価格、その他の商取引上の決定は、引き続き Twelfth 内で本人が確定します
最小権限	OAuth 接続にはメンバーのロールと権限が引き継がれ、そのメンバーがワークスペースを離れると機能しなくなります。使用するツールは同意時に選択します
管理者の可視性	オーナーと管理者は、すべての接続、接続したクライアントとバージョンを確認でき、どの接続も終了できます。終了した接続は、次回のリクエスト時に拒否されます
キー	オーナーと管理者のみが作成でき、環境ごとにラベルを付け、選択したツールに制限できます。ハッシュ化して保存され、作成時に一度だけ表示されます
監査	各呼び出しについて、ツール、結果、時刻、所要時間が記録されます。ツールの結果は保存も分析への送信もされず、記録されるのは結果のサイズのみです
コンプライアンス	管理策、サブプロセッサー、SOC 2 / ISO 27001 プログラム：trust.twelfth.ai

スキル

このプラグインには、8 つのエージェントスキルが含まれています。サーバーは 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	月曜日のブリーフを作成します。期限が来ているアクション、返答待ちのサプライヤー、在庫カバーの逼迫、価格ポジション、最初に取り組むべき 3 つの項目をまとめます
twelfth-competitor-pricing	追跡対象セット、競合比較、価格履歴から価格に関する質問に回答します

各小売分析スキルの最後には、Twelfth に接続した場合に変わる内容が記載されています。

このリポジトリの内容

このリポジトリにはクライアント設定のみが含まれています。サーバーは Twelfth AI Pty Ltd がホストおよび運用しています。

パス	内容
plugins/twelfth/	プラグイン。Cursor（mcp.json）および Claude Code（.mcp.json）用の MCP 設定と、上記 8 つのスキルが含まれます
.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