Twenty CRM — open-source CRM нового поколения

CRM с открытым исходным кодом, современным интерфейсом, REST и GraphQL API, автоматизациями без кода и Apps framework — платформой расширений на TypeScript. Twenty можно развернуть на своём сервере или использовать в облаке; вариант Cloud предоставляет каждому рабочему пространству нативный MCP-сервер (Model Context Protocol, протокол подключения ИИ-ассистентов к внешним системам).

Сведения о функциях, интерфейсах, лимитах и ценах сверены со снимками официальных источников, полученными 2 сентября 2026 года.

Оглавление

1. Что такое Twenty — варианты поставки и эксплуатационные ограничения.
2. Основные возможности Twenty — данные, автоматизации, API и AI-функции.
3. ИИ-чат, агенты и MCP — текущий статус AI-возможностей и подключение ассистентов.
4. Подключение и адреса API — схема API, авторизация и лимиты.
5. Apps framework — создание расширений на TypeScript.
6. Workflow и внешние HTTP-запросы — действия и ограничения автоматизаций.
7. Тарифы и модель затрат — Cloud и self-hosted.
8. Полезные сценарии — миграция, интеграции, приложения и ИИ-ассистенты.
9. Проверка подключения API — наблюдаемый результат теста.
10. Официальные ссылки — документация и репозиторий.

Что такое Twenty

Twenty — CRM с открытым исходным кодом. Она работает с контактами, компаниями, сделками, задачами и заметками, поддерживает собственные объекты и автоматизации.

Проект позиционируется как открытая и расширяемая альтернатива закрытым CRM-платформам. На 2 сентября 2026 года официальный репозиторий показывает около 56 000 звёзд на GitHub, а ветка релизов достигла версии 2.37.0.

Twenty доступна в двух вариантах:

• Self-hosted: инфраструктура и обновления находятся под вашим контролем;
• Cloud: сервисом управляет команда Twenty, а рабочее пространство получает нативный MCP-сервер.

Основные возможности Twenty

ИИ-чат, агенты и MCP

ИИ-возможности Twenty находятся на разных стадиях готовности. Встроенный AI-чат представлен на официальном сайте, Apps framework включает skills и agents — переиспользуемые инструкции и автономных помощников, а действие AI Agent внутри workflow помечено в документации как Coming Soon.

AI-чат

Официальный сайт показывает AI-чат как встроенный интерфейс для работы с данными CRM. Перед использованием на рабочих данных проверьте доступные операции в своей версии, конфигурации рабочего пространства и с учётом прав пользователя.

AI Agent в workflow

Документация описывает будущий шаг AI Agent со следующей конфигурацией:

• выбор существующего или стандартного агента;
• промпт с переменными предыдущих шагов;
• инструменты для взаимодействия с CRM;
• структурированный ответ, если у агента задана соответствующая схема;
• роль, ограничивающая доступ агента к данным.

Перечисленные в документации сценарии включают анализ и суммаризацию данных, классификацию записей, генерацию текста и принятие решений. На 2 сентября 2026 года строить производственный процесс вокруг этого шага рано: официальная страница всё ещё содержит пометку Coming Soon.

MCP

Официальный сайт подтверждает нативный MCP-сервер для каждого Cloud workspace. Совместимый ИИ-ассистент подключается через OAuth и может читать и изменять CRM-данные.

Для self-hosted-инсталляций наличие и способ настройки MCP необходимо проверять по документации конкретной версии. Переданные источники не подтверждают универсальный адрес /<mcp> или подключение self-hosted MCP по API-ключу.

Подключение и адреса API

API Twenty генерируется из схемы конкретного рабочего пространства. Если вы добавите пользовательский объект, для него появятся REST- и GraphQL-операции по тем же принципам, что и для стандартных объектов.

Базовые адреса

Основные группы:

• Core API: /rest/ и /graphql/;
• Metadata API: /rest/metadata/ и /metadata/.

У Twenty нет статической схемы API. Endpoint и поля конкретного рабочего пространства берите из документации, доступной после создания ключа.

Ключ создаётся в Settings → API & Webhooks → + Create key. Значение показывается один раз.

Пример заголовка запроса:

Authorization: Bearer YOUR_API_KEY

Не сохраняйте рабочий ключ в репозитории или тексте workflow. Для ограничения доступа назначьте ключу отдельную роль в Settings → Members → Roles → Assignment.

Актуальные лимиты

По официальной документации на 2 сентября 2026 года:

• 100 запросов в минуту;
• до 60 записей в одной пакетной операции;
• REST и GraphQL поддерживают пакетное создание, изменение и удаление;
• GraphQL дополнительно поддерживает пакетный upsert, то есть создание или обновление записи одним вызовом.

Документация и интерактивная площадка для схемы конкретного рабочего пространства доступны в Settings → API & Webhooks после создания ключа.

Apps framework

Apps framework позволяет оформлять расширения Twenty как приложения на TypeScript. Приложение может содержать:

• пользовательские объекты и поля;
• серверные логические функции;
• React-компоненты для интерфейса Twenty;
• представления и навигацию;
• AI skills и agents;
• собственные страницы и компоновки карточек.

Актуальный способ создать проект:

npx create-twenty-app@latest my-twenty-app
cd my-twenty-app
yarn twenty dev

Для локальной разработки нужны Node.js 24.5+, Yarn 4 и Docker. При локальном сценарии генератор запускает сервер Twenty в Docker на http://localhost:2020. Если Docker не запущен, после его запуска продолжите командой yarn twenty docker:start. Для подключения к существующему серверу используйте параметр --url; удалённые серверы авторизуют CLI через OAuth.

Для предварительного просмотра изменений и однократной синхронизации используются:

yarn twenty plan
yarn twenty apply

yarn twenty plan показывает изменения без применения. yarn twenty apply собирает приложение и синхронизирует его с авторизованным сервером; удаляющие изменения требуют подтверждения.

Workflow и внешние HTTP-запросы

В workflow доступны действия для создания, поиска, изменения, удаления и upsert записей. Upsert создаёт новую запись или обновляет существующую по совпадающему идентификатору.

Можно добавлять итераторы, фильтры, задержки, отправку email, JavaScript и HTTP-запросы к внешним API.

Действие Search Records возвращает максимум 200 записей. Для больших объёмов используйте точные фильтры или обрабатывайте данные порциями по расписанию.

Тарифы и модель затрат

На 2 сентября 2026 года официальный сайт указывает:

Облачные цены и состав планов могут измениться. Перед покупкой проверьте актуальную страницу Twenty.

Полезные сценарии

Замена закрытой CRM для небольшой команды

Задача: получить настраиваемую CRM и контролировать инфраструктуру.

Исходные данные: собственный сервер и исходные данные в CSV.

Действия: разверните self-hosted Twenty, настройте поля и workflow под процесс продаж, затем импортируйте данные через CSV. Для миграции на 50 000 и более записей используйте API, а пакетные операции разбивайте с учётом лимита 60 записей.

Результат: несколько импортированных контактов и компаний открываются в Twenty с ожидаемыми полями; тестовая сделка создаётся в нужной модели данных.

Ограничение: команда самостоятельно отвечает за обновления, резервные копии и доступность сервера.

Интеграция CRM с внутренней системой

Задача: синхронизировать клиентов и сделки с другим приложением.

Исходные данные: рабочее пространство Twenty и API-ключ с отдельной ролью.

Действия: получите схему рабочего пространства через Metadata API, выполните тестовый запрос чтения к Core API, затем настройте периодическую синхронизацию.

Результат: тестовая запись, созданная через API, появляется в интерфейсе с ожидаемыми полями.

Ограничение: учитывайте лимит 100 запросов в минуту и пакет до 60 записей.

Собственное приложение поверх Twenty

Задача: добавить специальную модель данных и интерфейс.

Исходные данные: проект TypeScript, Node.js 24.5+, Yarn 4, Docker и тестовый сервер Twenty.

Действия: создайте приложение через create-twenty-app, определите объекты и React-компоненты, проверьте изменения командой yarn twenty plan, затем синхронизируйте проект.

Результат: приложение появляется в Settings → Applications → Your Apps, а добавленные сущности доступны в тестовом рабочем пространстве.

Ограничение: между версиями SDK возможны несовместимые изменения. Перед обновлением проверяйте release notes.

ИИ-ассистент для Cloud workspace

Задача: дать совместимому ассистенту контролируемый доступ к CRM.

Исходные данные: Cloud workspace и ассистент, поддерживающий OAuth.

Действия: подключите рабочее пространство через OAuth, сначала разрешите чтение ограниченного набора данных, проверьте поиск тестовой записи, затем отдельно протестируйте безопасное изменение.

Результат: тестовое поле, созданное или изменённое ассистентом, отображается в Twenty, а доступ ассистента не выходит за пределы выданных прав.

Ограничение: подтверждённый нативный MCP относится к Cloud. Для self-hosted способ подключения проверяйте по документации конкретной версии.

Проверка подключения API

Минимальная проверка состоит из действий в документации конкретного рабочего пространства:

1. Создайте API-ключ в Settings → API & Webhooks → + Create key и назначьте ему отдельную роль.
2. Откройте документацию рабочего пространства в Settings → API & Webhooks.
3. Выберите существующий объект и выполните тестовый запрос на чтение в интерактивной площадке.

Проверка пройдена, если площадка возвращает ожидаемые записи, а роль ключа не даёт читать запрещённые данные. Команды и запросы из этого материала не запускались на рабочем рабочем пространстве.

Материал основан на официальной документации и снимках источников, полученных 2 сентября 2026 года.

Официальные ссылки

• Сайт Twenty
• Документация
• REST и GraphQL API
• Действия workflow
• Быстрый старт Apps framework
• Репозиторий и релизы
• Discord-сообщество

Следующий шаг

MCP (Model Context Protocol) — стандарт подключения ИИ к внешним системам

Если вы проектируете CRM-интеграцию или подключаете ИИ к рабочим данным, полезно заранее проверить модель данных и права доступа.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov