AI-koppeling (MCP)

Met de AI-koppeling praat je AI-assistent rechtstreeks met Renovatieplanner. Je stelt in gewone taal een vraag, bijvoorbeeld “Welke opleverpunten komen het vaakst voor in project Dorpsstraat?”, en de assistent haalt het antwoord live op uit Renovatieplanner. Dat gebeurt altijd met jouw eigen account: de assistent ziet precies wat jij mag zien, en niets meer.

De koppeling werkt via het open Model Context Protocol (MCP). Assistenten die MCP ondersteunen kunnen koppelen, waaronder Claude (claude.ai en de desktop-app), Claude Code, ChatGPT en Microsoft 365 Copilot (via Copilot Studio).

De AI-koppeling is een aparte module die per organisatie wordt geactiveerd. Neem contact op met je contactpersoon bij Renovatieplanner of de helpdesk om de module aan te zetten. Daarna kan iedere medewerker met een Renovatieplanner-account koppelen. Een bewonersaccount kan niet koppelen.

1. 1

   Voeg de verbinding toe in je assistent. Het adres van de koppeling is:

   https://mcp.renovatieplanner.nl/mcp

   • •Claude: Settings → Connectors → Add custom connector, plak het adres.
   • •Claude Code: claude mcp add --transport http renovatieplanner https://mcp.renovatieplanner.nl/mcp
   • •Microsoft 365 Copilot: in Copilot Studio via Tools → Add a tool → Model Context Protocol, authenticatie OAuth 2.0 met Dynamic discovery.
   • •Andere assistenten: kies “remote server” of “Streamable HTTP” en plak hetzelfde adres.
2. 2

   Log in bij Renovatieplanner. Er opent een pagina van Renovatieplanner waarop je met je gewone e-mailadres en wachtwoord inlogt en toegang geeft. Je wachtwoord komt nooit bij de AI-aanbieder terecht.

3. 3

   Vul je verificatiecode in. Gebruikt je account tweestapsverificatie, dan volgt de verificatiestap, precies zoals bij het inloggen op de beheeromgeving.

4. 4

   Stel een testvraag. Bijvoorbeeld “Welke actieve projecten heb ik?”. De assistent gebruikt nu de Renovatieplanner-tools en noemt erbij wat hij heeft opgezocht.

Loskoppelen kan altijd, op de plek waar je de verbinding toevoegde. De assistent verwijdert dan zijn toegang; een eerder uitgegeven token blijft bij Renovatieplanner hoogstens 30 dagen geldig. Wil je zeker weten dat er niets meer opgevraagd kan worden, vraag dan via support@renovatieplanner.nl om intrekking. Je Renovatieplanner-account verandert er niet door.

Opzoeken

• •Projecten zoeken op naam, code, plaats of status, en per project de kerncijfers.
• •Woningen van een project: adres, woningcode, woningtype en inspectiestatus.
• •Inspecties en registraties per woning, inclusief de geregistreerde maatregelen en afmetingen.
• •Formulieren in de bibliotheek en hun opbouw, en ingevulde formulierresultaten met antwoorden, foto's en bestanden.
• •Taken filteren op type, status, uitvoerder, woning, label, hoofdstuk, ruimte of periode, en aantallen en verdelingen van taken, bijvoorbeeld de meest voorkomende opleverpunten.

Voorbereiden en aanmaken

• •Een taak aanmaken of bijwerken.
• •Een formulier aanmaken of aanvullen, met een beschrijving of door een bestaand PDF- of Word-formulier om te zetten.
• •Een bewonersnieuwsbericht klaarzetten als concept.
• •Een document toevoegen aan een project.

Alles wat de assistent aanmaakt, verschijnt direct in Renovatieplanner en is daar te bekijken en aan te passen.

• •Versturen: geen brieven, e-mails of pushberichten.
• •Publiceren: nieuws blijft concept tot een medewerker het publiceert.
• •Verwijderen: geen enkele verwijderactie.
• •Bewonersgegevens opvragen: de koppeling geeft geen aparte velden met namen, telefoonnummers of e-mailadressen van bewoners door. Een woning is voor de assistent een adres met een woningcode. Let wel: adressen, formulierantwoorden, foto's en bestanden kunnen zelf persoonsgegevens bevatten. De volledige bewonersgegevens bekijk je in Renovatieplanner zelf.
• •Instellingen, rechten of abonnementen wijzigen.

• •De assistent werkt met het account van de gekoppelde gebruiker: dezelfde organisaties, projecten en rechten als in de beheeromgeving.
• •Inloggen gebeurt via OAuth 2.1 op een pagina van Renovatieplanner, inclusief tweestapsverificatie. De assistent krijgt een toegangstoken, nooit je wachtwoord.
• •Elke actie wordt gelogd met de gebruiker die haar uitvoerde.
• •Let er als organisatie op wát je aan een AI-assistent vraagt: de antwoorden worden onderdeel van het gesprek bij de AI-aanbieder. Maak hierover afspraken in je eigen AI-beleid.
• •Hoe Renovatieplanner met gegevens omgaat bij de koppeling staat in de privacyverklaring AI-koppeling.