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 可配合許多在地企業的工作流程：

• 診所和醫療院所
• 美容院、SPA 和理髮店
• 汽車維修店
• 居家服務公司
• 餐廳
• 牙科診所
• 律師事務所和專業服務業
• 房產管理公司
• 任何透過電話接收預約、價格、營業時間或可預約時段相關問題的企業

產品功能區

功能區	提供的功能
語音接待	透過 Twilio Elastic SIP Trunking 或 Telnyx SIP 連線取得電話號碼，並由 OpenAI GPT-Live 接聽來電和瀏覽器通話。
業務知識	根據結構化業務資訊、文字項目、文件和匯入的網站頁面提供回答。
預約	根據服務項目安排預約、檢查可預約時段，並交由行事曆處理。
預約異動	透過預約查詢和驗證，安全地取消或改期。
真人轉接	即時轉接，以及為需要員工處理的通話建立後續工作。
訊息	收到的簡訊可手動回覆，並與客戶歷史紀錄連結。
網站小工具	可嵌入的聊天、潛在客戶資料收集和瀏覽器通話，並提供每個網站的存取控制。受限：除非設定 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 是以 PostgreSQL 作為持久化資料來源的 TypeScript 單一儲存庫。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 授權。