Claude MCP

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten zoals Claude veilig toegang krijgen tot externe tools en gegevensbronnen. Finn biedt een MCP-server, zodat je Finn kunt koppelen aan Claude (of een andere MCP-compatibele client) en je AI-assistent het platform via een gesprek kunt laten bevragen, configureren en bedienen.

Voor wie is dit. Dit is bedoeld voor gevorderde gebruikers — ontwikkelaars, automatiseringsengineers en AI-vaardige operators die Finn willen aansturen vanuit Claude Desktop, Claude Code of een andere MCP-client. Ben je niet bekend met Claude of MCP, dan heb je dit niet nodig — het dashboard doet alles wat de MCP beschikbaar stelt.

Status: de Finn MCP-server is in publieke bèta. De API's zijn stabiel, maar er worden regelmatig tools toegevoegd.

Wat je met de MCP kunt doen

Zodra de koppeling er is, kan jouw Claude (of andere MCP-compatibele AI) het volgende namens jou doen:

Leesbewerkingen

• De status van een deployment opvragen.
• Je Finns, doelgroepen en telefoonnummers weergeven.
• Gesprekstranscripties en analyses voor een willekeurige periode ophalen.
• De gespreksgeschiedenis doorzoeken op specifieke patronen ("toon me gesprekken waarin de beller 'terugbetaling' noemde").
• Deploymentkosten, abonnementsverbruik en factuuroverzichten inzien.

Schrijfbewerkingen

• Een nieuwe deployment starten.
• Een actieve deployment pauzeren of stoppen.
• Contacten toevoegen aan een doelgroep.
• Velden voor analyse na het gesprek bijwerken op een Finn.
• Nummers onderdrukken (toevoegen aan de bel-me-niet-lijst).

Coördinatie

• Automatisch wekelijkse/maandelijkse rapporten genereren.
• Gespreksresultaten vergelijken met je CRM om hiaten in attributie op te sporen.
• Automatisch een nieuwe deployment aanmaken zodra een CRM-lijst een bepaalde omvang bereikt.
• Een deployment samenvatten in begrijpelijke taal, geschikt om te delen met een niet-technische belanghebbende.

De MCP-server instellen

Stap 1 — Een MCP-token genereren

Instellingen → Integraties → MCP → Token genereren.

Kopieer het token meteen — je ziet het maar één keer. Bewaar het in je wachtwoordmanager of secret store.

De tokenscopes zijn instelbaar:

• Alleen lezen — gegevens opvragen maar niet wijzigen
• Lezen + schrijven — volledige operationele toegang (voorzichtig mee zijn)
• Beperkt tot specifieke Finns/doelgroepen — toegang tot een deelverzameling beperken

Begin voor de meeste gebruikers met Alleen lezen om ermee vertrouwd te raken en breid later uit.

Stap 2 — Je MCP-client configureren

Claude Desktop (Mac, Windows):

Bewerk je configuratiebestand van Claude Desktop:

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

Voeg de Finn-server toe:

{
  "mcpServers": {
    "finnai": {
      "command": "npx",
      "args": ["-y", "@finnai/mcp-server"],
      "env": {
        "FINNAI_API_TOKEN": "your_token_here"
      }
    }
  }
}

Start Claude Desktop opnieuw op. De Finn-tools zijn dan beschikbaar in elk gesprek.

Claude Code (CLI):

claude mcp add finnai \
  --command "npx -y @finnai/mcp-server" \
  --env FINNAI_API_TOKEN=your_token_here

Voer daarna claude uit vanuit elke map — Finn-tools zijn beschikbaar.

Andere MCP-clients (Continue, Cursor, custom):

Gebruik hetzelfde npx-commando in de MCP-serverconfiguratie van je client. De server communiceert via standaard MCP over stdio.

Stap 3 — Test de verbinding

Vraag in Claude (welke client dan ook):

"Welke Finns heb ik geconfigureerd?"

Als de verbinding werkt, roept Claude de tool list_finns aan en geeft een echt antwoord.

Tools die de MCP aanbiedt

De server levert ~30 tools. Belangrijkste:

Finn-beheer

• list_finns — alle Finns in het account weergeven.
• get_finn — de volledige configuratie van één Finn ophalen.
• create_finn — een nieuwe Finn maken (geavanceerd).
• update_finn — Finn-instellingen wijzigen.

Doelgroepbeheer

• list_audiences — alle doelgroepen weergeven.
• get_audience_stats — aantallen, validatiestatus, recente imports.
• add_contacts — contacten bulksgewijs toevoegen.
• remove_contact — één contact verwijderen.

Levenscyclus van deployments

• list_deployments — eerdere en actieve deployments weergeven.
• launch_deployment — een nieuwe starten.
• pause_deployment / resume_deployment / stop_deployment.
• get_deployment_status — live status met actuele gespreksaantallen.

Analytics

• get_deployment_analytics — volledige metrics voor een deployment.
• search_calls — gesprekken zoeken die aan inhoudspatronen voldoen.
• get_call — het transcript en de analyse van één gesprek ophalen.
• aggregate_calls — aangepaste rollups op elk veld over elke periode.

Compliance

• add_to_suppression_list — een nummer wereldwijd blokkeren.
• remove_from_suppression_list — blokkering opheffen.
• check_suppression — staat een nummer op de lijst?

Facturering

• get_usage_this_month — lopende uitgaven.
• forecast_month_end — prognose op basis van het verloop.
• set_spend_cap — limieten aanpassen.

Volledig schema per tool: api.hirefinn.ai/academy/mcp.

Dingen die je Claude kunt vragen

Prompts die echt werken:

"Laat de resultaten van de implementatie van gisteren zien en vertel me welke Finn het beste presteerde."

"Zoek alle gesprekken van de afgelopen week waarin de beller 'te duur' zei en vat de gemeenschappelijke context samen."

"Start dezelfde implementatie als die van afgelopen maandag, maar op de nieuwe doelgroep die ik vanochtend heb geüpload."

"Hoeveel hebben we vorige week uitgegeven, en ligt dat op schema ten opzichte van ons budget?"

"Voeg deze telefoonnummers toe aan de blokkeerlijst: [plak lijst]"

"Wat is het verschil in slagingspercentage tussen onze ochtend- en middaggesprekken?"

"Genereer een samenvatting van één pagina van de afsprakenherinneringscampagne van vorige maand voor de praktijkmanager."

De MCP maakt Finn conversationeel. Handelingen die in het dashboard 5 tot 10 klikken kosten, worden één vraag in natuurlijke taal.

Beveiligingsoverwegingen

Wat het token kan doen

De tokenscopes bepalen wat is toegestaan:

• Alleen-lezen token → kan alles opvragen, maar niets wijzigen.
• Lezen + schrijven → volledige operationele toegang. Behandel het als je dashboardwachtwoord.
• Beperkte tokens → begrensd per Finn-ID, doelgroep-ID of type handeling.

Best practices

• Plak tokens niet in chatberichten. Gebruik omgevingsvariabelen in de configuratie van je MCP-client.
• Roteer tokens regelmatig. Instellingen → Integraties → MCP → Roteren.
• Gebruik beperkte tokens voor teamleden. Geef een externe medewerker geen token met volledige toegang.
• Auditlogboek. Elke MCP-aanroep wordt gelogd. Instellingen → Integraties → MCP → Activiteitenlogboek.
• Trek tokens direct in bij een lek. Instellingen → Integraties → MCP → Intrekken.

Wat Claude niet kan doen

De MCP biedt geen toegang tot:

• Accounts aanmaken/verwijderen
• Wijzigingen aan betaalmethoden
• Abonnementen upgraden/downgraden
• Uitnodigingen voor teamleden
• SSO-configuratie

Hiervoor is toegang tot het dashboard nodig. Dat is bewust — dit zijn beslissingen die je door een mens wilt laten nemen.

Gevoelige handelingen goedkeuren

Standaard vereist de MCP expliciete goedkeuring door een mens (via het rechtensysteem van je MCP-client) voor elke schrijfhandeling:

• Implementaties starten
• Contacten toevoegen/verwijderen
• Finn-configuraties wijzigen
• Geld uitgeven

Dit wordt op protocolniveau afgedwongen — Claude kan niet schrijven zonder dat jij het bevestigt in de client-UI. Leeshandelingen vereisen geen goedkeuring.

Je kunt dit per tool uitschakelen onder Instellingen → Integraties → MCP → Lijst automatisch goedkeuren als je wilt dat bepaalde tools zonder bevestiging draaien. Gebruik dit spaarzaam — "launch_deployment" automatisch goedkeuren is een uitstekende manier om snel veel geld uit te geven.

Veelvoorkomende patronen

Dagelijkse standup

Stel Claude in om elke ochtend de statistieken van gisteren op te halen:

"Vat elke werkdag om 9 uur de deploymentresultaten van gisteren samen, markeer eventuele afwijkingen en post het in mijn Slack."

(Vereist Claude Code met geplande taken, of je eigen cron + MCP-wrapper.)

Afwijkingsdetectie

"Controleer of een deployment in de afgelopen 24 uur een succespercentage onder 50% had of meer dan 2x de kosten van het gemiddelde over 7 dagen. Markeer deze met details."

Bulkcontrole

"Toon alle Finns zonder gedefinieerde velden voor analyse na afloop van het gesprek. Stel voor elke Finn redelijke standaardwaarden voor op basis van de identiteitsbeschrijving."

Snelle exports

"Haal alle gesprekken op uit deployment X waarbij qualified=true, exporteer als CSV en mail het naar mij."

Problemen oplossen

"Claude kan de Finn-tools niet vinden"

• Start Claude Desktop opnieuw op na het bewerken van de configuratie.
• Controleer of de configuratie-JSON geldig is (komma's, aanhalingstekens).
• Voer npx -y @finnai/mcp-server --test uit in de terminal om te controleren of de server start.

"Authenticatie mislukt"

• Token verlopen of ingetrokken. Genereer een nieuwe.
• Omgevingsvariabele met het token wordt niet doorgegeven (typefout in de configuratie).

"Time-out bij tool-aanroep"

• Grote query's (bijvoorbeeld zoeken in de gespreksgeschiedenis) kunnen 30+ seconden duren.
• De standaard time-out is in de meeste clients 30s. Verhoog deze indien nodig.

"Toegang geweigerd voor tool X"

• De scope van je token omvat deze tool niet.
• Genereer een nieuw token met een bredere scope, of gebruik het dashboard voor die handeling.

Wat eraan komt

De MCP-roadmap (op het moment van schrijven):

• Workflow-tools — workflows visueel aanmaken en bewerken via Claude.
• Test-on-Call-tool — testgesprekken starten vanuit Claude.
• Streaming-abonnementen — realtime eventstreams voor live deployments.
• Ondersteuning voor meerdere accounts — meerdere Finn-accounts beheren vanuit één Claude-sessie.
• Opnames afspelen — gespreksaudio naar Claude streamen om direct te beluisteren (Enterprise).

Stel tools voor die je wilt hebben via [email protected].

Verder dan Claude

Hoewel deze pagina zich richt op Claude, is de MCP-server providerneutraal. Hij werkt met:

• Continue.dev (VS Code AI-extensie)
• Cursor (AI-first IDE)
• OpenAI ChatGPT Desktop (zodra MCP-ondersteuning beschikbaar is)
• Aangepaste MCP-clients gebouwd op de open specificatie

Elke client die MCP spreekt, kan Finn via dezelfde server gebruiken.

Volgende

• Integraties → REST API — de onderliggende API waar de MCP omheen zit.
• Integraties → Webhooks — pushmeldingen voor event-gestuurde workflows.
• Capaciteit & schaal → — rate limits die gelden voor MCP-aanroepen.