mailinapp
Documentation menu

Serveur MCP

MailInApp expose un serveur MCP afin qu'un client IA externe — Claude Desktop, Claude Code, ou tout autre outil compatible MCP — puisse construire et modifier directement les projets d'email de votre compte, de la même façon que le fait le copilote IA intégré au studio. C'est le même noyau d'utilisation d'outils dans les deux cas : un client MCP et le panneau du studio ne sont que deux portes d'entrée différentes vers le même ensemble de modifications.

Cette page couvre le chemin développeur : votre propre backend ou outillage CLI s'authentifiant avec une clé API que vous générez vous-même, le même identifiant qu'utilise l'API d'envoi.

Endpoint et authentification

https://mailinapp.com/api/mcp

Authentifiez-vous avec le même en-tête Authorization: Bearer <apiKey> que l'API d'envoi — générez ou réutilisez une clé depuis Developers dans le tableau de bord. Il n'y a pas d'identifiant spécifique à MCP à gérer séparément pour ce chemin ; une clé représente déjà « le propre backend de ce compte », elle est donc digne de confiance au même niveau ici, avec tous les outils documentés ci-dessous disponibles quel que soit le scope.

L'endpoint est sans état : chaque requête est un appel MCP autonome, il n'y a donc rien à maintenir actif entre les messages, ni d'étape de connexion/déconnexion séparée au-delà de la configuration normale de votre client MCP.

Connexion à Claude Code

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

Claude Desktop et les autres clients MCP prenant en charge un serveur HTTP distant utilisent la même URL et le même en-tête — consultez la documentation propre à votre client pour savoir où les coller.

Outils

Une clé API est digne de confiance au niveau complet du propriétaire du compte, elle voit donc tous les outils disponibles — conception de projet, contacts et suppressions, résultats de campagne et commandes, envoi (y compris de vrais envois de campagne, pas seulement des tests), réponses de messagerie et de tickets, et utilisation du forfait.

Les outils d'édition de l'arborescence (add_block/update_block/remove_block/move_block/set_theme, et apparentés) prennent tous un projectId en premier paramètre (depuis list_projects/create_project) — un client MCP n'a pas d'onglet studio ouvert dont l'inférer. Chaque type de bloc valide, ses parents acceptés, et sa liste de champs sont décrits au modèle dans le cadre de l'ensemble d'outils via list_block_types, ce qui le maintient synchronisé avec les types de blocs actuellement livrés par le studio ; vous n'avez pas besoin de lui indiquer ce qui est disponible.

Comment les modifications sont appliquées

Chaque appel d'outil de modification est sa propre écriture atomique directement sur le projet — il n'y a pas d'étape « appliquer » comme celle du panneau intégré au studio, puisqu'il n'y a pas de canevas ouvert auquel l'appliquer. Si vous avez le projet ouvert dans le studio au moment où un client MCP le modifie, votre prochaine sauvegarde automatique affiche la bannière de conflit normale « Modifié ailleurs », exactement comme si un coéquipier l'avait modifié — rechargez pour récupérer la modification issue de MCP, ou enregistrez comme copie pour conserver vos propres modifications en cours.

Chaque modification MCP est aussi journalisée dans le fil de discussion du copilote du projet (étiquetée comme provenant de MCP, et non du panneau du studio), afin qu'elle apparaisse dans le même historique que celui affiché par le panneau Copilote IA intégré au studio.

Limites de débit et disponibilité par forfait

  • Par clé API : 60 requêtes/minute, indépendamment des autres clés du même compte.
  • Par compte : chaque appel d'outil puise dans un seul compteur mensuel (plan.connectorCallsMonthly, distinct de l'allocation de tours propre au copilote IA intégré au studio, puisqu'un appel MCP n'invoque jamais de modèle IA du côté propre de MailInApp). Disponible avec un quota réel sur tous les forfaits, Free inclus — voir les tarifs pour les chiffres exacts, ou appelez get_plan_usage pour lire l'utilisation du mois en cours de votre compte.
  • L'envoi de campagnes réelles via ce chemin est mesuré de la même façon que confirm_send, avec le même flux de confirmation et le même plafond de volume.