ConnectiviteitAI inference — bring your own AI MCP-server

MCP-server

Liever vanuit je eigen AI-tool werken met de cataloguskennis van dit platform? Dit platform draait een Model Context Protocol-server (streamable HTTP, read-only, geen API-key). Verbind Claude Desktop, Claude Code, Cursor, VS Code, Windsurf of een andere MCP-client met onderstaande URL.

Server-URL

https://<host>/api/mcp

Snelle test vanaf de commandoregel:

bash

curl -s https://<host>/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Voorbeelden per client

Claude Desktop

claude_desktop_config.json

Claude Desktop praat lokaal via stdio, dus brug de HTTP-server met het npx-pakket mcp-remote. Plak dit in claude_desktop_config.json (Settings → Developer → Edit Config) en herstart Claude.

json

{
  "mcpServers": {
    "stadstwin": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://<host>/api/mcp"]
    }
  }
}

Claude Code (CLI)

Eén commando — Claude Code spreekt streamable-HTTP rechtstreeks aan.

bash

claude mcp add --transport http stadstwin https://<host>/api/mcp

Cursor

~/.cursor/mcp.json

Maak (of bewerk) ~/.cursor/mcp.json voor alle projecten, of .cursor/mcp.json in je projectmap. Daarna verschijnt 'stadstwin' onder Settings → MCP.

json

{
  "mcpServers": {
    "stadstwin": { "url": "https://<host>/api/mcp" }
  }
}

VS Code (GitHub Copilot / agent mode)

.vscode/mcp.json

Zet dit in .vscode/mcp.json in je workspace, of voeg het toe via 'MCP: Add Server'.

json

{
  "servers": {
    "stadstwin": { "type": "http", "url": "https://<host>/api/mcp" }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

Bewerk ~/.codeium/windsurf/mcp_config.json (of via Settings → Cascade → MCP Servers).

json

{
  "mcpServers": {
    "stadstwin": { "serverUrl": "https://<host>/api/mcp" }
  }
}

Cline / Continue / overige clients

De meeste MCP-clients accepteren een 'streamable HTTP'- of 'SSE'-server met enkel een URL — geen API-key nodig. Gebruik onderstaande waarden.

text

Naam:       stadstwin
Transport:  Streamable HTTP
URL:        https://<host>/api/mcp
Auth:       geen

Beschikbare tools

list_cities	Welke steden hebben een live city-twin (slug + provincie).
list_categories	Thema's + aantal lagen per thema voor een stad.
search_layers	Zoek lagen op vrije tekst en/of categorie — id, naam, beschrijving, bron, API-endpoint.
get_layer_sample	Metadata + een paar voorbeeld-GeoJSON-features van één laag, om de attributen te zien.

Alle tools zijn read-only en draaien tegen dezelfde catalogus als de AI-assistent en de API Gateway. Layer-data zelf haal je op via /api/v1/layers/<id>?city=<slug> (GeoJSON).