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.

Projektvorschaubild

get_project und list_projects liefern thumbnail oder null. Laden Sie das Bild mit upload_project_draft_image hoch und übergeben Sie input: { thumbnail: { draftFileId: "datei-uuid" } } an update_project_draft. Ein bestehendes Vorschaubild desselben Projekts verwendet { id }. Galeriebilder benötigen einen separaten Upload. Ohne das Feld bleibt das Bild erhalten; thumbnail: null entfernt es bei Veröffentlichung. Die Galerie bleibt unverändert. Vorschau, Revision und gesonderte Veröffentlichungsfreigabe bleiben erforderlich.

Formulare und Gebote

create_project_draft und update_project_draft akzeptieren bestehende workflowId und preValidationWorkflowId aus demselben Portal. Erstere erlaubt GENERAL oder BIDDING, letztere nur PRE_VALIDATION. null entfernt die Verbindung. Diese Tools erstellen oder bearbeiten keine Formulare.

Mit settings: { isBiddingActive: true, biddingStatus: "open" } bereiten Sie Gebote vor. Die Statuswerte sind not-started, open, closed und cancelled. Andere Einstellungen bleiben erhalten. Eine genehmigte Veröffentlichung kann öffentliche Gebote aktivieren, veröffentlicht aber kein Gebotsprotokoll. Revisionen, Portalrechte und Tarifgrenzen gelten weiterhin. Dashboard-Entwürfe müssen im Dashboard abgeschlossen werden.

Wird Content nach erneuter Verbindung verweigert, prüfen Sie allowedScopes des OAuth-Clients. Eine Zustimmung kann diese Liste nicht erweitern. Registrieren Sie einen Client mit content:read und content:write, verbinden Sie erneut und stimmen Sie diesen Scopes zu. Bestehende Clients und Berechtigungen werden nicht automatisch erweitert.