LobbyStack

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

Warum Teams LobbyStack nutzen

Die meisten KI-Empfangstools sind geschlossen, teuer und lassen sich nur schwer an reale Geschäftsabläufe anpassen. LobbyStack ist anders.

• Standardmäßig Open Source. Prüfe den Code, hoste die Lösung selbst, erweitere sie und behalte die Kontrolle über deine Daten.
• Für echte Telefongespräche entwickelt. Führe natürliche Sprachgespräche, gehe mit Unterbrechungen um, leite Anrufe live weiter und nimm Nachrichten für dein Team entgegen.
• Anrufe und SMS an einem Ort. Sieh dir Anrufe, Aufzeichnungen, Transkripte und eingehende SMS im selben Dashboard an.
• Terminplanung integriert. Buche, verschiebe und storniere Termine über Google Calendar.
• Für kleine Unternehmen konzipiert. Geführte Einrichtung, transparente Preise und keine Funktionen, die nur Unternehmen vorbehalten sind.
• Übergabe an Menschen. Leite Anrufe weiter oder eskaliere Nachrichten, wenn die KI etwas nicht allein bearbeiten sollte.

Kernfunktionen

☎️ KI-Telefonempfang

LobbyStack nimmt eingehende Anrufe mit einem natürlich klingenden Sprachagenten entgegen, der mit Informationen über dein Unternehmen trainiert wurde. Er kann häufige Fragen beantworten, Anruferdaten erfassen, Nachrichten entgegennehmen, Anfragen qualifizieren, Terminzeiten anbieten und bei Bedarf an einen Menschen weiterleiten.

💬 Textnachrichten

LobbyStack speichert SMS, die an deine Geschäftsnummer gesendet werden, und benachrichtigt dein Team. Du kannst den Nachrichtenverlauf im Dashboard lesen und manuell antworten. Die KI beantwortet keine SMS; auf STOP und HELP werden festgelegte Antworten gesendet.

📅 Terminplanung

LobbyStack verbindet sich mit Google Calendar, Cal.com oder Calendly, prüft die Verfügbarkeit, schlägt Termine vor, bucht Termine und sendet eine Bestätigungs-SMS sowie eine Erinnerungs-SMS 24 Stunden vorher, sofern der Anrufer zustimmt. Anrufer können bei einem späteren Anruf auch Termine verschieben oder stornieren.

📚 Wissensdatenbank

Lade Unternehmensinformationen, häufig gestellte Fragen, Dienstleistungen, Preise, Richtlinien und interne Notizen hoch. Die KI nutzt dieses Wissen, um präzise und konsistente Antworten zu geben.

🧑‍💼 Übergabe an Menschen

LobbyStack kann einen laufenden Anruf weiterleiten, eine Nachricht aufnehmen oder das Team per E-Mail oder optionaler SMS benachrichtigen, wenn eine Person antworten muss.

📥 Gemeinsamer Posteingang

Sieh dir Anrufe, SMS-Verläufe, Transkripte, Aufzeichnungen, Termine und Kundendaten in einem Dashboard an.

🔌 Integrationen

LobbyStack bucht Termine in Google Calendar, Cal.com oder Calendly. Eine REST-API, signierte Webhooks, Zapier und ein MCP-Server verbinden die Plattform mit deinen anderen Tools. Eine Synchronisierung mit CRMs oder Praxisverwaltungssystemen gibt es noch nicht.

Anwendungsfälle

LobbyStack lässt sich an viele Abläufe lokaler Unternehmen anpassen:

• Kliniken und Arztpraxen
• Salons, Spas und Friseursalons
• Autowerkstätten
• Hausdienstleistungsunternehmen
• Restaurants
• Zahnarztpraxen
• Anwaltskanzleien und professionelle Dienstleister
• Immobilienverwaltungen
• Jedes Unternehmen, das telefonisch Fragen zu Terminen, Preisen, Öffnungszeiten oder Verfügbarkeit erhält

Produktbereiche

Bereich	Was du erhältst
Telefonempfang	Eingehende Telefon- und Browseranrufe, beantwortet von OpenAI GPT-Live, mit Telefonnummern von Twilio oder Telnyx.
Unternehmenswissen	Antworten auf Grundlage strukturierter Unternehmensdaten, Texteingaben, Dokumente und importierter Webseiten.
Buchungen	Dienstleistungsbezogene Terminplanung mit Verfügbarkeitsprüfung und Übergabe an den Kalender.
Terminänderungen	Sicherere Abläufe zum Stornieren und Verschieben mit Terminsuche und Verifizierung.
Übergabe an Menschen	Live-Weiterleitung und Folgeaufgaben für Anrufe, die die Aufmerksamkeit von Mitarbeitenden erfordern.
Nachrichten	Eingehende SMS mit manuellen Antworten, verknüpft mit dem Kundenverlauf.
Website-Widget	Einbettbarer Chat, Lead-Erfassung und Browseranrufe mit Zugriffskontrollen pro Website. Eingeschränkt: Neue Widget-Schlüssel sind deaktiviert, sofern du nicht WIDGET_KEY_ISSUANCE_ENABLED=true festlegst.
MCP-Server	Ein Model Context Protocol-Server unter /api/mcp, über den Claude, ChatGPT und andere Assistenten Anrufe abrufen und Termine buchen können.
Dashboard	Anrufe, Nachrichten, Kontakte, Termine, Aufzeichnungen, Transkripte, Folgeaufgaben und Analysen an einem Ort.
Nutzung und Abrechnung	Gehostete Tarife, Sprachnutzung, SMS-Benachrichtigungen, Weiterleitungsversuche, Speicher und Ausgabenlimits.
Eigene API-Schlüssel verwenden	Selbst gehostete Bereitstellungen können eigene Zugangsdaten für Twilio oder Telnyx, OpenAI-kompatible KI, Kalender, E-Mail, Analysen und Abrechnungsanbieter verwenden.

MCP-Server

LobbyStack betreibt einen Model Context Protocol-Server. So kannst du Claude, ChatGPT, Claude Code, Cursor, VS Code oder jeden anderen MCP-Client mit einem Unternehmen verbinden und in natürlicher Sprache fragen: „Wer hat gestern angerufen und keinen Termin gebucht?“ oder „Buche Dana Whitfield am Dienstagvormittag für eine Reinigung.“

Einstellung	Wert
Server-URL	https://app.lobbystack.com/api/mcp (selbst gehostet: https://<your-domain>/api/mcp)
Transport	Streamable HTTP
Authentifizierung	Bei LobbyStack anmelden (OAuth) oder Authorization: Bearer <API key>
Registrierungsname	io.github.lobbystack/lobbystack in der offiziellen MCP Registry

Füge den Server zu Claude Code hinzu:

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

Der Server stellt 18 Tools für ein Unternehmen bereit. Jedes Tool benötigt einen Berechtigungsbereich, und jede Änderung wird im Audit-Log des Unternehmens protokolliert.

Tools	Berechtigungsbereich
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

Schreibgeschützte Tools tragen readOnlyHint, und Tools, die Daten stornieren, verschieben oder ersetzen, tragen destructiveHint. White-Label-Partner erhalten zusätzliche Tools zur Verwaltung ihrer Partnerkonsole.

Die Implementierung befindet sich in apps/admin/src/lib/mcp/: server.ts erstellt den McpServer und registriert die Tools aus tools.ts und partner-tools.ts; apps/admin/app/api/mcp/route.ts stellt ihn bereit. Der MCP-Server-Leitfaden behandelt Berechtigungsbereiche, Fehler und Limits.

Technologie

Ebene	Hauptkomponenten
App	Next.js, React, Tailwind CSS, shadcn/ui
Backend	PostgreSQL, Drizzle ORM, Redis, BullMQ
Sprache	OpenAI GPT-Live über SIP und WebRTC, über Twilio Elastic SIP Trunking oder Telnyx-SIP-Verbindungen
Agent	Vercel AI SDK, gpt-6-luna oder ein beliebiges OpenAI-kompatibles Modell
MCP	@modelcontextprotocol/server über Streamable HTTP, mit OAuth oder API-Schlüsseln

Gehostet und Open Source

LobbyStack ist Open Source und bietet einen gehosteten Cloud-Dienst.

Nutze LobbyStack Cloud, wenn du möchtest, dass das Produkt für dich verwaltet wird. Das Verhalten des Empfangs, das Wissen, die Dienstleistungen, Regeln, Telefonnummern, Integrationen und Teamabläufe steuerst du weiterhin über die App.

Hoste die Lösung selbst, wenn dein Team den Stack auf der eigenen Infrastruktur betreiben, eigene API-Schlüssel mitbringen und eigene Konten für PostgreSQL, Twilio oder Telnyx, OpenAI-kompatible KI, Kalender, Analysen, Abrechnung und E-Mail verwenden möchte.

Um die Lösung auf Railway selbst zu hosten, stelle die LobbyStack-Vorlage bereit. Railway generiert alle Geheimnisse und Datenbankpasswörter. Du musst einen OpenAI-API-Schlüssel und deine Twilio-Zugangsdaten eingeben.

Lege nach der Bereitstellung einige Variablen in Railway fest:

• E-Mail: SMTP_* und EMAIL_FROM auf dem Worker. Ohne diese funktionieren das Zurücksetzen von Passwörtern, Bestätigungscodes und Einladungen nicht.
• Telefonanrufe: Einen OpenAI-Webhook auf https://your_admin_domain/api/webhooks/openai/live, dessen Geheimnis als OPENAI_WEBHOOK_SECRET auf dem Admin und deinen Twilio Elastic SIP-Trunk als TWILIO_SIP_TRUNK_SID auf dem Worker. Siehe docs/voice/runtime.md. Wenn du Telnyx für einige oder alle Länder verwenden möchtest, folge der Anleitung Telnyx verwenden.
• Optional: FIRECRAWL_API_KEY auf dem Worker für den Website-Import sowie GOOGLE_CLIENT_ID und GOOGLE_CLIENT_SECRET auf dem Admin für Google Calendar.
• Benutzerdefinierte Domain: APP_BASE_URL auf dem Admin. Die anderen URL-Variablen verweisen darauf.

Der Leitfaden zum Selbsthosten enthält alle Schritte.

Volle Kontrolle über das Produkt in der gehosteten App. Kontrolle über die Infrastruktur beim Selbsthosten. In beiden Fällen derselbe Open-Source-Kern.

Architektur für Mitwirkende

LobbyStack ist ein TypeScript-Monorepo mit PostgreSQL als dauerhafter Quelle der Wahrheit. OpenAI hostet die Anruf-Audioverarbeitung; die Admin-App startet jeden Anruf und der Worker führt ihn aus.

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

Lies die Übersicht zum Selbsthosten, um mehr über die Anbieterzuordnung und die Bereitstellungserwartungen zu erfahren, oder nutze die Docker-Compose-Anleitung als offizielle Grundlage für einen einzelnen Host.

Erste Schritte

Die gehostete App verwenden

1. Erstelle ein LobbyStack-Konto.
2. Bestätige deine Mobilnummer.
3. Importiere Wissen von deiner Website oder überspringe diesen Schritt und füge später manuell Wissen hinzu.
4. Wähle einen Tarif.
5. Sichere dir eine Geschäftsnummer mit Starter oder Pro.
6. Konfiguriere KI-Einstellungen, Dienstleistungen, Wissen und Regeln, bevor du Live-Anrufe entgegennimmst.

Die vollständige Anleitung zur gehosteten Version findest du im Einrichtungsleitfaden.

Lokale Entwicklung ausführen

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

Bei der lokalen Entwicklung werden Aufzeichnungen und Uploads unter .lobbystack/storage gespeichert. Lege STORAGE_PROVIDER=s3 fest, wenn du einen S3-kompatiblen Dienst testen musst.

Mock-Anbieter gehören zum standardmäßigen Entwicklungsablauf. So können Mitwirkende Abläufe ohne aktive Twilio-, KI-, Kalender- oder E-Mail-Zugangsdaten testen. Hinweise zur Anbietereinrichtung findest du in der Dokumentation.

Mit Docker Compose bereitstellen

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

Der Stack verwendet stdout-Protokolle und Health-Endpunkte, ohne Überwachungscontainer auszuführen. Lege OTEL_EXPORTER_OTLP_ENDPOINT und OTEL_EXPORTER_OTLP_HEADERS fest, um Server-Telemetrie an PostHog oder ein anderes OTLP-kompatibles Backend zu senden.

Voraussetzungen, lokale Smoke-Tests und den Produktivstart, Hilfsskripte und Fehlerbehebung findest du im Leitfaden zum Selbsthosten mit Docker Compose.

Mitwirken

Beiträge sind willkommen. Beginne mit CONTRIBUTING.md, belasse dauerhafte Geschäftslogik in den Domain- und Datenbankschichten und platziere die Tools des Empfangs im Agent-Kern.

Führe vor dem Öffnen eines PR Folgendes aus:

pnpm typecheck
pnpm build
pnpm test

Lizenz

LobbyStack ist unter der MIT-Lizenz lizenziert.