> ## 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.

# MCP-Integration

> Freigegebene Marketplace-Werkzeuge mit einem Model-Context-Protocol-Client verwenden.

## Derselbe Umfang wie die öffentliche API

Der Model-Context-Protocol-Server bietet eine Integrationsschnittstelle zu öffentlichen Marketplace-Funktionen. Schlüssel, Berechtigungen, Ländergrenzen und Prüfungen entsprechen der [REST-API](/de/plateforme/api). Er stellt keine Noten, Gehaltsdaten oder privaten Lernnachweise bereit und überträgt keine Entscheidungsrechte über Verträge.

## Client verbinden

1. Erstellen Sie ein Entwicklerkonto und erzeugen Sie über den Ablauf der [öffentlichen API](/de/plateforme/api) einen Schlüssel.
2. Konfigurieren Sie einen kompatiblen MCP-Client für `https://api.ardoiseeduc.com/mcp` und den Header `Authorization: Bearer IHR_SCHLUESSEL`. Das Konfigurationsformat hängt vom Client ab; der Schlüssel bleibt serverseitig.
3. Listen Sie verfügbare Werkzeuge auf und testen Sie einen Lesezugriff im erlaubten Land. Prüfen Sie vor Schreibzugriffen Parameter und Berechtigung; übertragen Sie keine private Schülerakte.

## Veröffentlichte Werkzeuge

| Werkzeug | Berechtigung | Zweck |
| - | - | - |
| `list_countries` | Keine | Referenz konfigurierter Länder |
| `search_schools` | `marketplace:read` | Zulässige öffentliche Profile im erlaubten Land |
| `get_school_profile` | `marketplace:read` oder `school:profile` | Erlaubtes öffentliches Profil, bei Schulschlüsseln auf die Einrichtung begrenzt |
| `search_teachers` | `marketplace:read` | Öffentliche Lehrkraftprofile im erlaubten Land |
| `list_jobs` | `marketplace:read` | Erlaubte Stellenangebote |
| `list_certified_partners` | `marketplace:read` | Genehmigte Partner |
| `submit_lead` | `leads:write` | Zulässigen Kundenkontakt übermitteln |

## Länder, Audit und Fehler

Ein landgebundener Schlüssel erweitert seinen Zugriff weder durch ein anderes angefragtes Land noch durch eine fremde Kennung. Ohne zulässigen Berechtigungsumfang wird der Zugriff abgelehnt; ein fehlender `country`-Parameter erlaubt nicht alle Länder. Eine technische Länderliste belegt weder ein österreichisches School-Angebot noch eine behördliche Zulassung.

Aufrufe werden gemäß dem vorgesehenen Dienstprotokoll erfasst. Klären Sie Berechtigungsfehler, widerrufene Schlüssel oder fehlende Ressourcen vor einer Wiederholung. Schulischer Support benötigt gesonderte, ausdrückliche und befristete Freigaben: siehe [Partner](/de/plateforme/partenaires-certifies).


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