Sparki Docs

Projekte über MCP konfigurieren

Entwürfe vorbereiten, Bilder hochladen, Kalender verbinden und nach Freigabe veröffentlichen.

Projekte über MCP konfigurieren

Verbindung und Rechte

Der MCP-Server ist unter https://api.sparki.app/external-ai/mcp erreichbar und verwendet OAuth. Eine Verbindung gehört zu einem Portal und einem Benutzer.

  • Lese- und Schreibzugriffe besitzen getrennte Scopes für Projekte, Inhalte und Kalender.
  • Neue Scopes erfordern eine neue Verbindung und ausdrückliche Zustimmung.
  • Der über tools/list gelieferte Katalog ist maßgeblich.

Freigabe von Schreibvorgängen

Jeder Schreibvorgang beginnt mit einer Vorschau ohne approved. Nach der Prüfung werden dieselben Argumente mit approved: true und dem approvalToken erneut gesendet. Die Freigabe läuft nach zehn Minuten ab.

  • Verwenden Sie beim Wiederholen dieselbe idempotencyKey.
  • Geänderte Argumente benötigen eine neue Vorschau.
  • Tools können nicht über eine Portal-ID in ein anderes Portal wechseln.

Unterstützte Aufgaben

MCP kann Inhaltsübersetzungen bearbeiten, Projektentwürfe vorbereiten, Bilder hochladen, Kalender verbinden und freigegebene Entwürfe veröffentlichen. Übersetzte Felder verwenden ein Objekt wie { default: 'Text', deDE: 'Text', enGB: 'Text' }.

  • Veröffentlichung und Verfügbarkeit brauchen getrennte Freigaben.
  • MCP erstellt keine Kundenbuchung und ändert keine Abrechnung.
  • Testen Sie neue Konfiguration zuerst in einem Demoportal.

On this page