API ВЕГА

Подключите AI-ассистентов, которыми уже пользуется ваша команда, к рабочему пространству Twelfth.

Claude · ChatGPT · GitHub Copilot · Gemini · Cursor · Claude Code · любой клиент MCP

Twelfth — коммерческое рабочее пространство для команд, работающих в розничной торговле и с категориями товаров. Размещённый на сервере MCP позволяет ассистенту получать данные о товарах, поставщиках, продажах, запасах, ценах, проектах и текущих задачах, доступные вошедшему в систему пользователю. Благодаря этому ответы формируются на основе данных рабочего пространства Twelfth, а не таблиц, вставленных в чат.

Адресhttps://api.twelfth.ai/mcp (Streamable HTTP)
ВходOAuth 2.1 с учётной записью Twelfth. Выберите рабочее пространство и разрешите инструменты чтения — копировать ключ не нужно
ДоступТолько чтение. Ассистенты не могут создавать, изменять или фиксировать данные
Область доступаОдно рабочее пространство с правами подключившегося пользователя: его роль, полномочия и категории. Владельцы и администраторы видят все подключения и могут завершить любое из них
Реестр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 read tools"]
    S -- "2 · scoped token" --> A
    A -- "3 · read-only 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" }
  }
}

Запустите сервер и войдите в Twelfth, когда VS Code предложит это сделать. Затем используйте инструменты в 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

Затем выполните команду /mcp auth twelfth в Gemini CLI, чтобы войти в систему. Расширение добавит сервер и навык twelfth-workspace.

Claude, ChatGPT, Gemini и другие клиенты

Добавьте пользовательский коннектор с адресом https://api.twelfth.ai/mcp и завершите вход в Twelfth. Инструкции для отдельных ассистентов: twelfth.ai/ai.

Серверы и скрипты

Владелец или администратор рабочего пространства может создать ключ с названием и ограниченным набором инструментов в разделе

Настройки → AI и агенты → Создать API key и передавать его в заголовке

Authorization: Bearer .

Безопасность и управление доступом

МераКак это работает
Только чтениеВсе инструменты предназначены для чтения. Решения проверяют и фиксируют пользователи в Twelfth
Минимально необходимые праваOAuth-подключение наследует роль и полномочия пользователя и перестаёт работать, когда он покидает рабочее пространство. Доступные инструменты выбираются при предоставлении разрешения
Контроль со стороны администраторовВладельцы и администраторы видят все подключения, а также клиент и версию, которые подключились, и могут завершить любое из них. После завершения подключения следующий запрос будет отклонён
КлючиСоздавать ключи могут только владельцы и администраторы. Ключам присваивают названия в соответствии со средой, ограничивают их выбранными инструментами, хранят в хешированном виде и показывают только один раз
АудитДля каждого вызова записываются инструмент, результат, время и длительность. Результаты инструментов не сохраняются и не передаются в аналитику — фиксируется только их размер
Соответствие требованиямИнформация о мерах контроля, субподрядчиках и программах SOC 2 / ISO 27001: trust.twelfth.ai

Содержимое этого репозитория

В этом репозитории находятся только конфигурации клиентов; сервер размещает и обслуживает Twelfth AI Pty Ltd.

ПутьСодержимое
plugins/twelfth/Плагин: конфигурация MCP для Cursor (mcp.json) и Claude Code (.mcp.json), а также навык twelfth-workspace, который помогает ассистенту правильно использовать инструменты
.cursor-plugin/, .claude-plugin/Манифесты маркетплейса для Cursor и Claude Code
gemini-extension.json, skills/Расширение Gemini CLI. Каталог skills/ содержит копию навыков плагина; команда node scripts/validate-template.mjs завершится с ошибкой, если копии разойдутся

Поддержка

Twelfth AI Pty Ltd · ACN 695 769 138 · Австралия

Содержимое этого репозитория распространяется по лицензии MIT. Использование сервиса Twelfth регулируется условиями.

smithery-verification=0c586824f907c08ca5140641c9ddc0c07e5e1574fd305497c14360c7f4ded531