Configurer des projets avec MCP

Connexion et permissions

Le serveur MCP se trouve sur https://api.sparki.app/external-ai/mcp et utilise OAuth. Une connexion appartient à un portail et à un utilisateur.

• La lecture et l'écriture ont des scopes distincts pour les projets, contenus et agendas.
• Les nouveaux scopes exigent une reconnexion et un consentement explicite.
• Le catalogue renvoyé par tools/list fait foi.

Validation des écritures

Chaque écriture commence par un aperçu sans approved. Après contrôle, renvoyez exactement les mêmes arguments avec approved: true et l'approvalToken. La validation expire après dix minutes.

• Réutilisez la même idempotencyKey lors d'une nouvelle tentative.
• Des arguments modifiés exigent un nouvel aperçu.
• Un outil ne peut pas changer de portail au moyen d'un identifiant.

Tâches disponibles

MCP peut modifier les traductions de contenu, préparer des brouillons de projets, charger des images, relier des agendas et publier un brouillon validé. Les champs traduits utilisent un objet comme { default: 'Texte', frFR: 'Texte', enGB: 'Text' }.

• Publication et ajout de disponibilités ont des validations séparées.
• MCP ne crée pas de réservation client et ne change pas la facturation.
• Testez d'abord toute nouvelle configuration dans un portail de démonstration.

Miniature du projet

get_project et list_projects renvoient thumbnail ou null. Chargez l'image avec upload_project_draft_image, puis passez input: { thumbnail: { draftFileId: "fichier-uuid" } } à update_project_draft. Une miniature existante du même projet utilise { id }. Une image de galerie nécessite un chargement séparé. Omettre le champ conserve la miniature; thumbnail: null la retire lors de la publication. La galerie reste inchangée. L'aperçu, la révision et l'approbation distincte de publication restent nécessaires.

Formulaires et offres

create_project_draft et update_project_draft acceptent des workflowId et preValidationWorkflowId existants du même portail. Le premier accepte GENERAL ou BIDDING, le second uniquement PRE_VALIDATION. Utilisez null pour retirer la connexion. Ces outils ne créent ni ne modifient les formulaires.

Pour préparer les offres, utilisez settings: { isBiddingActive: true, biddingStatus: "open" }. Les statuts sont not-started, open, closed et cancelled. Les autres paramètres sont conservés. Une publication approuvée peut activer les offres publiques, mais ne publie pas de registre des offres. Les révisions, permissions et limites du forfait restent applicables. Les brouillons du tableau de bord doivent y être finalisés.

Si Content reste inaccessible après reconnexion, vérifiez allowedScopes du client OAuth. Le consentement ne peut pas dépasser cette liste. Enregistrez un client avec content:read et content:write, reconnectez-vous et approuvez ces scopes. Les clients et autorisations existants ne sont jamais élargis automatiquement.