Pillars MCP-server
Met de Pillars MCP-server kunnen AI-assistenten en -platformen die MCP ondersteunen vragen beantwoorden over de gegevens van een bestuur in Pillars. De server volgt het open Model Context Protocol (MCP), met OAuth 2.1 voor het koppelen van accounts.
Adres
Voeg in de AI-toepassing een MCP-server (connector) toe met het adres https://<pillars-adres>/mcp.
De toepassing vindt het inlogadres zelf via /.well-known/oauth-protected-resource/mcp.
Begrenzing
- Het bestuur beslist. De koppeling staat standaard uit. Een bestuursadmin zet hem aan in Pillars onder AI-koppeling en kiest welke gegevensdomeinen gedeeld mogen worden. Domeinen van modules die voor het bestuur uit staan, zijn niet beschikbaar.
- De medewerker geeft toestemming. Bij het koppelen logt de medewerker in met het eigen Pillars-account en kiest welke van de gedeelde domeinen de toepassing mag lezen.
- Alleen lezen, alleen het eigen bestuur en alleen de scholen die de medewerker in Pillars ook mag zien. Leerlingaccounts kunnen niet koppelen.
- Vaste functies, geen vrije zoekopdrachten. Per domein is vastgelegd welke velden worden gedeeld. Er worden geen persoonsgegevens van andere medewerkers of leerlingen gedeeld: resultaten van vragenlijsten alleen geaggregeerd en pas vanaf 5 deelnemers, en namen van ICT-rolhouders worden weggelaten.
- Verantwoording. Elke bevraging wordt een jaar gelogd. Het bestuur ziet de koppelingen en bevragingen en kan koppelingen intrekken.
Gegevensdomeinen
| Domein | Scope | Functies |
|---|---|---|
| Profiel (altijd) | pillars:profile | pillars_context: gebruiker, bestuur (met DUO-bestuursnummer) en scholen (met BRIN en vestigingsnummer) |
| Scholen | pillars:schools.read | pillars_school_profile |
| Hardware | pillars:hardware.read | pillars_hardware_overview, pillars_hardware_list |
| Digitale leermiddelen | pillars:software.read | pillars_software_overview, pillars_software_list |
| Management en organisatie | pillars:management.read | pillars_management (ICT-afspraken en -rollen met uren; zonder namen) |
| Digitale geletterdheid en deskundigheid | pillars:competence.read | pillars_competence_overview (geaggregeerd, vanaf 5 deelnemers), pillars_my_competence_results (alleen de eigen resultaten) |
| AVG (privacy) | pillars:privacy.read | pillars_processing_activities (verwerkingsregister), pillars_security_incidents (alleen voor school- en bestuursbeheerders, zonder gegevens van de melder) |
| Evaluaties en plannen | pillars:evaluations.read | pillars_school_evaluations (alleen voor school- en bestuursbeheerders), pillars_my_evaluations (alleen de eigen) |
| Pillars-score (Vier in balans) | pillars:score.read | pillars_score |
Koppelen met andere systemen
Besturen en scholen zijn te herkennen aan hun DUO-nummers in pillars_context: het bestuursnummer (bevoegd gezag)
en het vestigingsnummer (BRIN + volgnummer). Accounts worden gekoppeld doordat de medewerker één keer inlogt bij Pillars
vanuit de AI-toepassing.
Meer uitleg voor besturen staat op de pagina AI-koppeling.