Helpcentrum

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 is op dit moment alleen-lezen: assistenten kunnen je organisatie bevragen, niet wijzigen. Veilige, afgebakende schrijfacties staan op de roadmap en komen in een latere release.

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 leestools — collega’s, rollen en cirkels opsommen en inspecteren; vacante rollen vinden; en de werkbelasting in de organisatie samenvatten — 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 Sleutel aanmaken. 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. Elke assistent heeft het endpoint en je API-sleutel in zijn configuratie nodig.

Claude Desktop

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 ondersteunt aangepaste MCP-servers in Developer Mode (beta). Schakel het in onder Settings > Connectors > Advanced > Developer mode en voeg dan een connector toe die verwijst naar https://mcp.peerdom.org/mcp.

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" }
}
De gepubliceerde connectoren van de ChatGPT-consumentenapp vereisen OAuth, wat de Peerdom-server nog niet aanbiedt — gebruik voorlopig dus Developer Mode of de Responses API. OAuth-ondersteuning komt eraan (zie Wat werkt vandaag).

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 authenticeert met een API-sleutel-header, wat elke developer- en IDE-assistent ondersteunt. Cloud-chatapps die alleen aanmelden met OAuth accepteren, zijn nog niet bereikbaar — dat is één geplande functie, geen beperking van je data.

ClientWerkt vandaagHoeOpmerkingen
Claude Desktop✅mcp-remote-brugNative connector-UI heeft geen headerveld — gebruik de bovenstaande config
Claude Code✅DirectSluit het netst aan
Cursor✅Directheaders in mcp.json
VS Code / Copilot✅DirectBusiness/Enterprise: beheerder moet MCP inschakelen
ChatGPT — Developer Mode✅DirectBeta; controleer het veld voor aangepaste headers in de UI
OpenAI Responses API✅DirectNative mcp-tool
Gemini CLI✅DirecthttpUrl + headers
LM Studio / lokale agents✅DirectHoud het model lokaal of Zwitsers gehost
claude.ai (web)⏳—Aangepaste connectoren vereisen OAuth — komt binnenkort
ChatGPT — gepubliceerde connectoren⏳—Vereisen OAuth — komt binnenkort
Gemini consumentenapp❌—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":{}}}'

Een ontbrekende of ongeldige sleutel geeft 401 Missing X-Api-Key header terug.

Veelgestelde vragen

Kan de assistent mijn organisatie wijzigen?

Nee. De MCP-server is op dit moment alleen-lezen — assistenten kunnen je data lezen en samenvatten, maar kunnen niets aanmaken, bewerken of verwijderen. Veilige, afgebakende schrijfacties komen in een latere release.

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 waarmee je een request-header kunt instellen — 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