LobbyStack

npx add-mcp 'https://app.lobbystack.com/api/mcp'

Почему команды выбирают LobbyStack

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

• Открытый исходный код по умолчанию. Изучайте код, размещайте платформу самостоятельно, расширяйте её и сохраняйте контроль над своими данными.
• Создан для реальных телефонных звонков. Обрабатывайте естественные голосовые диалоги, перебивания, переводы звонков в реальном времени и сообщения для команды.
• Звонки и сообщения в одном месте. Просматривайте звонки, записи, расшифровки и входящие сообщения на одной панели управления.
• Встроенное планирование. Записывайте клиентов на приём, переносите и отменяйте записи через Google Calendar.
• Разработан для малого бизнеса. Пошаговая настройка, прозрачные цены и отсутствие ограничений, когда функции доступны только корпоративным клиентам.
• Передача человеку. Переводите звонки или передавайте сообщения команде, если ИИ не должен обрабатывать их самостоятельно.

Основные функции

☎️ ИИ-администратор для телефонных звонков

LobbyStack отвечает на входящие звонки с помощью естественно звучащего голосового агента, обученного на информации о вашем бизнесе. Он может отвечать на распространённые вопросы, собирать данные звонящих, принимать сообщения, уточнять запросы, предлагать время для записи и при необходимости переводить звонок сотруднику.

💬 Текстовые сообщения

LobbyStack сохраняет сообщения, отправленные на номер вашего бизнеса, и оповещает команду. Вы можете прочитать переписку и ответить вручную на панели управления. ИИ не отвечает на сообщения; на STOP и HELP отправляются фиксированные ответы.

📅 Запись на приём

LobbyStack подключается к Google Calendar, Cal.com или Calendly, проверяет доступность, предлагает свободное время, записывает клиентов на приём и отправляет подтверждение по SMS, а также одно напоминание за 24 часа до приёма, если звонящий согласен. При последующем звонке клиенты также могут перенести или отменить запись.

📚 База знаний

Загружайте информацию о бизнесе, часто задаваемые вопросы, услуги, цены, правила и внутренние заметки. ИИ использует эти знания, чтобы отвечать точно и последовательно.

🧑‍💼 Передача сотруднику

LobbyStack может перевести звонок в реальном времени, принять сообщение или уведомить команду по электронной почте либо по SMS, если человек должен ответить.

📥 Общая папка входящих

Просматривайте звонки, переписки по SMS, расшифровки, записи, встречи и данные клиентов на одной панели управления.

🔌 Интеграции

LobbyStack записывает клиентов в Google Calendar, Cal.com или Calendly. REST API, подписанные вебхуки, Zapier и сервер MCP позволяют подключить платформу к другим инструментам. Синхронизации с CRM или системами управления медицинской практикой пока нет.

Сценарии использования

LobbyStack можно адаптировать для самых разных рабочих процессов местного бизнеса:

• Клиники и медицинские кабинеты
• Салоны, спа-салоны и парикмахерские
• Автомастерские
• Компании, оказывающие услуги на дому
• Рестораны
• Стоматологические кабинеты
• Юридические фирмы и компании, оказывающие профессиональные услуги
• Управляющие недвижимостью
• Любые предприятия, которым по телефону задают вопросы о записи, ценах, часах работы или доступности

Разделы продукта

Раздел	Что он предоставляет
Голосовая приёмная	Входящие телефонные звонки и звонки через браузер, на которые отвечает OpenAI GPT-Live; телефонные номера предоставляются Twilio или Telnyx.
Информация о бизнесе	Ответы на основе структурированных сведений о бизнесе, текстовых записей, документов и импортированных страниц сайта.
Запись	Планирование с учётом услуг, проверкой доступности и передачей данных в календарь.
Изменение записи	Надёжные сценарии отмены и переноса с поиском записи и проверкой данных.
Передача сотруднику	Перевод звонка в реальном времени и задачи для последующей обработки звонков, требующих внимания персонала.
Сообщения	Входящие сообщения с ручными ответами, связанные с историей клиента.
Виджет сайта	Встраиваемый чат, сбор потенциальных клиентов и звонки через браузер с настройками доступа для каждого сайта. Ограничение: новые ключи виджета отключены, если не задано WIDGET_KEY_ISSUANCE_ENABLED=true.
Сервер MCP	Сервер Model Context Protocol по адресу /api/mcp, который позволяет Claude, ChatGPT и другим ассистентам просматривать звонки и записывать клиентов на приём.
Панель управления	Звонки, сообщения, контакты, встречи, записи, расшифровки, последующие действия и аналитика в одном месте.
Использование и оплата	Тарифы облачного сервиса, использование голосовой связи, SMS-оповещения, попытки перевода звонков, хранилище и лимиты расходов.
Использование собственных API-ключей	В самостоятельно развёрнутых экземплярах можно использовать собственные учётные данные Twilio или Telnyx, ИИ с поддержкой OpenAI, календаря, электронной почты, аналитики и платёжного провайдера.

Сервер MCP

LobbyStack запускает сервер Model Context Protocol, поэтому вы можете подключить Claude, ChatGPT, Claude Code, Cursor, VS Code или любой другой клиент MCP к бизнесу и задавать вопросы обычным языком: «Кто звонил вчера, но не записался?» или «Запиши Дану Уитфилд на уборку во вторник утром».

Параметр	Значение
URL сервера	https://app.lobbystack.com/api/mcp (для самостоятельного размещения: https://<your-domain>/api/mcp)
Транспорт	Streamable HTTP
Аутентификация	Войдите в LobbyStack (OAuth) или используйте Authorization: Bearer <API key>
Название в реестре	io.github.lobbystack/lobbystack в официальном реестре MCP

Добавьте сервер в Claude Code:

claude mcp add --transport http lobbystack https://app.lobbystack.com/api/mcp

Сервер предоставляет 18 инструментов для одного бизнеса. Для каждого инструмента требуется область доступа, а все изменения фиксируются в журнале аудита бизнеса.

Инструменты	Область доступа
get_business, list_services, list_staff	business:read
update_business_hours	business:write
list_calls, get_call	calls:read
search_contacts, get_contact	contacts:read
create_contact, update_contact	contacts:write
list_appointments, get_appointment, check_availability	appointments:read
book_appointment, cancel_appointment, reschedule_appointment	appointments:write
list_messages	messages:read
add_knowledge	knowledge:write

Инструменты только для чтения используют readOnlyHint, а инструменты, отменяющие, перемещающие или заменяющие данные, — destructiveHint. Партнёры White Label получают дополнительные инструменты для управления своей партнёрской консолью.

Реализация находится в apps/admin/src/lib/mcp/: server.ts создаёт McpServer и регистрирует инструменты из tools.ts и partner-tools.ts, а apps/admin/app/api/mcp/route.ts обслуживает его. В руководстве по серверу MCP описаны области доступа, ошибки и ограничения.

Технологии

Уровень	Основные компоненты
Приложение	Next.js, React, Tailwind CSS, shadcn/ui
Серверная часть	PostgreSQL, Drizzle ORM, Redis, BullMQ
Голосовая связь	OpenAI GPT-Live через SIP и WebRTC, с использованием Twilio Elastic SIP Trunking или SIP-подключений Telnyx
Агент	Vercel AI SDK, gpt-6-luna или любая модель с поддержкой OpenAI
MCP	@modelcontextprotocol/server через Streamable HTTP, с OAuth или API-ключами

Облачный сервис и открытый исходный код

LobbyStack — это проект с открытым исходным кодом и облачным сервисом.

Выбирайте LobbyStack Cloud, если хотите, чтобы продуктом управляли за вас. При этом вы по-прежнему контролируете поведение администратора, базу знаний, услуги, правила, номера, интеграции и рабочие процессы команды через приложение.

Размещайте платформу самостоятельно, если ваша команда хочет запускать её на собственной инфраструктуре, использовать собственные API-ключи и учётные записи PostgreSQL, Twilio или Telnyx, ИИ с поддержкой OpenAI, календаря, аналитики, платёжного провайдера и электронной почты.

Чтобы разместить платформу самостоятельно на Railway, разверните шаблон LobbyStack. Railway создаст все секреты и пароли базы данных; вам останется указать API-ключ OpenAI и учётные данные Twilio.

После развёртывания задайте несколько переменных в Railway:

• Электронная почта: SMTP_* и EMAIL_FROM для worker. Без них не будут работать сброс пароля, коды подтверждения и приглашения.
• Телефонные звонки: вебхук OpenAI на https://your_admin_domain/api/webhooks/openai/live, его секрет в качестве OPENAI_WEBHOOK_SECRET для admin и транк Twilio Elastic SIP в качестве TWILIO_SIP_TRUNK_SID для worker. См. docs/voice/runtime.md. Чтобы использовать Telnyx в некоторых странах или во всех странах, следуйте инструкциям в разделе Использование Telnyx.
• Необязательно: FIRECRAWL_API_KEY для worker для импорта сайтов, а также GOOGLE_CLIENT_ID и GOOGLE_CLIENT_SECRET для admin для Google Calendar.
• Пользовательский домен: APP_BASE_URL для admin. Остальные переменные URL ссылаются на него.

В руководстве по самостоятельному размещению описаны все шаги.

Полный контроль над продуктом в облачном приложении. Владение инфраструктурой при самостоятельном размещении. В обоих случаях используется одно и то же ядро с открытым исходным кодом.

Архитектура для участников проекта

LobbyStack — это монорепозиторий TypeScript, в котором PostgreSQL служит надёжным источником данных. OpenAI размещает аудио звонков; приложение admin запускает каждый звонок, а worker обрабатывает его.

apps/
  admin/           Next.js dashboard and HTTP API
  worker/          asynchronous jobs, outbox dispatch, and live calls
packages/embed/    Vite bundle for the embeddable website widget loader
packages/          database, domain, agent core, jobs, providers, telemetry, and shared contracts
mintlify/          public documentation source
docs/              architecture notes, ADRs, provider docs, and validation notes

Ознакомьтесь с обзором самостоятельного размещения, чтобы узнать о провайдерах и требованиях к развёртыванию, или воспользуйтесь руководством по Docker Compose для официальной конфигурации на одном сервере.

Начало работы

Использование облачного приложения

1. Создайте учётную запись LobbyStack.
2. Подтвердите номер мобильного телефона.
3. Импортируйте сведения с сайта или пропустите этот шаг и добавьте их вручную позже.
4. Выберите тариф.
5. Подключите номер компании на тарифе Starter или Pro.
6. Настройте параметры ИИ, услуги, базу знаний и правила, прежде чем принимать реальные звонки.

Полное руководство по работе с облачным сервисом находится в руководстве по настройке.

Локальная разработка

cp .env.example .env
pnpm install
docker compose up -d postgres redis
pnpm db:migrate
pnpm dev

При локальной разработке записи и загруженные файлы хранятся в .lobbystack/storage. Задайте STORAGE_PROVIDER=s3, если нужно протестировать сервис, совместимый с S3.

В стандартный процесс разработки входят имитационные провайдеры, поэтому участники проекта могут проверять рабочие процессы без действующих учётных данных Twilio, ИИ, календаря или электронной почты. Инструкции по настройке провайдеров находятся в документации.

Развёртывание с помощью Docker Compose

git clone https://github.com/lobbystack/lobbystack.git
cd lobbystack
pnpm install
cp .env.example .env
# Replace every placeholder before exposing the stack.
docker compose --env-file .env up -d --build

Стек использует журналы stdout и конечные точки проверки состояния, не запуская контейнеры мониторинга. Задайте OTEL_EXPORTER_OTLP_ENDPOINT и OTEL_EXPORTER_OTLP_HEADERS, чтобы отправлять телеметрию сервера в PostHog или другую систему, совместимую с OTLP.

Требования, локальную проверку и запуск в рабочей среде, вспомогательные скрипты и устранение неполадок см. в руководстве по самостоятельному размещению с Docker Compose.

Участие в разработке

Мы приветствуем вклад в проект. Начните с CONTRIBUTING.md, размещайте долговременную бизнес-логику в доменном слое и слое базы данных, а инструменты администратора — в ядре агента.

Перед созданием PR выполните:

pnpm typecheck
pnpm build
pnpm test

Лицензия

LobbyStack распространяется по условиям лицензии MIT.