LobbyStack

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

团队为何使用 LobbyStack

大多数 AI 接待员工具都是封闭的、价格昂贵，而且难以适配实际业务流程。LobbyStack 则与众不同。

• 默认开源。 查看代码、自行托管、扩展功能，并掌控自己的数据。
• 专为真实电话通话打造。 处理自然语音对话、打断、实时转接，以及为团队留言。
• 通话和短信集中管理。 在同一个控制面板中查看通话、录音、转录文本和收到的短信。
• 内置日程安排。 通过 Google Calendar 预约、改期和取消预约。
• 专为小型企业设计。 提供引导式设置、透明定价，不会将功能限制为仅供企业客户使用。
• 人工兜底。 在 AI 不应独自处理某些事项时转接电话或升级留言。

核心功能

☎️ AI 电话接待员

LobbyStack 使用基于企业信息训练的自然语音代理接听来电。它可以回答常见问题、收集来电者信息、记录留言、筛选需求、提供预约时段，并在需要时转接给人工。

💬 短信

LobbyStack 会保存发送到企业号码的短信并提醒团队。你可以在控制面板中查看对话并手动回复。AI 不会回复短信；STOP 和 HELP 会收到固定回复。

📅 预约安排

LobbyStack 可连接 Google Calendar、Cal.com 或 Calendly，检查可用时间、提供时段、预约，并在来电者同意后发送确认短信，以及在预约前 24 小时发送一条提醒短信。来电者也可以在之后的通话中改期或取消预约。

📚 知识库

上传企业信息、常见问题、服务、价格、政策和内部备注。AI 会利用这些知识准确、一致地回答问题。

🧑‍💼 人工转接

需要人工响应时，LobbyStack 可以转接实时通话、记录留言，或通过电子邮件或选择加入的短信通知团队。

📥 共享收件箱

在一个控制面板中查看通话、短信对话、转录文本、录音、预约和客户信息。

🔌 集成

LobbyStack 可将预约写入 Google Calendar、Cal.com 或 Calendly。REST API、签名 Webhook、Zapier 和 MCP 服务器 可将其连接到其他工具。目前尚不支持与 CRM 或诊所管理软件同步。

使用场景

LobbyStack 可适配多种本地企业工作流程：

• 诊所和医疗机构
• 美容院、水疗中心和理发店
• 汽车维修店
• 家庭服务公司
• 餐厅
• 牙科诊所
• 律师事务所和专业服务机构
• 物业管理公司
• 任何通过电话接收预约、价格、营业时间或可用情况咨询的企业

产品功能

功能领域	提供的功能
语音接待	由 OpenAI GPT-Live 接听来电和浏览器通话，电话号码由 Twilio 或 Telnyx 提供。
企业知识	根据结构化企业信息、文本条目、文档和导入的网站页面回答问题。
预约	根据服务安排日程、检查可用时间并交接日历。
预约变更	通过查找和验证预约，实现更安全的取消和改期流程。
人工转接	实时转接，以及为需要员工处理的通话创建后续任务。
消息	收到短信并手动回复，同时关联客户历史记录。
网站小组件	可嵌入的聊天、潜在客户信息收集和浏览器通话，并提供按站点设置的访问控制。受限：除非设置 WIDGET_KEY_ISSUANCE_ENABLED=true，否则不会启用新的小组件密钥。
MCP 服务器	位于 /api/mcp 的 Model Context Protocol 服务器，可让 Claude、ChatGPT 和其他助手读取通话记录并预约。
控制面板	集中查看通话、消息、联系人、预约、录音、转录文本、后续跟进和分析数据。
用量和账单	托管套餐、语音用量、提醒短信、转接尝试、存储和支出上限。
使用自己的 API 密钥	自托管部署可使用自己的 Twilio 或 Telnyx、兼容 OpenAI 的 AI、日历、电子邮件、分析和账单服务提供商凭据。

MCP 服务器

LobbyStack 运行 Model Context Protocol 服务器，因此你可以将 Claude、ChatGPT、Claude Code、Cursor、VS Code 或任何其他 MCP 客户端连接到企业，并用自然语言提问：“昨天谁打过电话但没有预约？”或“预约 Dana Whitfield 在周二上午进行清洁服务。”

设置	值
服务器 URL	https://app.lobbystack.com/api/mcp（自托管：https://<your-domain>/api/mcp）
传输方式	Streamable HTTP
身份验证	使用 LobbyStack 登录（OAuth），或使用 Authorization: Bearer <API key>
注册表名称	官方 MCP Registry 中的 io.github.lobbystack/lobbystack

将其添加到 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。白标合作伙伴还可使用额外工具来管理其合作伙伴控制台。

实现代码位于 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
语音	通过 Twilio Elastic SIP Trunking 或 Telnyx SIP 连接，使用 SIP 和 WebRTC 运行 OpenAI GPT-Live
代理	Vercel AI SDK、gpt-6-luna 或任何兼容 OpenAI 的模型
MCP	通过 Streamable HTTP 运行的 @modelcontextprotocol/server，支持 OAuth 或 API 密钥

托管服务与开源

LobbyStack 是开源软件，同时提供托管云服务。

如果希望由服务方管理产品，请使用 LobbyStack Cloud。你仍可通过应用控制接待员行为、知识、服务、规则、号码、集成和团队工作流程。

如果团队希望在自己的基础设施上运行整个技术栈、使用自己的 API 密钥，并使用自己的 PostgreSQL、Twilio 或 Telnyx、兼容 OpenAI 的 AI、日历、分析、账单和电子邮件服务提供商账户，则可选择自托管。

要在 Railway 上自托管，请部署 LobbyStack 模板。Railway 会生成所有密钥和数据库密码，你只需输入 OpenAI API 密钥和 Twilio 凭据。

部署后，在 Railway 中设置几个变量：

• **电子邮件：**在 worker 上设置 SMTP_* 和 EMAIL_FROM。缺少这些变量时，密码重置、验证码和邀请功能将无法使用。
• **电话通话：**将 OpenAI webhook 指向 https://your_admin_domain/api/webhooks/openai/live，在 admin 上将其密钥设为 OPENAI_WEBHOOK_SECRET，并在 worker 上将你的 Twilio Elastic SIP trunk 设为 TWILIO_SIP_TRUNK_SID。请参阅 docs/voice/runtime.md。如需在部分国家或所有国家使用 Telnyx，请按照使用 Telnyx中的说明操作。
• **可选：**在 worker 上设置 FIRECRAWL_API_KEY 以导入网站，并在 admin 上设置 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET 以使用 Google Calendar。
• **自定义域名：**在 admin 上设置 APP_BASE_URL。其他 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. 在接听真实来电前，配置 AI 设置、服务、知识和规则。

完整的托管版使用流程请参阅设置指南。

运行本地开发环境

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

本地开发会将录音和上传文件存储在 .lobbystack/storage 下。需要测试兼容 S3 的服务时，请设置 STORAGE_PROVIDER=s3。

默认开发流程包含模拟服务提供商，因此贡献者无需真实的 Twilio、AI、日历或电子邮件凭据，也能测试各项流程。服务提供商设置说明请参阅文档。

使用 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 License 授权。