Keyzer in je AI-assistent.

Dit heb je nodig

Een persoonlijke testsleutel van de beheerder (begint met kz_test_) en een AI-client die externe MCP-servers ondersteunt. Je hebt geen beheerderswachtwoord nodig.

Het serveradres is:

https://keyzer-5b90f9adad8e.herokuapp.com/mcp

Bij OAuth opent een Keyzer-aanmeldpagina. Vul je testsleutel daar in en geef toestemming. Plak de sleutel niet in je chat. De sleutel is ook geen OAuth-client-ID of client secret.

Claude Desktop en claude.ai

1. Open Customize → Connectors → + Add → Add custom connector.
2. Noem de connector Keyzer, vul het serveradres hierboven in en kies Continue.
3. Kies bij aanmelden Sign in now. Kies als OAuth-client Register automatically. Die automatische registratie wordt door Keyzer ondersteund.
4. Klik op verbinden. Vul op de Keyzer-pagina je testsleutel in en bevestig de toegang.
5. Open een chat en schakel Keyzer in via + → Connectors.

Bij Team of Enterprise moet een eigenaar of beheerder de connector mogelijk eerst beschikbaar maken. Daarna verbindt iedere tester met zijn eigen sleutel.

Zie de officiële Claude-instructies. Deze cloudverbinding vereist geen lokale installatie.

Claude Code

Voer dit uit in je terminal:

claude mcp add --transport http --scope user keyzer-cloud https://keyzer-5b90f9adad8e.herokuapp.com/mcp

1. Open Claude Code en voer /mcp uit.
2. Selecteer keyzer-cloud en kies aanmelden/authenticeren.
3. Vul je testsleutel in op de Keyzer-pagina die in je browser opent.
4. Ga terug naar Claude Code en probeer de voorbeeldvraag hieronder.

De naam keyzer-cloud houdt een eventueel bestaande lokale Keyzer-aansluiting apart.

Officiële Claude Code-documentatie.

Cursor

1. Open de MCP-instellingen in Cursor, of bewerk je persoonlijke bestand ~/.cursor/mcp.json.
2. Voeg deze server toe onder mcpServers. Behoud je bestaande servers.

{
  "mcpServers": {
    "keyzer-cloud": {
      "url": "https://keyzer-5b90f9adad8e.herokuapp.com/mcp"
    }
  }
}

Verbind vervolgens met keyzer-cloud in Cursor. Rond de OAuth-aanmelding in je browser af met je testsleutel. Schakel de server in en gebruik hem in een Agent-chat.

Ondersteunt jouw clientconfiguratie geen OAuth, voeg dan binnen de serverinstellingen toe: "headers": {"Authorization": "Bearer JOUW_TESTSLEUTEL"}. Vervang de placeholder en bewaar dit alleen in je persoonlijke configuratie.

Officiële Cursor-documentatie.

ChatGPT

1. Open Plugins in ChatGPT. Kies + → Add custom MCP server.
2. Geef de naam Keyzer en een korte beschrijving op. Vul bij de verbinding het serveradres in.
3. Kies OAuth. Gebruik automatische clientregistratie (DCR) als die keuze verschijnt; je testsleutel hoort niet in de velden voor client-ID of client secret.
4. Bevestig de melding voor de aangepaste server en maak de plugin aan. Volg de aanmelding en vul op de Keyzer-pagina je testsleutel in.
5. Installeer de plugin. Start een nieuwe chat en selecteer Keyzer via @.

Beschikbaarheid hangt af van je account en de instellingen van je werkruimte. In een oudere interface kan deze functie onder Apps staan.

Officiële ChatGPT-instructies.

Andere MCP-clients

Gebruik transport Streamable HTTP en het serveradres dat eindigt op /mcp. Keyzer ondersteunt OAuth met automatische clientregistratie en PKCE (S256), met scope mcp:read.

Je kunt ook rechtstreeks authenticeren met deze HTTP-header:

Authorization: Bearer JOUW_TESTSLEUTEL

Vervang de placeholder door je eigen sleutel in de beveiligde clientinstellingen. Er is geen lokale Keyzer-server nodig.

Test je verbinding

Stel bijvoorbeeld deze vraag:

Gebruik Keyzer om artikel 15 van de Rijkswet op het Nederlanderschap op te halen. Citeer lid 1 onder c letterlijk en vermeld de bron.

Of: “Zoek met Keyzer drie uitspraken over asiel uit de lokale Rechtspraak-collectie.” Controleer dat je assistent daadwerkelijk een Keyzer-tool aanroept en bronverwijzingen toont. De collectie is een selectie van openbare bronnen, geen garantie op volledige dekking.

Lukt verbinden niet?

• 401 / geen toegang: meld opnieuw aan. Laat de beheerder controleren of je sleutel nog geldig is.
• Verkeerd adres: gebruik /mcp, niet de homepage of /admin.
• Claude kan de OAuth-client niet registreren: kies Register automatically.
• Aangepaste connector ontbreekt: controleer je accountmogelijkheden of vraag je werkruimtebeheerder.
• Eerste zoekopdracht duurt even: de database kan uit slaapstand komen. Een brede zoekvraag kan meerdere seconden duren.
• 429 / server bezet: wacht enkele seconden en probeer opnieuw.

Deel foutmelding, clientnaam en tijdstip met degene die je heeft uitgenodigd. Deel je testsleutel niet mee.