Accueil › Utiliser Qorami avec MCP

Utiliser Qorami avec MCP

Le moyen le plus rapide de mettre un garde-fou sur un agent IA qui envoie des e-mails. Ajoutez Qorami à Claude Desktop, Cursor ou Windsurf en tant que serveur MCP, et votre agent demandera avant d'envoyer — Qorami répondra send, request_human_confirmation ou do_not_send. Une seule commande, environ cinq minutes.

sendrequest_human_confirmationdo_not_send

Pourquoi MCP est la voie la plus rapide

Le Model Context Protocol (MCP) est la méthode privilégiée par Claude Desktop, Cursor, Windsurf et la plupart des frameworks d'agents pour charger des outils. Enregistrez Qorami une fois comme serveur MCP et l'agent obtient un outil natif verify_email — pas de SDK à intégrer, pas de code de liaison. Si votre agent utilise déjà MCP, c'est le chemin le plus court pour passer de « mon agent peut envoyer des e-mails » à « mon agent ne peut pas envoyer d'e-mails erronés ».

Les outils

qorami_health — vérifie que le serveur est configuré : API accessible, clé valide, crédits restants. Ne consomme jamais de crédit. À exécuter en premier.
verify_email — l'agent appelle cet outil avant d'envoyer. Renvoie une décision qu'il doit respecter, des codes de motif (reasonCodes), des suggestions, et un corps d'e-mail corrigé (remediation.safeBody) si l'e-mail peut être corrigé automatiquement.
check_action_status — lorsqu'une décision est request_human_confirmation, l'agent interroge régulièrement cet outil avec l'actionId jusqu'à ce qu'un humain approuve (send) ou bloque (do_not_send) la demande depuis la console.

Installation en 5 minutes

1 Obtenir une clé API

Créez un espace de travail gratuit — 100 vérifications incluses, sans carte bancaire — et copiez votre clé (elle commence par qrm_ws_…). Elle n'est affichée qu'une seule fois à l'inscription ; vous pourrez la régénérer depuis la console.

Créer un compte gratuit →

2 Ajouter Qorami à votre client MCP

Claude Desktop — Paramètres → Développeur → Modifier la configuration, puis ajoutez le bloc qorami à claude_desktop_config.json :

{
  "mcpServers": {
    "qorami": {
      "command": "npx",
      "args": ["-y", "qorami-mcp"],
      "env": { "QORAMI_API_KEY": "qrm_ws_..." }
    }
  }
}

Cursor (~/.cursor/mcp.json) et Windsurf utilisent le même objet mcpServers — collez exactement le même bloc qorami. Le package publié qorami-mcp s'exécute via stdio, de sorte que tout client compatible avec MCP l'enregistre de la même manière. Pas besoin de cloner ni d'installer : npx s'occupe de le récupérer pour vous.

3 Confirmer le fonctionnement — sans dépenser de crédit

Redémarrez le client et demandez-lui d'exécuter qorami_health. Vous devriez obtenir un résultat similaire à ceci :

{
  "ok": true,
  "apiKeyConfigured": true,
  "apiHealth": { "ok": true, "status": 200 },
  "usage": { "ok": true, "creditsRemaining": 100 },
  "nextStep": "Call verify_email before any agent sends email."
}

Si apiKeyConfigured is false, cela signifie que la variable QORAMI_API_KEY dans votre configuration est manquante ou mal orthographiée.

4 Demander à l'agent de valider avant d'envoyer

Ajoutez une seule ligne d'instruction à votre agent :

Avant d'envoyer N'IMPORTE QUEL e-mail, appelle l'outil verify_email de Qorami et respecte le type de action suivante (nextAction.type) : send -> l'envoyer ; request_human_confirmation -> interroger check_action_status jusqu'à ce que l'action soit résolue ; do_not_send -> ne pas envoyer.

C'est tout pour l'intégration. Le premier e-mail à risque (une clé d'API fuitée, une réduction non approuvée, ou une tentative d'injection de prompt) s'arrêtera désormais au garde-fou au lieu de quitter votre boîte d'envoi.

Le contrat que l'agent respecte

send — autorisé. L'agent envoie l'e-mail. Fonctionne de manière autonome.
do_not_send — bloqué. L'agent n'envoie pas l'e-mail (il peut éventuellement appliquer les suggestions et effectuer une nouvelle vérification). Fonctionne de manière autonome. Un blocage ne coûte aucun crédit.
request_human_confirmation — en attente. L'agent interroge régulièrement check_action_status jusqu'à ce qu'une personne valide ou bloque l'envoi depuis la console. Ce contrôle humain (« human-in-the-loop ») sur les e-mails sensibles est tout l'intérêt du système — et une clé API restreinte à la vérification ne peut pas valider ses propres e-mails suspendus.

Chaque vérification coûte 1 crédit (les blocages sont gratuits) et renvoie le nombre de crédits restants (creditsRemaining). Pour permettre à un agent de fonctionner en continu, vous pouvez activer la recharge automatique depuis la console.

Ajouter Qorami à mon agent →

En savoir plus : Docs de l'API · qorami-sdk/mcp sur GitHub · précision mesurée · pourquoi un garde-fou.