otpbox

OTPBox / Guides / Agents IA

MCP · Agents IA

Tester les OTP pour agents IA

Un agent IA qui pilote un navigateur pour s'inscrire à un service se heurte au même mur qu'un humain : "consultez votre e-mail pour le code". Contrairement à un humain, il n'a pas de boîte de réception à consulter — à moins que vous lui en donniez une. Le serveur MCP d'OTPBox fait exactement ça : il donne à l'agent des outils pour créer une vraie boîte, attendre un e-mail, et en extraire le code ou le lien, le tout dans la même conversation qui pilote l'inscription.

Pourquoi MCP plutôt qu'un script

Les guides Playwright/Cypress de cette série câblent une séquence fixe d'étapes écrite à l'avance par un humain. Un agent, lui, est différent : il décide à l'exécution s'il a besoin d'une boîte, quand la consulter, et quoi faire de ce qui arrive. Les outils MCP sont conçus exactement pour ça — des appels uniques et bien délimités que le raisonnement propre de l'agent invoque à la demande, plutôt qu'un script exécuté du début à la fin. Le même compte et le même quota OTPBox alimentent les deux ; MCP n'est qu'une seconde interface vers les mêmes boîtes, messages et identités que l'API REST.

1. Connecter le serveur

OTPBox exécute un serveur MCP distant (HTTP en streaming) sur https://otpbox.io/mcp, authentifié avec la même clé bearer que l'API REST. Ajoutez-le à un client compatible MCP — Claude, Cursor, ou votre propre framework d'agents :

{
  "mcpServers": {
    "otpbox": {
      "url": "https://otpbox.io/mcp",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Obtenez une clé sans aucun compte — POST /api/v1/keys/free (voir Obtenir une clé) — ou générez une clé d'organisation depuis le tableau de bord si plusieurs agents ou projets doivent partager un même quota mutualisé.

2. Les outils à la disposition d'un agent

Le serveur expose 13 outils au total ; voici ceux qu'une tâche d'inscription et de vérification utilise réellement. Liste complète et détails des arguments dans la documentation.

Outil	À utiliser pour…
create_test_inbox	Obtenir une nouvelle adresse jetable avant de démarrer l'inscription.
wait_for_email	Bloquer jusqu'à ce que quelque chose arrive, plutôt que l'agent ne boucle lui-même.
get_otp	Lire uniquement le code extrait du message le plus récent.
get_verification_link	Lire le lien de confirmation/réinitialisation/connexion magique extrait, au lieu d'un code.
get_latest_email	Lire le message complet quand l'agent a besoin de plus que le code (objet, corps, expéditeur).
create_test_identity	Obtenir un nom, un pays et un profil en plus de la boîte, pour un formulaire d'inscription qui veut une personne crédible, pas juste une adresse e-mail.
delete_inbox	Nettoyer une fois la tâche terminée.

3. Une tâche d'agent typique

Avec une instruction du type "inscris-toi sur acme.example.com et confirme que le compte existe", un agent disposant des outils OTPBox et d'un outil de navigateur (ou de sa propre capacité HTTP) tend à suivre à peu près cette séquence — c'est le schéma des appels d'outils, pas du code littéral, puisque le modèle de l'agent lui-même décide de l'ordre et des éventuelles nouvelles tentatives :

1. create_test_inbox()
   -> { id: "a1b2c3", address: "bold.quartz844@otpbox.io", expiresAt: ... }

2. (drive the browser) fill the signup form's email field with that address,
   submit

3. wait_for_email({ inboxId: "a1b2c3", timeoutSeconds: 20 })
   -> { timedOut: false, message: { code: "482913", ... } }

   // or, if the agent only wants the code and not the whole message:
   get_otp({ inboxId: "a1b2c3" })
   -> { code: "482913", messageId: "msg_..." }

4. (drive the browser) type "482913" into the OTP field, submit

5. delete_inbox({ inboxId: "a1b2c3" })

Préférez wait_for_email plutôt que de faire appeler get_otp à l'agent dans une boucle manuelle de nouvelles tentatives — c'est un seul appel qui bloque côté serveur (jusqu'à 25 secondes) au lieu de plusieurs appels consommant chacun une unité de quota.

4. Tests en masse et pilotés par des personas

Un agent chargé de quelque chose comme "crée 10 comptes de test avec des pays différents et confirme que chacun se vérifie" peut utiliser create_bulk_test_identities (un template plus un nombre de 1 à 50) au lieu d'appeler create_test_inbox en boucle — chaque identité revient avec un nom, un e-mail et un profil adapté au pays déjà rattachés, soutenus par sa propre vraie boîte. Templates : us_customer, indian_customer, european_customer, business_customer, student, employee.

Limites auxquelles un agent se heurtera

• Chaque appel d'outil compte comme une requête sur le quota mensuel de la clé (Gratuit : 200/mois ; Pro : 5 000/mois mutualisées par organisation — voir tarifs), au même titre qu'un appel REST. Un agent qui boucle inutilement l'épuise tout aussi vite qu'une suite de tests bavarde.
• Les appels MCP sont en plus plafonnés à 60/minute par clé, donc une boucle d'agent hors de contrôle ne peut pas marteler le serveur, même dans les limites du quota.
• Les échecs se manifestent comme des erreurs d'outil MCP, pas des codes de statut HTTP — un framework d'agent bien conçu devrait traiter un résultat d'erreur d'outil comme un signal pour s'arrêter et reconsidérer, pas simplement réessayer aveuglément.
• Une clé créée avec des portées restreintes (tableau de bord → clé → portées) rejettera les outils hors de ces portées avec une erreur de portée insuffisante — utile pour confier à un agent une clé qui ne peut que créer des boîtes et lire des OTP, rien d'autre.

Étapes suivantes

Prêt à l'intégrer à votre propre agent ? Créer un compte gratuit

← Retour à OTPBox