Serveur MCP

Qu’est-ce que le serveur MCP Zendou ?

MCP (Model Context Protocol) est un protocole qui permet à un assistant IA d’utiliser des outils externes. Le serveur MCP Zendou tourne sur votre machine, avec votre clé API. Il ne fait que traduire les demandes de l’assistant en appels à l’API publique de Zendou : toutes les règles (domaine vérifié, portée de la clé, crédits) restent appliquées par le serveur Zendou.

Il nécessite Node.js 18 ou plus. Le client MCP le lance lui-même avec npx : il n’y a rien à installer à la main.

Créer une clé API

1. 1.Dans le tableau de bord, ouvrez Clés API puis Nouvelle clé.
2. 2.Pour que l’assistant puisse lire le journal des envois et les domaines, cochez Autoriser la lecture. Sans cette case, la clé permet seulement d’envoyer des emails et de lire le solde.
3. 3.Copiez la clé : elle n’est affichée qu’une fois.

La permission de lecture se choisit à la création et ne peut pas être ajoutée ensuite : si vous avez oublié la case, créez une nouvelle clé. Voir Clés API pour le détail.

Configuration des clients

Remplacez zd_live_VOTRE_CLE par votre clé. Une variable facultative, ZENDOU_API_URL, permet de changer l’adresse de l’API ; par défaut, le serveur utilise https://api.zendou.app. Ne la renseignez que pour l’API Zendou (voir la section Sécurité).

Formats vérifiés le 23/10/2026 aux documentations officielles.

{
  "mcpServers": {
    "zendou": {
      "command": "npx",
      "args": ["-y", "@zendou/mcp"],
      "env": { "ZENDOU_API_KEY": "zd_live_VOTRE_CLE" }
    }
  }
}

claude mcp add --env ZENDOU_API_KEY=zd_live_VOTRE_CLE --transport stdio zendou -- npx -y @zendou/mcp

{
  "mcpServers": {
    "zendou": {
      "command": "npx",
      "args": ["-y", "@zendou/mcp"],
      "env": { "ZENDOU_API_KEY": "${ZENDOU_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "zendou": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zendou/mcp"],
      "env": { "ZENDOU_API_KEY": "${env:ZENDOU_API_KEY}" }
    }
  }
}

Les six outils

Règles de send_email : un seul destinataire ; Nom <adresse> accepté (nom de 128 caractères au plus) ; domaine expéditeur vérifié ; html ou text requis ; headers limités à 20, parmi List-Unsubscribe, List-Unsubscribe-Post et X-* (hors X-SES-*), en ASCII imprimable.

Sécurité

• ✓La clé reste sur votre machine. Elle est lue dans l’environnement du processus et envoyée uniquement à l’API Zendou.
• ✓ZENDOU_API_URL reçoit votre clé. Ne la renseignez que pour l’API Zendou, en https:// seulement : le paquet refuse http://, sauf pour localhost et 127.0.0.1. Une adresse tierce lirait votre clé.
• ✓La lecture est facultative. Elle se décide clé par clé, décochée par défaut. Une clé avec lecture qui fuit expose les destinataires et les sujets des emails de sa portée : ne l’activez que si vous en avez besoin, et préférez une clé dédiée à l’assistant.
• ✓Portée par domaine. Une clé limitée à certains domaines ne peut envoyer, ni lire, que pour ces domaines ; le reste répond comme s’il n’existait pas.
• ✓Aucune suppression ni création. Le serveur n’écrit rien d’autre que l’envoi d’un email : il ne peut ni créer ni supprimer un domaine, une clé ou un identifiant SMTP, ni recharger des crédits.

Erreurs fréquentes

Le 403 d’une clé sans lecture renvoie :

{
  "message": "Cette clé API n'a pas l'autorisation de lecture : créez une clé avec la lecture autorisée.",
  "error": "Forbidden",
  "statusCode": 403,
  "errors": [
    "Cette clé API n'a pas l'autorisation de lecture : créez une clé avec la lecture autorisée."
  ]
}

Le 403 d’un envoi hors de la portée de la clé renvoie :

{
  "message": "Cette clé API n'est autorisée que pour le domaine boutique-awa.gn.",
  "error": "Forbidden",
  "statusCode": 403,
  "code": "CREDENTIAL_DOMAIN_OUT_OF_SCOPE",
  "errors": [
    "Cette clé API n'est autorisée que pour le domaine boutique-awa.gn."
  ]
}

Voir aussi Clés API et Erreurs.