Référence des outils

Chaque outil qu'un assistant connecté peut appeler, regroupé de la même façon que le serveur les enregistre. Un outil n'est proposé à l'assistant que si votre connexion détient la portée dont il a besoin — il n'existe pas d'outil d'écriture présent mais qui échoue systématiquement ; si vous n'avez pas accordé contacts:write, l'assistant ne voit tout simplement pas upsert_contacts. Voir Portées et autorisations pour ce que chaque portée signifie.

Destructive dans les tableaux ci-dessous est la même annotation MCP que le processus de revue de Claude exige — elle marque un outil dont l'effet ne peut pas être annulé trivialement (supprimer un projet, écraser une arborescence, retirer un contact), pas « dangereux » dans un sens plus vague. Chaque outil d'écriture ne prend toujours que les champs auxquels on s'attendrait ; aucun n'accepte de charge brute par laquelle le modèle pourrait faire passer des modifications arbitraires en contrebande.

Découverte

| Outil | Portée | Notes | | --- | --- | --- | | search | l'une de projects:read / templates:read / contacts:read | Recherche parmi les projets, modèles et listes de contacts par nom. Renvoie des identifiants opaques pour fetch. C'est l'outil qu'un client capable de recherche approfondie appelle automatiquement. | | fetch | identique à search | Résout un identifiant issu de search en son contenu complet. |

Conception d'email

| Outil | Portée | Destructive | Notes | | --- | --- | :-: | --- | | list_projects | projects:read | | Identifiant, nom, objectif pour chaque projet. | | get_email | projects:read | | L'arborescence de blocs et le thème actuels d'un projet. | | preview_email | projects:read | | Rendu via le véritable pipeline HTML d'envoi — le document exact qu'un envoi produirait. Associé à un widget (voir ci-dessous). | | list_block_types | projects:read | | Le catalogue complet de 44 blocs, généré à partir du registre en direct — toujours à jour, jamais maintenu à la main. | | list_templates | projects:read | | Vos modèles enregistrés, ou la galerie communautaire approuvée. | | create_project | projects:write | | Optionnellement amorcé depuis un modèle d'objectif intégré. | | add_block / update_block / move_block | projects:write | | Modifications de l'arborescence, validées par canPlace/champ de la même façon que les modifications du copilote intégré au studio. | | remove_block | projects:write | ✓ | Supprime un bloc et ses enfants. | | set_theme | projects:write | | Couleurs de marque, police, rayon des boutons. | | rename_project | projects:write | | | | delete_project | projects:write | ✓ | Permanent. | | apply_template | projects:write | ✓ | Écrase l'ensemble de l'arborescence et du thème du projet. | | save_as_template | templates:write | | Capture le projet actuel dans un modèle réutilisable. |

Audience

| Outil | Portée | Destructive | Notes | | --- | --- | :-: | --- | | list_data_sources | contacts:read | | Chaque source de données, listes de contacts comprises. Les valeurs d'identifiants ne sont jamais renvoyées. | | list_contact_lists | contacts:read | | Les listes de contacts spécifiquement — identifiant, nom, champs, nombre de lignes. | | get_contact_list_summary | contacts:read | | Comptes et totaux de suppression — aucune donnée de contact individuelle. | | find_contacts | contacts:read | | Recherche bornée (≤25 lignes, paginée par curseur). Chaque appel est écrit dans le journal d'accès aux données personnelles, comme une lecture de contact depuis le tableau de bord. | | upsert_contacts | contacts:write | | Ajoute ou met à jour des lignes ; applique le plafond de contacts de votre forfait. | | remove_contact | contacts:write | ✓ | Retire une ligne de façon permanente. | | add_suppression / remove_suppression | contacts:write | | Bloque ou débloque une adresse à l'échelle du compte, même effet que le propre lien de désabonnement d'un destinataire. |

Résultats

| Outil | Portée | Destructive | Notes | | --- | --- | :-: | --- | | get_campaign_results | analytics:read | | Ouvertures/clics/réponses/revenus, comparaison de variantes A/B, carte de chaleur des clics. Synthétisé uniquement — jamais les événements bruts par destinataire. Associé à un widget. | | get_form_responses | analytics:read | | Synthèses par question ; les réponses en texte libre sont un échantillon plafonné et encadré. | | list_orders | analytics:read | | Commandes de paiement du bloc Produit. | | list_campaign_sends | analytics:read | | Envois groupés passés, du plus récent au plus ancien. | | list_schedules | analytics:read | | Envois récurrents configurés sur un projet. | | mark_order_fulfilled | commerce:write | | Marque une commande physique comme expédiée et envoie un email à l'acheteur. | | create_schedule | campaigns:send | | Configure un nouvel envoi récurrent. | | set_schedule_enabled | campaigns:send | ✓ | Marqué destructif car désactiver une programmation active arrête les envois futurs silencieusement. |

Envoi

| Outil | Portée | Destructive | Notes | | --- | --- | :-: | --- | | send_test_email | campaigns:read | | Une seule copie préfixée [Test] vers une adresse que vous spécifiez — ne touche pas votre audience réelle et n'a pas besoin de campaigns:send. | | prepare_send | campaigns:send | | En lecture seule par annotation — résout l'audience et génère un aperçu, n'envoie rien. Renvoie un confirmationToken. Associé à un widget (carte de confirmation d'envoi). | | confirm_send | campaigns:send | ✓ | Exige le confirmationToken exact renvoyé par prepare_send, inchangé, dans un délai de 10 minutes. Voir Sécurité pour comprendre pourquoi. |

Messagerie et tickets

| Outil | Portée | Notes | | --- | --- | --- | | list_mailbox_threads / get_mailbox_thread | mailbox:read | Courrier entrant sur votre domaine vérifié. Les corps de message sont encadrés comme du contenu non fiable, rédigé par le destinataire. | | reply_to_mailbox_thread | mailbox:write | Envoie depuis l'adresse de messagerie exacte où le courrier original est arrivé, correctement enchaîné. | | list_tickets / get_ticket | mailbox:read | Conversations de tickets d'assistance. Même encadrement du contenu non fiable. | | reply_to_ticket | mailbox:write | Ajoute un message du propriétaire et envoie un email au destinataire avec un lien de retour. |

Compte

| Outil | Portée | Notes | | --- | --- | --- | | get_plan_usage | aucune — toujours disponible | Forfait, quotas et utilisation du mois en cours. En lecture seule, et pas une donnée de compte sensible comme le sont les projets/contacts/messagerie, donc disponible quelles que soient les portées que vous avez accordées. |

Widgets

Trois outils associent un widget interactif sur les hôtes qui prennent en charge les MCP Apps (Claude — Gemini n'a pas de couche de widget et reçoit toujours le résultat en texte brut/JSON à la place) : preview_email (aperçu d'email bureau/mobile en direct), get_campaign_results (tableau de bord de résultats), et prepare_send (la carte de confirmation d'envoi, dont le propre bouton Confirm & Send est ce qui appelle réellement confirm_send).