Zum Inhalt springen
Leadbase

MCP Apps und Ereignisse

Verstehe Sheet-Vorschauen und die optionale Entwurfserweiterung für Sheet-Änderungsereignisse.

Sheet-Vorschauen mit MCP Apps

Ein kompatibler MCP-Host kann view_sheet als interaktive Tabelle anzeigen. Die Vorschau zeigt Sheet-Titel, Spalten und die erste begrenzte Seite aus einem autorisierten Lesezugriff. Ein Host ohne UI-Unterstützung erhält stattdessen strukturierte Inhalte.

Die Vorschau dient der Darstellung. Nutze sheets.query für weitere Daten und kanonische Operationen zum Bearbeiten. Die App-Unterstützung hängt vom Client ab; eine MCP-Verbindung installiert nicht automatisch ein natives ChatGPT-Plugin.

Optionale Sheet-Änderungsereignisse

Leadbase implementiert eine optionale MCP-Events-Entwurfserweiterung für sheet.changed. Sie ist von normalen Tools getrennt und hängt von Serverkonfiguration und Host-Unterstützung ab. Prüfe die angebotenen Fähigkeiten und events/list; nicht jeder MCP-Client unterstützt diese Methoden.

Wenn verfügbar:

  1. Autorisiere ein verbundenes Konto mit offline_access und Lese- oder Schreibscope.
  2. Stelle einen öffentlich erreichbaren, zugelassenen HTTPS-Callback und ein Webhook-Signaturgeheimnis bereit. Der Server prüft den Callback per Challenge; beliebige Callback-Origins werden nicht akzeptiert.
  3. Abonniere über events/subscribe mit Sheet-ID und Zustellkonfiguration.
  4. Speichere den zurückgegebenen Cursor und erneuere vor refreshBefore; ohne Erneuerung läuft das Abonnement ab.
  5. Beende es mit events/unsubscribe, wenn es nicht mehr benötigt wird.

Die Standardlaufzeit beträgt eine Stunde; unterstützt werden eine Minute bis 24 Stunden. Die Wiederholung ist auf den aufbewahrten Abschnitt von 10.000 Ereignissen begrenzt. Meldet die Antwort truncated, lies das Sheet erneut, statt den Ereignisstrom als vollständige Historie zu behandeln.

Zustellung und Autorisierung

Payloads enthalten sheetId, sequence, contentRevision, changeType und url, keine Zellinhalte. Lies nach einer Benachrichtigung aktuelle Daten über Sheet-Tools. Prüfe Webhook-Signaturen, behandle doppelte Zustellungen und bewahre Cursor auf; geeignete Fehler werden erneut zugestellt, der Strom ist kein exakt einmal zugestelltes Änderungsprotokoll.

Die Autorisierung wird beim Abonnieren und Zustellen geprüft. Die Zustellung endet, wenn das verbundene Konto den Zugriff verliert oder seine Autorisierung abläuft. Ereignisse gewähren keinen Zugriff auf andere Sheets oder Workspaces.

Leadbase bietet kein allgemeines Webhook-Verwaltungspanel in den Einstellungen. Nutze diese Erweiterung nur, wenn Host und Deployment sie anbieten. Gewöhnliche MCP-Lesezugriffe und Änderungen funktionieren ohne Ereignisabonnements.

Siehe MCP-Verbindung und Sheet-Abläufe.