warpdrive MCP
MCP-сервер самохостимой CRM на замену Pipedrive: ассистент ищет сделки и контакты, ведет задачи и двигает сделки по воронке
- 931 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ассистент создает и меняет сделки, контакты и задачи с правами вошедшего пользователя, поэтому запросы на запись стоит проверять в клиенте до подтверждения
- Содержимое писем и данные клиентов попадают в контекст модели у вендора ассистента
- При открытой регистрации клиентов посторонний может подобрать название и выманить согласие пользователя
Установка
- Работает в
Ручная установка
docker compose up -d --buildСначала скопируйте `.env.example` в `.env` и заполните домен, Google OAuth, хранилище и секреты. Для MCP добавьте `MCP_ENABLED=true` и `OAUTH_SIGNING_KEY`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ассистент создает и меняет сделки, контакты и задачи с правами вошедшего пользователя, поэтому запросы на запись стоит проверять в клиенте до подтверждения
- Содержимое писем и данные клиентов попадают в контекст модели у вендора ассистента
- При открытой регистрации клиентов посторонний может подобрать название и выманить согласие пользователя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
warpdrive — открытая CRM для отделов развития бизнеса: воронка со стадиями, карточка сделки, контакты, организации и двусторонняя почта Gmail. Она ставится на ваш сервер через Docker и хранит данные в вашем Postgres. В CRM встроен MCP-сервер, о нем эта карточка. Сервер принимает подключения по Streamable HTTP с входом через OAuth. Ассистент ищет сделки, лиды, людей, организации и задачи, смотрит воронки и сводку по ним. Он также создает и обновляет записи, переводит сделку на другую стадию, превращает лид в сделку, закрывает задачу и добавляет заметку. Работа с почтой ограничена чтением писем и черновиками. Каждый вызов выполняется от имени пользователя, который прошел OAuth, поэтому действуют его права и правила видимости. Инструментов удаления записей CRM в сервере нет.
Для кого. Менеджерам по продажам и руководителям отделов развития, которые держат CRM на своем сервере и хотят вести сделки через Claude, ChatGPT или Cursor.
Подходит, если
- Утром нужна сводка: какие сделки зависли на стадии и какие задачи просрочены
- После звонка менеджер диктует итог, а ассистент добавляет заметку к сделке и создает задачу на следующий шаг
- Лиды из входящих надо разобрать: ассистент находит нужные и превращает их в сделки
- Нужен черновик ответа клиенту по цепочке писем из карточки сделки, который вы проверите и отправите сами
- Данные клиентов по правилам компании остаются на своем сервере, и ассистент подключается к нему
Не подходит, если
- Нужна CRM как облачная услуга без своего сервера: warpdrive разворачивают самостоятельно
- Требуется удаление или архивация записей через ассистента: таких инструментов в сервере нет
- Нужны продукты, счета, прогнозы, мультивалютность или автоматизация процессов: в warpdrive эти разделы автор исключил
- Вы работаете в 1С или amoCRM: для них в каталоге есть отдельные MCP-серверы
Пример запроса к агенту
Покажи сделки, которые больше двух недель стоят на стадии переговоров, и создай по каждой задачу позвонить клиенту в четвергMCP
- Транспорт
- http
- Авторизация
- OAuth
Переменные окружения
MCP_ENABLEDобязательная- Включает MCP-сервер и адреса OAuth; при значении false они отвечают 404
OAUTH_SIGNING_KEYобязательная, секрет- Ключ подписи токенов: 32 байта в base64, например из `openssl rand -base64 32`
OAUTH_REGISTRATION- Регистрация клиентов: по умолчанию open, значение disabled закрывает ее
Ограничения
Сервер работает только при развернутой warpdrive: нужны Docker, Postgres, домен с HTTPS и ключ подписи `OAUTH_SIGNING_KEY`, который задают в окружении и не меняют между перезапусками. Пошаговое подключение в документации описано для Claude Desktop; другие клиенты должны уметь удаленный Streamable HTTP и OAuth.
Регистрация клиентов по умолчанию открыта: любой желающий может зарегистрировать клиент с произвольным названием, которое увидит пользователь на экране согласия. После подключения нужных клиентов ее закрывают параметром `OAUTH_REGISTRATION=disabled`.
Проект сделан для одной команды и работает у автора в продакшене. Двусторонняя почта требует настроенного клиента Google OAuth.
Как отключить. Отключите сервер параметром `MCP_ENABLED=false`: тогда адреса MCP и OAuth отвечают ошибкой 404. Отдельный доступ клиента отзывают в Settings, Connected apps, кнопкой Revoke. Можно удалить коннектор в настройках самого клиента.
Частые вопросы
Как подключить warpdrive к Claude Desktop?
В настройках Claude откройте Connectors и добавьте свой коннектор: имя и адрес `https://<домен>/api/mcp`. Затем нажмите Connect, войдите в warpdrive и подтвердите доступ на экране согласия. Адрес сервера и шаги показаны в самой CRM в Settings, Connected apps.
Что ассистент может изменить в CRM?
Создавать и обновлять сделки, лиды, людей, организации и задачи, переводить сделку на другую стадию, превращать лид в сделку, закрывать задачу и добавлять заметку. Удаление записей и архивация недоступны.
Может ли ассистент отправить письмо клиенту?
Нет. В сервере есть чтение писем и работа с черновиками: создание, правка и удаление собственных неотправленных черновиков. Отправку делает человек.
Видит ли ассистент все сделки компании?
Он видит то же, что сам пользователь, прошедший вход. Правила видимости и права на правку действуют в каждом вызове.
Как закрыть подключение клиента?
В warpdrive откройте Settings, затем Connected apps, и нажмите Revoke рядом с клиентом. Все его токены отзываются, и для нового доступа клиент проходит OAuth заново.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОткрытая CRM для малых команд с MCP: контакты, сделки и задачи доступны Claude и другим агентам, черновики ответов за вами
MCP для руководителя отдела продаж в amoCRM
amoCRM ROP MCP Server
MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров
MCP-сервер для amoCRM и Kommo: сделки, контакты, задачи и отчеты по воронке, зависшие сделки и просроченные задачи менеджеров
MCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика
Минимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен
MCP-сервер для Odoo: агент читает, создает и обновляет записи ERP, ищет данные и вызывает бизнес-операции через права Odoo
Коротко о README
README называет warpdrive открытой CRM на замену Pipedrive, перечисляет разделы (воронка, сделки, контакты, почта, команда) и сравнивает их с Pipedrive таблицей. Дальше идут стек, локальный запуск, развертывание на одном сервере с автоматическим HTTPS и состояние проекта: CRM работает в продакшене у одной команды. Подробности про MCP вынесены в отдельный документ docs/mcp-server.md.