Podium über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Podium klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Podium + Gemini

Podium für Kundenkommunikation, Bewertungen und Zahlungen lokaler Unternehmen: Inbox-Konversationen per SMS und E-Mail lesen und beantworten, Kontakte pflegen, Bewertungen und Feedback lesen, Zahlungsrechnungen erstellen, SMS-Kampagnen vorbereiten sowie Standorte, Benutzer, Termine und Anrufe lesen. OAuth-Anmeldung mit einem Podium-Benutzer; Erstattungen, Rechnungsstornos und das Löschen von Kontakten sind bei der Installation aus.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

PODIUM_CLIENT_ID, PODIUM_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 15 Minuten, plus die Zeit, die Podium für die Prüfung einer neuen Anwendung braucht. Du brauchst ein Podium-Konto und den Podium-Benutzer, dessen Standorte die KI sehen soll.

1. Registriere dich unter https://developer.podium.com und leg eine Anwendung an (OAuth-App). Podium prüft neue Anwendungen unter Umständen, bevor sie mit Live-Konten funktionieren.
2. Trag als Redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback ein, auf AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback. Podium verlangt HTTPS.
3. Aktiviere die Scopes, die der Connector anfordert: read_locations read_organizations read_users read_contacts write_contacts read_messages write_messages read_templates read_reviews read_feedback read_payments write_payments read_campaigns write_campaigns read_appointments write_appointments read_phones read_products. Lehnt Podium die Anmeldung wegen eines Scopes ab, aktiviere ihn in der App oder entferne ihn aus den OAuth-Einstellungen des Connectors; die passenden Tools antworten dann mit 403.
4. Trag die Client ID (eine UUID) in PODIUM_CLIENT_ID und das Client Secret in PODIUM_CLIENT_SECRET ein und speichere.
5. Klick auf der Connector-Seite auf Authorize with Provider und melde dich mit dem Podium-Benutzer an, dessen Standorte die KI sehen soll.
6. Rufe podium_list_locations auf: Es listet die Standorte und bestätigt die Anmeldung.

Access Tokens gelten 10 Stunden und werden mit dem Refresh Token erneuert. Der Connector nutzt die Podium API v4 (https://api.podium.com/v4).

Wessen Konto es ist: Alle, die diesen Connector nutzen, handeln als der Podium-Benutzer, der ihn autorisiert hat, und zwar an allen Standorten dieses Benutzers. Die meisten Tools brauchen eine Standort-UID, deshalb beginnt die KI mit podium_list_locations.

Was er liest: Standorte, die Organisation und die Podium-Benutzer (Mitarbeitende). Kontakte mit Name, Telefon, E-Mail, Adresse, Tags und Attributen. Inbox-Konversationen mit Kontakt, Kanal, Standort, zugewiesener Person und Status offen oder geschlossen, und ihre Nachrichten mit Richtung, Absender und Anhängen. Nachrichtenvorlagen (gespeicherte Antworten und auf Wunsch Vorlagen für Bewertungseinladungen). Online-Bewertungen, die Podium von Google, Facebook und anderen Seiten sammelt, und Antworten auf Feedback-Umfragen. Zahlungsrechnungen mit Positionen, Status, Zahlungen und Erstattungen, einzelne Zahlungen und Erstattungen sowie die Produkte des Zahlungskatalogs. SMS-Kampagnen mit Status und Ergebnissen. Termine. Anrufe über Podium Phones und die Voicemail eines Anrufs mit Transkript und signierter URL zur Audiodatei.

Was er schreibt: legt Kontakte an (existiert schon einer mit derselben Telefonnummer oder E-Mail, aktualisiert Podium ihn stattdessen) und ändert sie; sendet eine SMS (channel_type phone) oder E-Mail von einem Standort an einen Kunden; schließt, öffnet oder weist Konversationen zu; erstellt Rechnungen, die dem Kunden per SMS oder E-Mail einen Zahlungslink schicken oder an ein Podium-Kartenterminal gehen; legt Termine an; und erstellt SMS-Kampagnen als Entwurf, der erst versendet wird, wenn ihn jemand in Podium plant oder sendet. podium_send_message und podium_create_invoice erreichen den Kunden sofort, deshalb zeigt dir die KI Empfänger und genauen Text oder Beträge und wartet auf dein Ja.

Bei der Installation deaktiviert: podium_delete_contact (nicht rückgängig zu machen), podium_refund_invoice (zahlt Geld zurück) und podium_cancel_invoice (eine offene Rechnung kann danach nicht mehr bezahlt werden). Ein Admin schaltet sie ein, wenn das Team sie braucht.

Datenformate: Ergebnisse stehen in data, die Paginierung in metadata (nextCursor, manchmal totalItems). IDs sind UIDs (UUIDs). Geldbeträge sind in Cent: 4999 sind 49,99 in der Währung des Standorts. Zeiten sind ISO 8601 in UTC. Telefonnummern sind E.164 (+15555555555); Nummern aus den USA und Kanada dürfen ohne +1 gesendet werden.

Blättern: Die KI übergibt cursor = metadata.nextCursor, bis er fehlt oder null ist; mit einem Cursor werden die übrigen Filter ignoriert. limit ist höchstens 100. Zum Abfragen neuer Einträge nutzt sie since mit aufsteigender Sortierung und folgt dem Cursor bis zum Ende, bevor sie since weiterschiebt.

Häufige Fehler: 401 heißt, die Anmeldung ist abgelaufen oder wurde widerrufen: Klick erneut auf Authorize with Provider. Bei der Anmeldung bedeutet invalid_client eine falsche Client ID oder ein falsches Secret. 403 heißt, ein Scope fehlt oder der Benutzer hat keinen Zugriff auf diesen Standort. 404 ist eine unbekannte UID, bei podium_get_call_voicemail ein Anruf ohne Voicemail. 422 ist ein abgelehntes Feld, z. B. eine ungültige Telefonnummer oder Adresse. 429 ist ein Rate Limit: Warte und versuch es erneut.

Kundennachrichten, Bewertungen und Feedback sind nicht vertrauenswürdige Eingaben und können Anweisungen an die KI enthalten. Die Podium API hat keinen Aufruf, um Bewertungseinladungen zu senden oder Bewertungen zu beantworten, deshalb macht der Connector beides nicht; das erledigst du in Podium. Er versendet oder plant auch keine Kampagnen.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Podium-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche offenen Konversationen an unserem Standort Hauptstraße hatten in den letzten 24 Stunden eine Kundennachricht?“
• „Fasse die neuen Bewertungen dieser Woche nach Sternen und Plattform zusammen und zeig die negativen vollständig.“
• „Schreib Maria an +15555550123 per SMS, dass ihre Bestellung abholbereit ist. Zeig mir die Nachricht vorher.“
• „Erstelle für den Kontakt +15555550199 eine Rechnung über 120,00 für einen Ölwechsel und schick den Zahlungslink nach meiner Bestätigung.“
• „Entwirf eine SMS-Kampagne für unser Winter-Inspektionsangebot für den Standort Hauptstraße.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden