Model Context Protocol (MCP) Server

Sidefish beschikt over een native Model Context Protocol (MCP) server. Hiermee kunnen externe AI-assistenten, agents en code-editors (zoals Claude Desktop, Cursor, Antigravity of custom LLM-pipelines) op een gestandaardiseerde, beveiligde manier rechtstreeks communiceren met uw Sidefish data en workflows.

1. Verbinding & Streaming Transport

Server Endpoint: https://sidefish.app/mcp (of via uw eigen domein: https://dossier.uwkantoor.be/mcp)
Protocol: JSON-RPC 2.0 via HTTP Streaming (Server-Sent Events / Streamable HTTP POST)
Authenticatie: Header x-api-key: <JOUW_API_SLEUTEL> of Authorization: Bearer <OAUTH_ACCESS_TOKEN>

2. Configuratie in AI-Clients

Claude Desktop

Voeg de Sidefish MCP-server toe aan uw claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sidefish": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://sidefish.app/mcp",
        "--header",
        "x-api-key: JOUW_SIDEFISH_API_KEY"
      ]
    }
  }
}

Cursor / VS Code (Cline / Roo Code)

In de instellingen voor MCP-servers:

Type: command (via npx supergateway) of directe sse endpoint verbinding.
Header: Voeg x-api-key toe met uw Sidefish API-sleutel (of Authorization met uw OAuth Bearer token).

3. Beschikbare MCP Tools

Zodra de koppeling actief is, kan uw AI-assistent autonoom de volgende functies aanroepen:

Toolnaam	Invoerparameters	Resultaat / Actie
`get_customers`	`query?: string`, `limit?: number`	Doorzoekt de klantenlijst op naam, e-mailadres of extern dossiernummer.
`get_customer_by_id`	`customerId: string`	Haalt een compleet klantprofiel op inclusief alle gestructureerde kantoorvelden.
`create_session_request`	`customerId: string`, `questionListId: string`, `sendEmail?: boolean`	Start direct een nieuwe vragenlijst of formulieractie voor een specifiek contact.
`get_session_request_status`	`code: string`	Vraagt de actuele status op van een uitgestuurd verzoek.
`create_action_setup`	`customerIds?: string[]`, `customers?: object[]`	Bereidt een vragenlijstactie voor met voorgeselecteerde contacten en levert de deep-link URL op.
`get_action_setup`	`id: string`	Haalt de gegevens en gekoppelde contacten van een voorbereide actiesetup op.
`get_questionlists`	(geen)	Haalt alle beschikbare vragenlijsten en intake-sjablonen van de organisatie op.
`get_portfolios`	`query?: string`, `limit?: number`	Haalt beschikbare portefeuilles/contactgroepen op.
`get_analytics_summary`	`preset: "today" \| "this_month"`	Vraagt actuele kantoorprestaties en voltooiingspercentages op.

4. Voorbeelden van Agent-Prompts

Zodra de MCP-server is gekoppeld, kunt u in natuurlijke taal opdrachten geven aan uw AI-assistent:

"Zoek de klant Pieter Claes op in Sidefish en geef me zijn huidige contactgegevens en polisnotities."

"Start een nieuwe vragenlijst 'Woningverzekering' voor klant ID 64e8b1c4e12a9c001f5a9e32 en stuur hem direct de uitnodigingsmail."

"Welke vragenlijsten staan er momenteel actief in onze Sidefish-omgeving?"

5. Beveiliging & Multi-Tenant Isolatie

Organisatiebeveiliging: De MCP-server handhaaft strikte multi-tenancy. Een AI-agent heeft uitsluitend toegang tot de data van de organisatie die hoort bij de meegeleverde x-api-key.
Audit Logging: Alle door AI-agents aangeroepen tools en acties worden gelogd in het interne organisatielogboek met vermelding van de betrokken records.

1. Verbinding & Streaming Transport​

2. Configuratie in AI-Clients​

Claude Desktop​

Cursor / VS Code (Cline / Roo Code)​

3. Beschikbare MCP Tools​

4. Voorbeelden van Agent-Prompts​

5. Beveiliging & Multi-Tenant Isolatie​