API MCP superalternance — Branchez votre IA aux offres et formations en alternance

Endpointhttps://www.superalternance.fr/api/mcp

1. Configurer Claude Desktop

Ouvrez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) et ajoutez :

{
  "mcpServers": {
    "superalternance": {
      "url": "https://www.superalternance.fr/api/mcp"
    }
  }
}

Redémarrez Claude Desktop. Le serveur superalternance apparaît dans la barre latérale parmi les outils disponibles.

2. Configurer Cursor / Continue

Dans Settings → MCP Servers, ajoutez une nouvelle entrée :

Nom : superalternance
Transport : HTTP (streamable)
URL : https://www.superalternance.fr/api/mcp

3. Outils disponibles

Le serveur expose 6 outils en lecture seule. Aucune authentification n'est requise — l'API est publique et rate-limitée côté infra.

search_jobs4 paramètres

Recherche les offres d'alternance (apprentissage / pro) en France. Filtre par texte (métier, entreprise) et par lieu (ville, département, région).

search_formations5 paramètres

Recherche les formations en alternance proposées par les CFA français. Filtre par texte, lieu et niveau de diplôme.

get_job1 paramètre

Récupère le détail complet d'une offre par son identifiant.

get_formation1 paramètre

Récupère le détail complet d'une formation par son identifiant.

get_platform_stats0 paramètre

Statistiques globales de la plateforme : nombre d'offres, formations, CFA et date de la dernière synchronisation.

get_metier_stats1 paramètre

Statistiques pour un métier donné : nombre d'offres ouvertes, formations et diplômes recommandés. Le nom est en français (ex. "Vendeur conseil", "Développeur web").

4. Tester en ligne de commande

Le serveur parle JSON-RPC 2.0 sur HTTP. Vérifiez la connexion en trois requêtescurl :

Initialize

curl -X POST https://www.superalternance.fr/api/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": { "name": "demo", "version": "1.0.0" } } }'

Lister les outils

curl -X POST https://www.superalternance.fr/api/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }'

Appeler un outil

curl -X POST https://www.superalternance.fr/api/mcp \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "search_jobs", "arguments": { "query": "développeur web", "place": "Lyon", "limit": 5 } } }'

FAQ

L'API MCP de superalternance est-elle gratuite ?

Oui, l'endpoint est public, gratuit et sans authentification. Un rate-limit s'applique au-delà de quelques centaines de requêtes par minute par IP pour protéger l'infrastructure.

Quels clients MCP sont compatibles ?

Tous les clients qui supportent le transport Streamable HTTP du Model Context Protocol : Claude Desktop ≥ 0.7, Cursor, Continue, Cline, ainsi que les agents construits avec le SDK MCP officiel.

D'où viennent les données exposées ?

Du service public La Bonne Alternance, agrégateur officiel des offres et formations en apprentissage et contrat de professionnalisation en France. superalternance maintient un cache SQLite local rafraîchi toutes les 6 heures.

Combien d'outils sont exposés ?

6 outils en lecture seule : recherche d'offres, recherche de formations, détail d'une offre, détail d'une formation, statistiques globales et statistiques par métier.

Puis-je écrire ou modifier des données via MCP ?

Non. Le serveur n'expose que des outils en lecture. Pour publier une offre, utilisez notre formulaire dédié.

Quel transport MCP est utilisé ?

Le transport Streamable HTTP (spec 2025-03-26). Le serveur est totalement sans état : chaque requête JSON-RPC est indépendante, aucun cookie ni session ID n'est nécessaire.

Branchez votre IA aux offres et formations en un clic.