Démarrage rapide : Connecter un agent IA à votre API

Passez de zéro à votre premier appel API piloté par l'IA en moins de 5 minutes.

Cloud hébergé

Ce guide utilise le cloud hébergé de STOA à mcp.gostoa.dev. Pas besoin de Docker, kubectl ou d'infrastructure. Auto-hébergement ? Consultez le Déploiement hybride.

Ce que vous allez accomplir

À la fin de ce guide, un agent IA (Claude) découvrira et appellera une API via STOA — sans que vous écriviez une seule ligne de code.

Étape 1 : Créer votre compte

1. Rendez-vous sur console.gostoa.dev et cliquez sur S'inscrire
2. Renseignez votre email et choisissez un mot de passe
3. C'est tout — STOA crée votre tenant automatiquement

Vous avez déjà un compte ?

Passez directement à l'Étape 2.

Étape 2 : Connecter Claude à STOA

1. Ouvrez claude.ai (abonnement Pro ou Team requis pour MCP)
2. Allez dans Paramètres → Intégrations → Ajouter un serveur MCP
3. Entrez :
   • URL : https://mcp.gostoa.dev/mcp/sse
   • Nom : STOA Platform
4. Authentifiez-vous avec vos identifiants STOA lorsque demandé

C'est tout. Claude est maintenant connecté à votre passerelle STOA.

Étape 3 : Effectuer votre premier appel d'outil IA

Demandez à Claude :

« Quels outils sont disponibles dans STOA ? »

Claude utilise la connexion MCP pour découvrir votre catalogue d'API et vous montre les outils disponibles.

Ensuite, demandez :

« Utilise l'outil echo pour envoyer un message de test »

Claude appellera l'outil via STOA et retournera le résultat.

Vous venez d'expérimenter le "Time To First Agent Call" — un agent IA a découvert et appelé une API de manière autonome.

---

Ce qui s'est passé en coulisses

┌──────────┐     ┌──────────────┐     ┌─────────────┐
│  Claude  │────▶│ STOA Gateway │────▶│ API Backend │
│ (Agent)  │◀────│  (MCP + Auth)│◀────│             │
└──────────┘     └──────────────┘     └─────────────┘

STOA a géré :

• Découverte : Claude a trouvé les outils disponibles via MCP tools/list
• Authentification : OAuth 2.1 avec PKCE (aucun secret exposé)
• Autorisation : Vérification de l'accès de votre tenant
• Routage : Transfert de l'appel vers le bon backend
• Observabilité : Journalisation de l'appel pour l'analytique

---

Enregistrer votre propre API

Prêt à exposer votre propre API backend comme outil IA ?

1. Dans la Console, allez dans API Backend → Enregistrer une API
2. Entrez le nom de votre API et l'URL du backend
3. STOA génère automatiquement les outils MCP à partir de votre spec OpenAPI
4. Créez une clé API à portée limitée sous Clés API pour l'accès programmatique

Votre API est maintenant appelable par n'importe quel agent IA connecté.

---

Alternative : Utiliser curl au lieu de Claude

Si vous préférez la ligne de commande, vous pouvez appeler STOA directement :

# Obtenir un jeton OAuth
TOKEN=$(curl -s -X POST "https://auth.gostoa.dev/realms/stoa/protocol/openid-connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=${CLIENT_ID}" \
  -d "client_secret=${CLIENT_SECRET}" \
  -d "grant_type=client_credentials" | jq -r '.access_token')

# Lister les outils disponibles
curl -s "https://mcp.gostoa.dev/mcp/tools/list" \
  -H "Authorization: Bearer ${TOKEN}" | jq '.tools[] | {name, description}'

# Appeler un outil
curl -s -X POST "https://mcp.gostoa.dev/mcp/tools/call" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"name": "echo", "arguments": {"message": "bonjour"}}' | jq

---

Étapes suivantes

Objectif	Guide
Connecter Claude sans kubectl	MCP pour développeurs
Créer des outils MCP personnalisés	Développement d'outils MCP
Gérer les abonnements API	Cycle de vie des abonnements
Déployer sur votre propre infrastructure	Déploiement hybride
Comprendre le protocole MCP	Fiche protocole MCP

---

Dépannage

Problème	Solution
Claude ne peut pas se connecter au serveur MCP	Vérifiez que l'URL est https://mcp.gostoa.dev/mcp/sse — notez le chemin /mcp/sse
« Non autorisé » après connexion	Ré-authentifiez-vous : déconnectez puis reconnectez le serveur MCP dans les paramètres de Claude
Aucun outil n'apparaît	Votre tenant n'a peut-être pas encore d'API enregistrée — enregistrez-en une dans la Console
curl retourne 401	Jeton expiré (par défaut : 5 min) — relancez la commande de jeton