Skip to main content
Sanne van Opstal-Brakel
Employee
Employee
Oct 15, 2026 6:45 AM UTC

De TOPdesk MCP is live

Je team vraagt vast al elke dag hulp aan Copilot, Claude of ChatGPT. Vanaf vandaag kan dat ook met je eigen TOPdesk-gegevens, via de TOPdesk MCP. Alle klanten met TOPdesk Excellent kunnen hem gebruiken.
 

Wat kun je ermee?

Stel je AI-tool een vraag als “Staat melding M 2310 834 nog open, en wie werkt eraan?” of “Vat KI 0001 samen in drie punten”. Je krijgt het antwoord rechtstreeks uit je eigen TOPdesk-gegevens.

Voorlopig werkt de MCP met je meldingen en je kennisbank. Je AI-tool kan meldingen opsommen en opzoeken, en vragen beantwoorden over een kennisitem als je het nummer geeft. Open vragen stellen en antwoorden krijgen uit je hele kennisbank volgt binnenkort.

De MCP is alleen-lezen en beperkt tot je eigen omgeving. Je hoeft geen eigen connector te bouwen en er reikt niets verder dan zou moeten.
 

Jij houdt de controle

Je applicatiebeheerder bepaalt waar de AI-tool bij mag, en elke gebruiker ziet alleen wat zijn of haar eigen TOPdesk-rechten toestaan. Elke actie wordt vastgelegd in het MCP-auditlog, zodat je altijd kunt zien wat er is gebeurd.
 

Zo ga je aan de slag

De verbindingsgegevens vind je in je TOPdesk-omgeving. In de documentatie over de TOPdesk MCP-server lees je stap voor stap hoe je alles instelt. Werk je met Microsoft Copilot? Volg dan Using the TOPdesk MCP agent in Microsoft Copilot.
 

Geen Excellent?

Je kunt AI-tools op elk pakket met TOPdesk verbinden. De REST API zit in Essential, Engaged en Excellent, en een deel van jullie draait al een eigen MCP-connector erop. Dat kun je gewoon blijven doen. Excellent is er voor organisaties die willen dat TOPdesk de beheerde, beveiligde verbinding voor hen bouwt en onderhoudt.
 

Laat weten hoe je hem gaat gebruiken

Welke vraag stel jij je AI-tool als eerste? Deel hem in de reacties, of lees meer in ons eerdere bericht.

13 replies

New Member ⭐⭐
Oct 21, 2026 9:43 AM UTC

Is there a way to give me documentation for my organization that TOPdesk connection does everything in TOPDesk environment and everything is safe and reliable? Every time I want to do or make integrations I get stuck with Group Policy by our mother company in France. 

Translate
Sanne van Opstal-Brakel
Employee
Employee
Oct 27, 2026 8:41 AM UTC

​@Bas Verschuren  this is our AI policy, would that help you: https://page.topdesk.com/hubfs/1.0%20TOPdesk%20AI%20Policy%2020251016.pdf 

Translate
Sanne van Opstal-Brakel, your TOPdesk Community Fairy Godmother
New Member ⭐⭐
Oct 27, 2026 10:13 AM UTC

thanks, I will add this to my ticket. Maybe it will work ;)

Translate
ArjanH
Contributor
Oct 27, 2026 12:16 PM UTC

Ik heb de mcp ingericht op onze azure omgeving (geen copilot)

maak ik krijg nu deze melding 
 

Arjan, ik heb geprobeerd om in de TOPdesk ACC-kennisbank te zoeken naar kennisitems over koffie.

Zoeken werkt nog niet

De verbinding met TOPdesk is beschikbaar, maar de zoekfunctie geeft nog steeds deze foutmelding:

Semantic search is not enabled for this tenant
 

Tool Name

ask_knowledge_base

Request Params

<redacted>

Domain

knowledge

Operation

Read

Outcome

Failure

Status Code

403

terwijl als ik een kennisitem zelf zoek het wel lukt 
 

Payload

Tool Name

get_knowledge_item

Request Params

KI 0459

Domain

knowledge

Operation

Read

Outcome

Success

Status Code

200

Resolved Names

{ "refName": "KI 0459" }

Translate
Functioneel beheerder & AI‑specialist — 80% mens, 20% autocomplete.
Sanne van Opstal-Brakel
Employee
Employee
Oct 27, 2026 3:31 PM UTC

Klinkt als iets voor support ​@ArjanH  kan je hem daar eens inschieten? 

Translate
Sanne van Opstal-Brakel, your TOPdesk Community Fairy Godmother
ArjanH
Contributor
Oct 28, 2026 7:28 AM UTC

het probleem is met de upgrade van vannach opgelost 
we kunnen weer testen en hier wat moois van maken 😀

Translate
Functioneel beheerder & AI‑specialist — 80% mens, 20% autocomplete.
ArjanH
Contributor
Oct 28, 2026 9:03 AM UTC

Eerste test met MCP geslaagd: Automatisch kennisitems opbouwen en koppelen

Ik heb zojuist een eerste test gedraaid met het Model Context Protocol (MCP) en het resultaat stemt me erg vrolijk. Het proces werkt precies zoals je hoopt.

De opzet en de motor erachter De input was simpel: een paar afbeeldingen en een stuk ruwe tekst. Het echte werk gebeurt echter onder de motorkap. Hier zit een uitgebreide prompt achter die onze specifieke tone of voice kent en exact weet hoe wij kennisitems opbouwen. Dankzij die sturing neemt de MCP de volledige flow over en rolt de tekst er direct bruikbaar uit.

De workflow in de praktijk:

  • Zoeken: De MCP zoekt eerst alle bestaande kennisitems op over het onderwerp.

  • Analyseren: Vervolgens weegt het af of de nieuwe input een aanvulling is op een bestaand artikel, of dat het een losstaand onderwerp is.

  • Beslissen: In dit specifieke geval besloot de MCP correct dat het geen aanvulling was, maar een compleet nieuw kennisitem.

  • Schrijven: Het model schreef de tekst vervolgens volledig uit in onze huisstijl, geleid door de achterliggende prompt.

Wat het extra sterk maakt De MCP schrijft niet alleen platte tekst, maar behoudt ook de context. Tijdens het uitschrijven verwerkte het model direct koppelingen naar bestaande kennisitems. Waar een specifiek onderdeel extra verdieping nodig had, verwees de tekst automatisch naar de juiste, al aanwezige artikelen in de kennisbank.

Dit is een flinke stap vooruit in het onderhouden van documentatie zonder dat de samenhang tussen artikelen verloren gaat. Zijn er hier meer mensen die al experimenteren met vergelijkbare MCP-workflows en gestructureerde prompts?

 

 

Translate
Functioneel beheerder & AI‑specialist — 80% mens, 20% autocomplete.
Huibert Harmanny
Explorer ⭐⭐⭐⭐
Nov 10, 2026 1:41 PM UTC

Dit klinkt als muziek in mijn oren!
Ik ben aan het testen met het opzetten van de MCP connector in onze test omgeving. 
De stappen in de documentatie zijn helder en goed te volgen. 
Ik heb netjes een OAuth2.0 connectie met client id en secret opgezet naar de test omgeving. Bij testen volgt het Topdesk inlogvenster. Ik meld me aan, en krijg vervolgens een foutmeldingsscherm:
 

 

Ik vraag me af wat ik fout heb gedaan. Hoe ga ik het beste verder vanaf hier?

Translate
Welke persoon of welk proces gaat hier beter door kunnen werken?
ArjanH
Contributor
Nov 10, 2026 1:56 PM UTC

kan je aangeven ik welke llm je het aan het doen bent dit lijkt namelijk een call back probleem 

Translate
Functioneel beheerder & AI‑specialist — 80% mens, 20% autocomplete.
Huibert Harmanny
Explorer ⭐⭐⭐⭐
Nov 10, 2026 1:57 PM UTC

Jij bent snel! Ik doe dit vanuit Copilot studio / power automate custom connectors.

Translate
Welke persoon of welk proces gaat hier beter door kunnen werken?