AI-assistenten (MCP)

Met de Peerdom MCP-server kan elke AI-assistent vragen over je organisatie beantwoorden (je mensen, rollen, cirkels, wie wat vervult, waar de gaten zitten) in gewone taal. De server spreekt het Model Context Protocol (MCP), een open standaard om AI-assistenten te verbinden met tools en data, zodat hij werkt met de assistent die je al gebruikt in plaats van je aan één leverancier te binden.

Je verbindt hem met je bestaande Peerdom API-sleutel. Je hoeft aan jouw kant niets te installeren en je bent binnen ongeveer een minuut operationeel.

De MCP-server ondersteunt zowel lezen als schrijven. Assistenten kunnen je organisatie bevragen en, met dezelfde API-sleutel, er wijzigingen in aanbrengen (collega's, rollen en groepen aanmaken, bijwerken en verwijderen). Je API-sleutel bepaalt wat assistenten kunnen doen; trek hem op elk moment in om alle assistenten in één keer te ontkoppelen.

Wat je kunt vragen

Zodra de verbinding tot stand is, kun je je assistent vragen stellen als:

“Met welke organisatie ben ik verbonden?”
“Welke rollen in de cirkel Marketing zijn momenteel vacant?”
“Wie vervult de rol Finance Lead, en wat is hun bijdrage?”
“Welke rollen vervult Maria, en in welke cirkels zitten die?”
“Wie draagt op dit moment de meeste rollen: is iemand overbelast?”
“Toon me onze organisatiestructuur als een overzicht.”

Achter de schermen gebruikt de assistent een set tools: leestools om collega’s, rollen en cirkels op te sommen en te inspecteren, vacante rollen te vinden en de werkbelasting samen te vatten, plus schrijftools om collega’s, rollen en groepen aan te maken, bij te werken en te verwijderen. De assistent kiest op basis van je vraag welke hij aanroept en antwoordt in natuurlijke taal.

Wat elke client nodig heeft

Elke MCP-client maakt verbinding met hetzelfde endpoint met dezelfde header:

Endpoint:  https://mcp.peerdom.org/mcp
Header:    X-Api-Key: <your-api-key>

Je API-sleutel ophalen

Ga naar Instellingen > Mijn gegevens > API-sleutels in Organisatie-instellingen en klik op Nieuwe API-sleutel. Alleen gebruikers met Eigenaar/es-toegangsrechten kunnen API-sleutels aanmaken en beheren. Dit is dezelfde sleutel die door de REST API wordt gebruikt: één sleutel per organisatie.

Je API-sleutel geeft volledige leestoegang tot de gegevens van je organisatie - behandel hem als een wachtwoord. Plak hem nooit in een openbare repository en deel hem niet in een screenshot. Je kunt een sleutel op elk moment intrekken vanuit Organisatie-instellingen, waarmee onmiddellijk elke assistent die hem gebruikt wordt losgekoppeld.

Je client instellen

Kies de assistent die je gebruikt. Op claude.ai en in ChatGPT verbind je direct in de browser; elke andere client heeft het endpoint en je API-sleutel in zijn configuratie nodig.

claude.ai en de Claude-apps

De makkelijkste manier om te verbinden: geen configuratiebestand nodig. Open op claude.ai Settings > Connectors, klik op Add custom connector en plak het endpoint:

https://mcp.peerdom.org/mcp

Klik daarna op Connect. Er opent een Peerdom-pagina die om de API-sleutel van je organisatie vraagt: één keer plakken en je bent klaar. Connectoren die je hier toevoegt, zijn ook beschikbaar in de Claude desktop- en mobiele apps.

Aangepaste connectoren vereisen een betaald Claude-abonnement. Bij het verbinden wordt je API-sleutel ingewisseld voor een privé-toegangstoken; trek je de sleutel in Peerdom in, dan is de assistent direct losgekoppeld.

Claude Desktop

Met een betaald Claude-abonnement dekt de claude.ai-connector hierboven ook de desktop-app. Liever een configuratiebestand - of gebruik je het gratis abonnement? Claude Desktop bereikt externe servers via een kleine brug genaamd mcp-remote. Open Settings > Developer > Edit Config en voeg toe:

{
  "mcpServers": {
    "peerdom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.peerdom.org/mcp", "--header", "X-Api-Key:${PEERDOM_API_KEY}"],
      "env": { "PEERDOM_API_KEY": "your-api-key" }
    }
  }
}

Sla het bestand op en herstart Claude Desktop. De Peerdom-tools verschijnen onder het connectoren-icoon.

Let op: de header heeft geen spatie na de dubbele punt (X-Api-Key:${PEERDOM_API_KEY}). De brug splitst het argument op de eerste spatie, dus door de waarde eraan vast te houden voorkom je een veelvoorkomende verbindingsfout.

Claude Code

Vanuit je terminal:

claude mcp add --transport http peerdom https://mcp.peerdom.org/mcp \
  --header "X-Api-Key: your-api-key"

Voer claude mcp list uit om te bevestigen dat de verbinding tot stand is.

Cursor

Open Settings > MCP > Add new MCP server, of bewerk ~/.cursor/mcp.json rechtstreeks:

{
  "mcpServers": {
    "peerdom": {
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

VS Code / GitHub Copilot

Voeg in agent-modus een .vscode/mcp.json-bestand toe aan je workspace:

{
  "servers": {
    "peerdom": {
      "type": "http",
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "${input:peerdom_key}" }
    }
  }
}

VS Code vraagt de eerste keer om de sleutel en bewaart die veilig.

Op GitHub Copilot Business en Enterprise wordt MCP beheerd door een beheerder en staat het standaard uit. Vraag je Copilot-beheerder om MCP-servers in te schakelen als je de optie niet ziet.

ChatGPT

ChatGPT verbindt via plugins (eerder connectors en daarna apps genoemd). Schakel Developer mode in onder Settings > Plugins > Advanced, voeg een eigen plugin toe die verwijst naar https://mcp.peerdom.org/mcp en kies OAuth als authenticatie. ChatGPT stuurt je naar een Peerdom-pagina waar je de API-sleutel van je organisatie één keer plakt: de sleutel wordt ingewisseld voor een privé-toegangstoken en nooit bij OpenAI opgeslagen.

Voor programmatisch gebruik accepteert de OpenAI Responses API onze server rechtstreeks als een mcp-tool:

{
  "type": "mcp",
  "server_label": "peerdom",
  "server_url": "https://mcp.peerdom.org/mcp",
  "headers": { "X-Api-Key": "your-api-key" }
}

OpenAI hernoemt dit deel van ChatGPT regelmatig: plugins heetten eerder apps, en daarvoor connectors. Verschuiven de menunamen opnieuw, zoek dan de plek waar eigen MCP-servers worden toegevoegd: het endpoint en de OAuth-aanmelding blijven gelijk.

Gemini CLI

Bewerk ~/.gemini/settings.json:

{
  "mcpServers": {
    "peerdom": {
      "httpUrl": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

Lokale en Zwitsers gehoste modellen

Omdat MCP een open standaard is, kun je alles op infrastructuur houden die je vertrouwt. Verwijs een lokale MCP-client zoals LM Studio naar de server:

{
  "mcpServers": {
    "peerdom": {
      "url": "https://mcp.peerdom.org/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}

Combineer een MCP-capabele client met een lokaal open-weight-model (bijvoorbeeld Qwen3, GLM-4.5 of Gemma) voor een volledig offline stack, of met een Zwitsers-soevereine model-API zoals Infomaniak voor een in de EU/CH gehoste opzet. De assistent draait waar jij kiest; alleen je API-sleutel bereikt Peerdom.

Wil je zelf het model kiezen? De handleiding Gebruik je eigen LLM loopt door een developer-opzet met Infomaniaks Zwitsers gehoste, OpenAI-compatibele API als uitgewerkt voorbeeld.

Wat werkt vandaag

De server ondersteunt twee routes: een API-sleutel-header, die elke developer- en IDE-assistent ondersteunt, en aanmelden met OAuth voor cloud-chatapps zoals claude.ai en ChatGPT: daar plak je je API-sleutel één keer op een Peerdom-pagina in plaats van hem in een configuratiebestand op te slaan.

Client	Werkt vandaag	Hoe	Opmerkingen
Claude Desktop	✅	`mcp-remote`-brug	Native connector-UI heeft geen headerveld: gebruik de bovenstaande config
Claude Code	✅	Direct	Sluit het netst aan
Cursor	✅	Direct	`headers` in `mcp.json`
VS Code / Copilot	✅	Direct	Business/Enterprise: beheerder moet MCP inschakelen
ChatGPT: eigen plugins	✅	OAuth-connector	Schakel Developer mode in, voeg de plugin toe: geen configuratie nodig
OpenAI Responses API	✅	Direct	Native `mcp`-tool
Gemini CLI	✅	Direct	`httpUrl` + `headers`
LM Studio / lokale agents	✅	Direct	Houd het model lokaal of Zwitsers gehost
claude.ai (web + apps)	✅	OAuth-connector	Voeg een aangepaste connector toe: geen configuratie nodig
ChatGPT: plugin-directory	⏳	Geen	Nog niet vermeld: voeg het vandaag toe als eigen plugin
Gemini consumentenapp	❌	Geen	Geen ondersteuning voor aangepaste MCP

Controleren of het werkt

Vraag je assistent: “Met welke organisatie ben ik verbonden?” Het antwoord moet de naam van je organisatie zijn: dat bevestigt dat de sleutel, de verbinding en het datapad allemaal werken.

Om zonder client te testen, stuur je rechtstreeks een verzoek:

curl -s -X POST https://mcp.peerdom.org/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'X-Api-Key: your-api-key' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_organization","arguments":{}}}'

Zonder sleutel antwoordt de server met 401 invalid_token; een ongeldige sleutel geeft een tool-fout terug die de sleutel als ontbrekend, ongeldig of verlopen meldt.

Veelgestelde vragen

Kan de assistent mijn organisatie wijzigen?

Ja. Met je API-sleutel kan een assistent collega’s, rollen en groepen aanmaken, bijwerken en verwijderen, waarden van aangepaste velden instellen, rolhouders toewijzen en meer. De meeste AI-clients (Claude Desktop, Claude Code, Cursor enzovoort) tonen elke toolaanroep voordat die wordt uitgevoerd, zodat je elke wijziging kunt bevestigen of annuleren. Sommige handelingen zijn omkeerbaar (een collega verwijderen is een zachte verwijdering waarbij de persoon in je archief blijft), terwijl het verwijderen van een rol of groep definitief is. Gebruik een assistent die je vertrouwt en trek de API-sleutel op elk moment in om alle assistenten in één keer te ontkoppelen.

Bewaart Peerdom mijn API-sleutel?

Nee. Je sleutel wordt bij elk verzoek doorgegeven aan de Peerdom API en wordt nooit op de MCP-server bewaard. Trek hem op elk moment in via Organisatie-instellingen om elke assistent in één keer los te koppelen.

Welke assistenten kan ik gebruiken?

Elke MCP-client. Cloud-chatapps zoals claude.ai en ChatGPT verbinden met OAuth-aanmelding; developer-tools stellen een request-header in: zie Wat werkt vandaag. Je bent niet gebonden aan één leverancier: neem de assistent mee die je al vertrouwt.

Heb ik een specifiek Peerdom-abonnement nodig?

API-toegang is beschikbaar op betaalde abonnementen. Neem contact op met Peerdom support voor details over jouw abonnement.

Welke data kan de assistent zien?

Alles wat je API-sleutel kan lezen: de collega’s, rollen, cirkels, vervullers, vacatures en werkbelasting van je organisatie. Het is afgebakend tot de ene organisatie waartoe de sleutel behoort.

Gerelateerd

Gebruik je eigen LLM, kies je eigen model (Infomaniak, lokaal, soeverein)
Agent-leesbare export (OKF), publiceer je organisatie zodat elke AI-agent die kan lezen
API en Webhooks, eigen integraties bouwen met de REST API
Overzicht integraties, alle beschikbare integraties in een oogopslag
Toegangsrechten, begrijp wie API-sleutels kan aanmaken
Organisatie-instellingen, waar je API-sleutels vindt en intrekt
Je organogram kan nu vragen beantwoorden, het verhaal achter deze integratie