MCP Server

KLICBOT Model Context Protocol server — tools, resources en prompts voor ChatGPT, Copilot, Gemini, Cursor, Claude en andere MCP-clients.

KLICBOT MCP Server

Model Context Protocol (MCP) is de standaard manier om AI-assistenten te koppelen aan externe tools en kennisbronnen. KLICBOT biedt een volledige MCP-server bovenop de REST API v1.

Transport URL / commando Gebruik
Streamable HTTP (remote) https://klicbot.nl/mcp ChatGPT, Copilot Studio, Gemini CLI, Cursor, Claude, eigen agents — met X-API-Key header
HTTP (sidecar) python scripts/run_mcp_http.py → :8002/mcp Productie: nginx proxy /mcp → sidecar
stdio (lokaal) python -m services.klicbot_mcp Claude Desktop, lokale Cursor-config

Vereist KLICBOT MCP add-on op PRO (€199/mnd totaal; jaarbetaling −20% → €159,20/mnd effectief) + geldige API-key (zelfde key als REST v1).

Pricing

Component Prijs
KLICBOT PRO (basis) €119 ex btw/mnd — bevat REST API + webhooks
KLICBOT MCP add-on +€80/mnd → €199/mnd totaal
Jaarbetaling MCP −20% → €159,20/mnd effectief

Enterprise maatwerk (volume, SLA): info@klicbot.nl.

Ondersteunde MCP-clients

Eén remote endpoint (https://klicbot.nl/mcp, Streamable HTTP). Waar je client custom headers ondersteunt, gebruik X-API-Key.

Client Setup Auth
Cursor .cursor/mcp.json → url + headers X-API-Key
Claude Desktop Connectors UI → custom connector URL, of lokaal stdio URL + key, of stdio env
ChatGPT Settings → Apps → Developer mode → Add connector → https://klicbot.nl/mcp (Team/Business/Edu) OAuth of API-key afhankelijk van client; anders REST API
Microsoft Copilot Studio Agent → Tools → Model Context Protocol → MCP onboarding wizard → Server URL API key (header) of OAuth
Gemini CLI ~/.gemini/settings.json → httpUrl + headers X-API-Key
VS Code / GitHub Copilot MCP-extensie of agent mode → remote MCP URL X-API-Key
Eigen agents OpenAI Responses API tools: [{ type: "mcp", server_url: "…" }], LangChain, ADK, … Bearer of X-API-Key

Zie klic-ai-koppeling voor per-client stappen.

Authenticatie

X-API-Key: uw_api_key_hier

Alternatief (remote MCP):

Authorization: Bearer uw_api_key_hier

Tools

Tool Beschrijving
list_klic_requests Paginated lijst aanvragen
get_klic_request Detail van één order_id
get_klic_geojson IMKL GeoJSON (optioneel max_features voor LLM-context)
search_klic_requests Filter op adres/status/order_id
klicbot_capabilities Overzicht tools, resources, discovery-URLs

Resources (SSOT)

URI Inhoud
klicbot://knowledge/index Knowledge index
klicbot://knowledge/kadaster KLIC/WIBON regels
klicbot://knowledge/product Features, exports, tiers
klicbot://knowledge/company Pricing, positionering
klicbot://knowledge/voice Tone of voice
klicbot://knowledge/vision Productvisie
klicbot://docs/* API-docs, webhooks, MCP (markdown)
klicbot://discovery/llms.txt Pointer naar /llms.txt

Prompts

Prompt Doel
klic_melding_voorbereiden KLIC-melding voorbereiden
wibon_naleving_begeleiding WIBON/CROW500-checklist
gis_export_workflow GIS/QGIS/ArcGIS integratie
api_integratie_adviseur REST + MCP architectuur

Cursor (remote MCP)

Voeg toe aan .cursor/mcp.json:

{
  "mcpServers": {
    "klicbot": {
      "url": "https://klicbot.nl/mcp",
      "headers": {
        "X-API-Key": "YOUR_KLICBOT_API_KEY"
      }
    }
  }
}

ChatGPT (connector)

  1. Settings → Apps → Advanced → Developer mode (Team, Business, Enterprise of Edu).
  2. Add connector → URL: https://klicbot.nl/mcp
  3. Naam/beschrijving: bv. KLICBOT — KLIC-aanvragen, GeoJSON, WIBON-kennis
  4. Authenticatie: volg de flow van ChatGPT (OAuth waar vereist). Alternatief: REST API v1 via Responses API met type: "mcp".

Microsoft Copilot Studio

  1. Open je agent → Tools → Add a tool → Model Context Protocol.
  2. MCP onboarding wizard: Server URL https://klicbot.nl/mcp, naam KLICBOT.
  3. Authenticatie: API key → header X-API-Key (of OAuth voor enterprise).
  4. Test tools (list_klic_requests, get_klic_geojson, …) en publiceer de agent.

Zie Microsoft Learn — MCP in Copilot Studio.

Gemini CLI

In ~/.gemini/settings.json (of project .gemini/settings.json):

{
  "mcpServers": {
    "klicbot": {
      "httpUrl": "https://klicbot.nl/mcp",
      "headers": {
        "X-API-Key": "YOUR_KLICBOT_API_KEY"
      },
      "timeout": 30000
    }
  }
}

CLI: gemini mcp add --transport http -H "X-API-Key: YOUR_KEY" klicbot https://klicbot.nl/mcp

Claude Desktop (remote connector)

Settings → Connectors → Add custom connector → URL https://klicbot.nl/mcp (Streamable HTTP). Of lokaal stdio (hieronder).

Cursor / Claude Desktop (lokaal stdio)

{
  "mcpServers": {
    "klicbot": {
      "command": "python",
      "args": ["-m", "services.klicbot_mcp"],
      "cwd": "/pad/naar/klicbot",
      "env": {
        "KLICBOT_API_KEY": "YOUR_KLICBOT_API_KEY",
        "KLICBOT_API_BASE": "https://klicbot.nl"
      }
    }
  }
}

Lokaal testen tegen dev-server:

export KLICBOT_API_BASE=http://127.0.0.1:8000
export KLICBOT_API_KEY=your_key
python -m services.klicbot_mcp

Architectuur

AI-client (ChatGPT, Copilot, Gemini, Cursor, Claude, VS Code)
        │
        ▼
   KLICBOT MCP (/mcp of stdio)
        │
        ├── resources → knowledge/ + docs (SSOT)
        └── tools     → REST API v1 (/api/v1/...)
                              │
                              └── Kadaster + projectdata

Server uitschakelen

Sidecar: stop het run_mcp_http-proces. Geïntegreerde mount (toekomst): KLICBOT_MCP_ENABLED=0.

Productie (nginx → sidecar)

location /mcp {
    proxy_pass http://127.0.0.1:8002;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Start sidecar: KLICBOT_MCP_PORT=8002 python scripts/run_mcp_http.py

Zie ook

API Overview

KLICBOT REST API — automatisering van KLIC-processen voor AI-agenten, ERP en GIS-integraties.

Core Concepts

Kernconcepten in de KLICBOT API — project, KLIC-melding, CROW 500-momenten, checklist en logboek.

Getting Started

Start met de KLICBOT REST API v1 — API-key aanmaken en eerste GET-request.

Endpoints

KLICBOT REST API v1 endpoints — requests, detail en API-key beheer.

Webhooks

Webhooks en events bij KLICBOT — notificaties bij statuswijzigingen en exports.