Claude MCP

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten zoals Claude externe tools kunnen aanroepen. Finn draait een MCP-server. Je kunt Claude dus koppelen aan je Finn-account en spraakagents bouwen door ze in een gesprek te beschrijven, in plaats van de builder handmatig in te vullen.

Wat deze server doet. Hij leest je Finns en maakt of bewerkt concepten. Meer kan hij niet. Hij kan geen Finn lanceren, geen nummer bellen, je tegoed niet uitgeven, geen contacten aanpassen en geen transcripties lezen. Dat blijft bewust in het dashboard. In de sectie Reikwijdte hieronder lees je waarom.

Voor wie is dit bedoeld? Voor iedereen die Claude al gebruikt en een agent liever beschrijft dan klik voor klik opbouwt. Je hoeft geen code te schrijven. Gebruik je Claude niet, dan mis je niets: het dashboard kan alles wat deze server biedt, en meer.

Er zijn precies twee manieren om te koppelen, en je hebt er maar één nodig:

Reikwijdte: wat de server wel en niet kan

Dit is een bewuste keuze, en die wordt op twee plekken afgedwongen: de server stelt die tools niet beschikbaar, en de backend weigert de onderliggende verzoeken, ook als iets erom vraagt. De reden is de connectorlink die hieronder wordt beschreven. Die link is zelf een inloggegeven. Een uitgelekte link kan dus in het ergste geval je Finns lezen en je concepten bewerken. Dat is te herstellen. "Bel mijn klanten en geef mijn tegoed uit" is dat niet.

Wat dit voor jou betekent: Claude bouwt de Finn, jij lanceert hem. Elke Finn komt binnen als concept. Je controleert hem in het dashboard en drukt zelf op de knop.

Stap 1: een sleutel genereren

Ga in het dashboard naar Instellingen → Integraties → AI-assistenten (MCP) → Sleutel genereren.

De naam die je de sleutel geeft, is de naam waaronder de connector in Claude verschijnt. Vernoem hem dus naar de plek waar je hem wilt gebruiken, zoals "werklaptop" of "desktop thuis". Twee sleutels zijn dan twee herkenbare items in plaats van twee identieke regels.

Je sleutel begint met finn_mcp_, gevolgd door een lange tekenreeks. Hij wordt maar één keer getoond. Kopieer wat je nodig hebt voordat je het dialoogvenster sluit. Ben je hem kwijt, trek de sleutel dan in en genereer een nieuwe.

Een paar dingen die je over sleutels moet weten:

• Een sleutel draagt je identiteit. Een Finn die je met je sleutel aanmaakt, komt in jouw organisatie terecht, op jouw naam. Gebruik je de sleutel van een collega, dan verschijnt de Finn in diens account en kun je hem zelf niet vinden.
• Er zijn geen scopes of niveaus. Elke sleutel kan alles wat bij "Kan" hierboven staat, en niets van wat bij "Kan niet" staat.
• Intrekken werkt direct. De server controleert de sleutel bij elke afzonderlijke aanroep opnieuw tegen je account, dus een ingetrokken sleutel werkt bij het volgende verzoek al niet meer — niet pas aan het einde van een sessie.

Stap 2 — Claude koppelen

Het dialoogvenster met je nieuwe sleutel biedt beide opties, elk met één kopieerknop. Kies de optie die past bij hoe je Claude gebruikt.

Optie 1 — Claude-app (claude.ai of Claude Desktop)

Dit is wat de meeste mensen willen. Niets te installeren, niets aan te passen.

Kopieer je connectorlink uit het dialoogvenster. Die ziet er zo uit, met je eigen sleutel aan het einde:

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

Ga daarna in Claude als volgt te werk:

1. Open Customize → Connectors, klik op + en kies Add custom connector.
2. Plak de link als URL van de externe MCP-server en klik op Add. De connector verschijnt onder de naam van je sleutel.
3. Open in een nieuwe chat + → Connectors, zet Finn aan en vraag Claude een Finn aan te maken.

Twee dingen om te weten over abonnementen: met het Free-abonnement kun je één aangepaste connector toevoegen, en bij Team- en Enterprise-abonnementen kan alleen een Owner er een toevoegen, via Organization settings → Connectors. Alle anderen klikken daarna op Connect.

Het nadeel: een aangepaste connector heeft maar één URL-veld en geen plek voor een wachtwoord, dus de link zelf is de inloggegeven. Behandel de volledige URL zoals je je dashboardwachtwoord zou behandelen — plak hem niet in een chat, ticket, screenshot of repo.

Optie 2 — Claude Code (terminal)

Kopieer het commando uit het dialoogvenster. Het staat op één regel, dus je kunt het zonder problemen plakken in bash, zsh, PowerShell en cmd:

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

1. Plak het commando in een terminal en voer het uit.
2. Voer claude uit.
3. Vraag Claude een Finn aan te maken.

Hierbij staat de sleutel in een header in plaats van in de URL. Dat is de veiligste van de twee opties.

Andere MCP-clients

De server gebruikt streamable HTTP, geen stdio, en is stateless — er is geen sessie die geopend wordt of verloopt. Elke client die een HTTP MCP-endpoint ondersteunt, werkt met beide hierboven beschreven toegangswegen: de sleutel in een Authorization: Bearer-header naar /mcp, of de sleutel als laatste padsegment van /mcp/<key>.

claude_desktop_config.json is geen van de opties. Dat bestand configureert lokale MCP-servers. De Finn-server draait extern en wordt daarom als aangepaste connector toegevoegd.

Stap 3 — Controleren of het werkt

Vraag Claude:

"Welke Finns heb ik?"

Als de verbinding werkt, krijg je de namen van je eigen Finns te zien. Zegt Claude dat die tool niet bestaat, kijk dan hieronder bij Probleemoplossing.

De tools

Er zijn zes tools, en Claude kiest zelf welke het gebruikt. Je hoeft er nooit zelf een bij naam te noemen.

Een Finn bouwen via een gesprek

Vraag in gewone taal wat je wilt. Het dialoogvenster biedt dit voorbeeld als startpunt:

"Gebruik de Finn-connector om een concept-Finn genaamd Maya te maken die afspraken inplant voor een tandartspraktijk: vriendelijk, beknopt, Engels."

Een uitgebreider verzoek ziet er zo uit:

"Maak een Finn genaamd Skylar die demogesprekken van 15 minuten inplant voor ons salesteam. Warm en beknopt, onderbreekt nooit en bevestigt altijd de datum en tijd aan de beller. Hij bespreekt alleen demo's en planning — als iemand naar prijzen vraagt, biedt hij aan diegene door te verbinden met een medewerker. Gebruik een vriendelijke Engelse vrouwenstem."

Daarvoor heeft Claude vier dingen nodig. Laat je er een weg, dan vraagt Claude ernaar:

Optioneel kun je ook een use-caselabel, een taal, een stem, een openingszin en een eigen woordenlijst opgeven voor namen die de Finn anders verkeerd uitspreekt.

Je krijgt een link naar het nieuwe concept terug, de id ervan, en de organisatie en het account waarin het is aangemaakt. Daarna:

1. Open de link en bekijk het concept in de builder.
2. Vraag Claude om wijzigingen — "maak de openingszin korter", "voeg een vertakking voor voicemail toe" — en Claude past het concept direct aan.
3. Ben je tevreden, koppel dan een nummer en lanceer de Finn in het dashboard. Zie Deployments.

Een dashboardtabblad dat al open stond, toont de nieuwe Finn pas nadat je het opnieuw laadt.

Stemmen

Vraag om een stem met een omschrijving — "een rustige Engelse mannenstem" — en Claude doorzoekt de catalogus voor je.

Let op één ding: nieuwe Finns worden aangemaakt op Cartesia, en een stem-id van een andere provider wordt zonder foutmelding opgeslagen, maar faalt vervolgens bij een echt gesprek. Vraag je om een specifieke provider, controleer dan of het de provider is die je Finn echt gebruikt. Voice Gallery bevat de volledige catalogus.

Beveiliging

De connectorlink is een wachtwoord. Bij de installatie met één link staat de sleutel in de URL, dus iedereen die de URL ziet, heeft jouw toegang. Maak er geen screenshot van, plak hem niet in een gedeelde chat en commit hem niet.

Ga ervan uit dat alles wat je plakt openbaar is. Heeft een sleutel in een chatvenster, ticket of e-mail gestaan? Trek hem dan in en genereer een nieuwe. Dat kost niets.

Intrekken doe je via Settings → Integrations → AI Assistants → Revoke. Dit gaat in bij het volgende verzoek. Finns die al zijn aangemaakt blijven ongewijzigd: als je een sleutel intrekt, wordt niets verwijderd van wat ermee is gemaakt.

Eén sleutel per plek. Met aparte sleutels voor je laptop, je desktop en elke collega kun je er één intrekken zonder de andere te storen, en aan de naam van de connector zie je welke welke is.

Controleer in wiens account je zit. Ben je lid van meer dan één organisatie? Vraag Claude dan eerst "in welke Finn-organisatie zit ik?" voordat je iets aanmaakt. Nieuwe Finns komen terecht in de organisatie waar je het laatst lid van bent geworden.

Problemen oplossen

"Claude heeft geen Finn-tools"

• Open in de Claude-app in de chat + → Connectors en controleer of Finn is ingeschakeld. Connectors worden per gesprek ingeschakeld.
• Start Claude Code opnieuw: het leest de MCP-configuratie bij het opstarten.
• Controleer bij een Free-abonnement of je je enige plek voor een eigen connector niet al voor iets anders hebt gebruikt.

"Deze connectorlink is niet geldig"

De sleutel in de URL is onjuist opgemaakt. Hij moet volledig zijn en beginnen met finn_mcp_, zonder dat er iets van het einde is afgeknipt en zonder slash of spatie aan het eind.

"Deze connectorlink is ingetrokken"

Die sleutel bestaat niet meer. Genereer een nieuwe en werk de connector bij.

"Kan de Finn-backend niet bereiken om je sleutel te verifiëren"

Dit is een tijdelijk probleem aan onze kant en ligt niet aan je configuratie. Probeer het opnieuw. Blijft het probleem bestaan, neem dan contact op met support.

Claude heeft een Finn aangemaakt, maar je kunt hem niet vinden

Bijna altijd zit je in het verkeerde account. Vraag Claude "in welke organisatie is die aangemaakt?". Het antwoord noemt de organisatie en het e-mailadres waar de sleutel bij hoort. Is dat niet van jou, dan gebruik je de sleutel van iemand anders.

Claude zegt dat het een Finn niet kan bewerken

De Finn is al gelanceerd. De server bewerkt alleen concepten. Een live Finn bewerk je in het dashboard.

Volgende

• Een Finn maken →: de builder in het dashboard en wat elk personaveld doet.
• Deployments →: een nummer koppelen en een concept live zetten.
• Voice Gallery →: de volledige stemmencatalogus.
• Integraties →: webhooks en de overige integratiemogelijkheden.