Ce que vous pouvez modifier
Les outils de lecture dont vous vous servez pour préparer une écriture sont documentés avec les autres outils de lecture. La découverte liste les outils que vos scopes autorisent ; votre rôle et votre offre sont vérifiés à l’appel de l’outil.
Prérequis
Un appel d’écriture exige tout ce qui suit.- Une offre qui inclut les écritures MCP. Une offre Business, Agency Business ou Enterprise active, les mêmes offres que pour les écritures REST. Les outils d’écriture des audits de prospection exigent aussi une équipe agence. La lecture via MCP reste disponible à partir de Starter, sans changement. Cela inclut les outils de lecture dont vous vous servez pour préparer une écriture :
estimate_run,list_runs,get_run,get_credits,get_site_audit,get_prompt_suggestionsetget_prompt_suggestion_run. - Le scope d’écriture correspondant. Accordé par vous, connexion par connexion. Consultez Accorder des scopes d’écriture.
- Le rôle Manager ou Propriétaire dans l’équipe. Chaque outil exige le rôle minimal de l’action équivalente du tableau de bord, qui est Manager pour toute écriture. Les Membres et les Lecteurs ne font que lire.
Scopes
Rôles
Le rôle est celui que vous détenez dans l’équipe propriétaire du workspace.get_credits exige aussi le rôle Manager ou Propriétaire, comme les pages d’utilisation et de crédits du tableau de bord.
Accorder des scopes d’écriture
Sur l’écran de consentement OAuth, les scopes d’écriture apparaissent comme des options que vous cochez vous-même. Rien n’est présélectionné. Pour un jeton d’accès personnel, choisissez les scopes d’écriture lors de sa création dans Gestion de l’équipe > Serveur MCP. Consultez Authentification OAuth pour le flux complet.- N’accordez que les scopes dont une tâche a besoin. Une connexion qui prépare des prompts n’a pas besoin de
write:monitoring. - Pour ajouter un scope d’écriture à une connexion existante, reconnectez-vous et autorisez-la de nouveau. Les scopes d’un jeton déjà émis ne sont jamais étendus en silence.
- Vous pouvez révoquer un jeton à tout moment depuis Gestion de l’équipe > Serveur MCP.
Comment fonctionne un appel d’écriture
1
Lire l’état courant
Utilisez les outils de lecture pour résoudre les identifiants et lire la
version de tout ce que vous prévoyez de modifier.2
Prévisualiser avec dryRun
Chaque outil d’écriture accepte
dryRun. Avec dryRun défini sur true, l’outil valide la requête et renvoie son effet, son coût et ses avertissements sans rien modifier.3
Confirmer si nécessaire
Lorsque la règle de confirmation de l’outil s’applique, un appel sans jeton valide renvoie l’aperçu et un
confirmationToken, et n’exécute rien. Relisez l’aperçu, puis appelez de nouveau le même outil avec les mêmes arguments et le jeton.4
Vérifier le résultat
Relisez la ressource, ou suivez un run, un audit ou une génération avec son outil de lecture.
dryRun
dryRun est un booléen dont la valeur par défaut est false. Un dry run ne modifie jamais de données. Servez-vous-en pour vérifier des arguments, voir ce qu’un appel en masse ferait à chaque élément et connaître le coût d’une action payante avant de vous engager.
Aperçu et résultat
Un outil d’écriture renvoie l’une de ces deux formes. Un aperçu est renvoyé à la place de l’exécution lorsquedryRun vaut true, ou lorsque la règle de confirmation s’applique et qu’aucun confirmationToken valide n’a été envoyé. Rien n’a changé.
Un résultat est renvoyé une fois la modification appliquée.
Une nouvelle tentative avec le même
confirmationToken, ou avec la même intention, dans les 24 heures renvoie le même résultat sans second effet. replayed vaut alors true.
Si l’issue d’une écriture est inconnue (connexion coupée pendant l’enregistrement), Qwairy ne l’applique jamais deux fois :
- Les outils qui prennent un
expectedVersion,create_workspaceetconfirm_pitch_auditpeuvent être relancés tout de suite : la version, le domaine du workspace ou l’état de l’audit refuse un second effet. Une nouvelle tentative applique le changement, ou signale ce qui la bloque :VERSION_CONFLICT,CONFLICT,CONFIRMATION_INVALIDpour un jeton déjà utilisé (prévisualisez à nouveau), ou des élémentsversion_conflictdans le résultat debulk_update_prompts. Relisez la ressource pour vérifier. start_run,create_pitch_audit,create_prompts,create_topicetcreate_tagn’ont pas cette protection. La même demande répondRESOURCE_BUSYpendant 5 minutes au plus, puis Qwairy la règle à partir de son journal d’audit. Si le changement a été appliqué, le même appel avec le mêmeconfirmationToken, ou avec le jeton d’un aperçu demandé pendant que cet appel était en cours, le rejoue avecreconciled: trueet les identifiants enregistrés (par exemplerunId,auditIdou unpromptIdpar prompt créé). Un lotcreate_promptsarrêté en cours de route, même sur un refus qui listecreatedPromptIds, répond de mêmeRESOURCE_BUSY, puis liste les prompts créés et ajouteincompleteavec les nombres demandé et appliqué : créez les autres avec un nouvel appel. Sinon, rappelez l’outil.
start_run sur les mêmes prompts, est une nouvelle demande et donne un nouvel aperçu. Ses avertissements indiquent si le confirmer rejoue un appel identique encore en cours, ou applique à nouveau une demande déjà appliquée dans les dernières 24 heures.
expectedVersion
Les outils de modification exigentexpectedVersion : la version que vous avez lue en dernier pour la ressource. Si la ressource a changé depuis, l’appel échoue avec un conflit de version au lieu d’écraser l’autre modification. Relisez la ressource et réconciliez. Traitez la valeur comme opaque : ne calculez pas la version suivante.
Après une écriture réussie, la version du résultat est celle à utiliser pour la modification suivante.
Où lire la version
Pour un workspace
DRAFT, ARCHIVED ou bloqué par l’offre, appelez list_brands avec includeInactive: true. Pour un prompt archivé, appelez get_prompts avec includeArchived: true.
Les prompts, topics et tags d’un workspace DRAFT ne sont pas lisibles par MCP. Conservez les versions renvoyées à leur création, ou activez le workspace avant de les modifier depuis une autre conversation.
bulk_update_prompts agit sur plusieurs prompts et prend une version par prompt : expectedVersions, une table indexée par identifiant de prompt.
Confirmation
Chaque outil a une règle de confirmation, indiquée sur sa page.
Tout outil qui archive, réécrit, met en pause ou remplace des données existantes utilise
always ou except_restore. Les Topics et les Tags ne peuvent pas être supprimés via MCP : supprimez-les depuis le tableau de bord ou avec l’API REST.
Un jeton de confirmation :
- est renvoyé avec l’aperçu de l’appel qui en a besoin ;
- ne peut servir qu’une seule fois ;
- est valable 10 minutes ;
- devient invalide si les arguments, les cibles, leurs versions ou le coût prévisualisé changent : une requête modifiée exige donc un nouvel aperçu.
start_run, le jeton engage exactement le plan confirmé : mêmes prompts, textes, modèles, pays, personas et prix. Si l’un d’eux a changé depuis l’aperçu, rien n’est réservé et l’appel renvoie CONFIRMATION_INVALID.
L’étape de confirmation de votre client MCP (Claude, ChatGPT ou un autre) est une demande supplémentaire. Elle ne remplace pas le jeton Qwairy, et le jeton Qwairy ne remplace pas l’approbation du client.
Erreurs
Une écriture en échec renvoie l’un de ces codes d’erreur.Crédits
Les appels MCP eux-mêmes ne consomment aucun crédit, et Qwairy n’applique aucun plafond de dépense aux écritures MCP. Les actions payantes puisent dans le solde de crédits de l’équipe exactement comme depuis le tableau de bord :- lancer un run ;
- confirmer un audit de prospection ;
- auditer des pages ;
- mettre des prompts sous suivi, ce qui ajoute une consommation de crédits récurrente ;
- un changement qui rend des prompts dus tout de suite : un workspace qui passe
LIVE, des prompts créés ou restaurés, ou les réponses automatiques activées. Le prochain passage du planificateur les collecte, et l’aperçu indique ce coût danscredits.oneOff.
get_credits et chiffrez un run avec estimate_run. Consultez Outils de runs et de crédits.
credits.dailyChange estime le suivi récurrent que vous configurez, y compris les modèles temporairement indisponibles ou mis en pause par Qwairy. Leur collecte peut reprendre sans nouvelle modification de configuration : une augmentation exige donc toujours votre confirmation. Les modèles désactivés de façon permanente, les pays non pris en charge et les modèles premium auxquels votre équipe n’a pas accès sont exclus.
Pour les modifications du suivi, credits.oneOff correspond à la collecte qui peut démarrer au prochain passage du planificateur. Les modes de collecte temporairement indisponibles ou en pause sont exclus. Aucune de ces estimations ne débite de crédits par elle-même.
Sécurité
Qwairy limite ce risque de plusieurs façons :- Les scopes d’écriture sont activés sur option et séparés des scopes de lecture.
- Chaque outil vérifie votre rôle et votre offre côté serveur.
- Les aperçus montrent l’effet, le coût et les avertissements avant tout changement.
- Les actions sensibles et payantes exigent un jeton de confirmation à usage unique, lié aux arguments exacts.
dryRunpermet d’examiner n’importe quel appel sans effet de bord.
Limites
- L’assistant intégré à Qwairy reste en lecture seule.
- Les endpoints de webhook et les clés d’API ne se gèrent pas via MCP. Utilisez l’API REST et le tableau de bord.
- L’appartenance à l’équipe, les rôles, les transferts de crédits et les achats restent des actions du tableau de bord.
Étapes suivantes
Autoriser les scopes d’écriture
Consentement, jetons d’accès personnels et révocation.
Commencer par les prompts
Créez des prompts, des Topics et des Tags avec un aperçu.
Lancer un audit de prospection
Suivez le flux de création, de relecture et de confirmation.
Chiffrer un run
Estimez les crédits et suivez l’état des runs.

