Georizon koppelen aan een AI-assistent (MCP)

Met de GEORIZON MCP-server koppel je een LLM AI-assistent, zoals Claude, aan je GEORIZON-omgeving. De assistent kan dan datasets bekijken, een levering indienen, het validatierapport lezen, verwerkingen volgen en snapshots maken. Dit artikel geeft het functionele overzicht. De technische specificatie, met configuratievoorbeelden en de volledige lijst met tools, staat op georizon.cloud/docs/mcp.

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee een AI-assistent met externe systemen werkt. De assistent gebruikt jouw persoonlijke token en heeft daardoor precies dezelfde rechten als jij in de webapplicatie. Wat jij niet mag zien of wijzigen, kan de assistent ook niet.

Wat kan de assistent?

• Tenants, datasets en beschikbare ingest templates opvragen
• Een levering indienen en het validatierapport lezen en samenvatten
• Een dataset heropenen, verwerking starten of een levering accepteren
• Verwerkingsruns bekijken, annuleren of opnieuw starten
• Een snapshot maken van een panorama of orthofoto op een coördinaat of adres

Buiten MCP blijven: het uploaden van bestanden (dat gaat via S3) en het aanmaken van toegangssleutels. Datasets maak je op dit moment aan in de webapplicatie. Het aanmaken van datasets via MCP komt binnenkort beschikbaar; zodra dat zo is, kun je de volledige levering vanuit de assistent begeleiden.

Koppelen in vier stappen

1. Maak een token aan op je profielpagina in GEORIZON. Het token moet de scope features-api bevatten.
2. Voeg de server toe aan je assistent met het adres https://georizon.cloud/mcp. Het is een Streamable HTTP-server: je configureert een URL met een Authorization-header, geen lokaal commando.
3. Vul het token in als Authorization: Bearer <token>. Het configuratievoorbeeld per client staat op georizon.cloud/docs/mcp.
4. Test de koppeling door de assistent te vragen welke tenants en datasets beschikbaar zijn.

Een levering begeleiden met de assistent

1. Maak de dataset aan met het juiste ingestprofiel en coördinaatstelsel. Nu nog in de webapplicatie, binnenkort ook via de assistent.
2. Vraag de assistent welke mappenstructuur en metadata het ingest template verwacht.
3. Upload de bestanden met een S3-toegangssleutel, bijvoorbeeld met Cyberduck of WinSCP.
4. Laat de assistent de levering indienen en het validatierapport samenvatten. Bij fouten herstel je de bestanden, heropent de assistent de dataset en dien je opnieuw in.
5. Laat de assistent de verwerking starten en de voortgang volgen.

Beveiliging

• Behandel het token als een wachtwoord. Deel het niet en zet het niet in gedeelde configuratiebestanden of repositories.
• Vermoed je dat een token is uitgelekt, maak dan een nieuw token aan en meld het via het supportportaal.
• Controleer acties met gevolgen, zoals accepteren of verwerking starten, voordat je de assistent ze laat uitvoeren.

In ontwikkeling

Gepland zijn onder meer het aanmaken van datasets via MCP en inloggen via OAuth, zodat je geen token meer hoeft te plakken. De actuele stand staat op georizon.cloud/docs/mcp.