pgday.app Entwickler-API & Agenten-Leitfaden
Verbinde eigene Tools mit der Sales-Gamification von pgday.app, betrieben von Kuckein Consulting. Erkunde fiktive Daten ohne Konto und nutze gezielte Berechtigungen für autorisierte Kundendaten.
Die offizielle pgday CLI nutzen
Installiere die offizielle CLI mit Homebrew unter macOS oder Linux; Homebrew stellt Node.js 24 bereit. Erkunde die Sandbox ohne Zugangsdaten oder verwende berechtigte Produktionsschlüssel über die Umgebungsvariable PGDAY_API_KEY. Befehle liefern JSON und wiederholen Schreibvorgänge niemals automatisch.
brew install kkuckein/pgday/pgday
pgday events list --sandbox
pgday spec --sandboxKostenlose API-Sandbox ausprobieren
Du brauchst kein Konto, keinen Schlüssel und kein Vertriebsgespräch. Die schreibgeschützte Sandbox liefert feste fiktive Leads, Events, Statistiken und Ranglisten. Nutze die zurückgegebenen IDs für Detailabfragen. Seiteneinteilung und Filter entsprechen der Lese-API; Schreibzugriffe liefern HTTP 405. Es werden keine Kundendaten oder externen Aktionen verwendet.
curl https://www.pgday.app/api/sandbox/v1/events
curl 'https://www.pgday.app/api/sandbox/v1/leads?limit=1'Autorisierte Organisation verbinden
Der Produktivzugang ist derzeit auf Pilotorganisationen begrenzt. Die konfigurierte 14-tägige Pro-Testphase für fünf Plätze ist nicht zur öffentlichen Selbstregistrierung freigegeben. Berechtigte Verantwortliche mit aktivem API-Zugang erstellen und widerrufen eigene Schlüssel unter Einstellungen → Integrationen, KI & Plan.
Wähle ausdrücklich eine Organisation oder einen Space. Beginne mit leads:read und ergänze events:read, leaderboard:read oder leads:write nur bei Bedarf. Der Schlüssel wird einmal angezeigt. Speichere ihn in deiner Geheimnisverwaltung, niemals in Chats, Quellcode oder URLs.
curl --fail-with-body \
-H "Authorization: Bearer $PGDAY_API_KEY" \
"https://pkoxxomkokniffvcjutm.supabase.co/functions/v1/pgday-api/leads?limit=10"Fehler sicher behandeln
Fehler enthalten error.code, error.message und error.resolution. Prüfe bei 401 die Zugangsdaten, bei 403 Berechtigungen und API-Zugang, bei 400 Eingaben und bei 404 die Sichtbarkeit der Ressource. Beachte Retry-After bei 429. Ein 409 bestätigt den Rollback. Läuft ein Schreibzugriff in einen Timeout oder liefert 503, prüfe bestehende Leads vor dem Wiederholen: Eine unbestätigte Erstellung kann bereits erfolgreich gewesen sein.
Separate MCP-Verbindung mit OAuth nutzen
Der Analytics-MCP-Server verwendet OAuth mit PKCE statt API-Schlüsseln. Autorisiere analytics:read und optional leads:read über die App. Die schreibgeschützten Tools beachten die Sichtbarkeit des autorisierenden Nutzers. Die Metadaten nennen unterstützte Scopes und die tatsächliche Ressourcen-URL.