> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ardoiseeduc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégration MCP

> Utiliser les outils Marketplace autorisés avec un client Model Context Protocol.

## Même périmètre que l'API publique

Le serveur Model Context Protocol fournit une interface d'intégration aux fonctions publiques du Marketplace. Il partage les clés, scopes, restrictions de pays et contrôles de l'[API REST](/fr/plateforme/api). Il ne donne pas accès aux notes, à la paie ou aux preuves privées des élèves et n'accorde pas de pouvoir de décision sur les contrats.

## Connecter un client

1. Créez le compte développeur et générez une clé dans le parcours [API publique](/fr/plateforme/api).
2. Configurez le client MCP compatible pour l'endpoint distant `https://api.ardoiseeduc.com/mcp` et l'en-tête `Authorization: Bearer VOTRE_CLE`. Le format exact de configuration dépend du client ; gardez la clé côté serveur.
3. Listez les outils disponibles, puis testez une lecture dans le pays autorisé. Pour une écriture, vérifiez les paramètres et la permission avant l'appel ; ne transmettez pas de dossier élève privé.

## Outils publiés

| Outil | Scope | Usage |
| - | - | - |
| `list_countries` | Aucun | Référence des pays configurés |
| `search_schools` | `marketplace:read` | Profils publics admissibles dans le pays autorisé |
| `get_school_profile` | `marketplace:read` ou `school:profile` | Profil public autorisé, limité à l'établissement pour la clé scolaire |
| `search_teachers` | `marketplace:read` | Profils publics de tuteurs dans le pays autorisé |
| `list_jobs` | `marketplace:read` | Offres d'emploi autorisées |
| `list_certified_partners` | `marketplace:read` | Partenaires approuvés |
| `submit_lead` | `leads:write` | Soumettre un contact admissible au suivi commercial |

## Pays, audit et erreurs

Une clé liée à un pays ne peut pas élargir son accès en fournissant un autre pays ou un identifiant étranger. L'absence de périmètre autorisé refuse l'accès ; omettre `country` n'accorde pas tous les pays. Une liste technique de pays n'est pas une preuve d'offre School autrichienne ou d'approbation réglementaire.

Les appels font l'objet du suivi prévu par le service. Une erreur de permission, clé révoquée ou ressource absente doit être traitée avant toute relance. Les accès de support scolaire restent des autorisations distinctes, explicites et temporaires : voir [partenaires](/fr/plateforme/partenaires-certifies).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.