Claude MCP
Styr Finn från Claude via Model Context Protocol.
Model Context Protocol (MCP) är en öppen standard som låter AI-assistenter som Claude anropa externa verktyg. Finn kör en MCP-server, så du kan ansluta Claude till ditt Finn-konto och bygga röstagenter genom att beskriva dem i en konversation i stället för att fylla i byggaren för hand.
Vad servern gör. Den läser dina Finns och skapar eller redigerar utkast. Det är allt. Den kan inte lansera en Finn, ringa ett nummer, använda ditt saldo, röra kontakter eller läsa transkriptioner – det stannar medvetet i dashboarden. Avsnittet Omfattning nedan förklarar varför.
Vem det är för. Alla som redan använder Claude och hellre beskriver en agent än bygger den klick för klick. Du behöver inte skriva kod. Om du inte använder Claude går du inte miste om något – dashboarden gör allt det här exponerar, och mer.
Det finns exakt två sätt att ansluta, och du behöver bara ett:
| Om du använder | Anslut med | Vad du klistrar in |
|---|---|---|
| Claude på claude.ai eller Claude Desktop | En anpassad connector | En länk |
| Claude Code i en terminal | Ett claude mcp add-kommando | En rad |
Omfattning – vad servern kan och inte kan göra
| Kan | Kan inte |
|---|---|
| Lista dina Finns och läsa valfri Finn i sin helhet | Lansera, pausa eller stoppa en Finn |
| Skapa en ny Finn som utkast | Ringa, ta emot eller testa ett samtal |
| Redigera ett utkasts namn, persona, röst, språk och öppningsreplik | Redigera en Finn som redan har lanserats |
| Visa vilken organisation din nyckel tillhör | Köpa eller koppla ett telefonnummer |
| Bläddra i röstkatalogen | Läsa transkriptioner, inspelningar eller analysdata |
| Lägga till eller ta bort kontakter och målgrupper | |
| Se eller ändra fakturering, plånbok eller abonnemang | |
| Radera något |
Detta är avsiktligt och upprätthålls på två ställen – servern vägrar exponera de verktygen, och backend avvisar de underliggande förfrågningarna även om något begär dem. Anledningen är connector-länken som beskrivs nedan: länken är i sig en inloggningsuppgift, så det värsta en läckt länk kan göra är att läsa dina Finns och redigera dina utkast. Det går att reparera. ”Ring mina kunder och använd mitt saldo” gör det inte.
Vad det innebär för dig: Claude bygger den, du lanserar den. Varje Finn kommer som ett utkast, du granskar det i dashboarden och du trycker på knappen.
Steg 1 – Generera en nyckel
I dashboarden: Settings → Integrations → AI Assistants (MCP) → Generate key.
Namnet du ger nyckeln är det namn som connectorn visas med i Claude, så döp den efter var du tänker använda den – ”jobbdator”, ”hemmadator”. Två nycklar blir då två poster som går att skilja åt i stället för två identiska rader.
Din nyckel ser ut som finn_mcp_ följt av en lång sträng. Den visas bara en gång. Kopiera det du behöver innan du stänger dialogrutan. Om du tappar bort den återkallar du nyckeln och genererar en ny.
Några saker som är bra att veta om nycklar:
- En nyckel bär din identitet. En Finn som skapas med din nyckel hamnar i din organisation, i ditt namn. Om du använder en kollegas nyckel visas Finn i deras konto och du kommer inte att hitta den.
- Det finns inga behörighetsnivåer eller omfång. Varje nyckel kan göra allt på listan ”Kan” ovan och inget på listan ”Kan inte”.
- Återkallandet gäller direkt. Servern kontrollerar nyckeln mot ditt konto vid varje anrop, så en återkallad nyckel slutar fungera vid nästa begäran – inte först när en session tar slut.
Steg 2 – Anslut Claude
Dialogrutan som visar din nya nyckel ger dig båda alternativen, vart och ett med en egen kopieringsknapp. Välj det som passar hur du använder Claude.
Alternativ 1 – Claude-appen (claude.ai eller Claude Desktop)
Det här är vad de flesta vill ha. Inget att installera och inget att redigera.
Kopiera din anslutningslänk från dialogrutan. Den ser ut så här, med din egen nyckel sist:
https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE
Gör sedan så här i Claude:
- Öppna Customize → Connectors, klicka på + och välj Add custom connector.
- Klistra in länken som URL för den fjärranslutna MCP-servern och klicka sedan på Add. Den visas under din nyckels namn.
- Öppna + → Connectors i en ny chatt, slå på Finn och be sedan Claude att skapa en Finn.
Två saker att veta om abonnemang: Free-abonnemanget tillåter en anpassad connector, och på Team- och Enterprise-abonnemang kan bara en Owner lägga till en, via Organization settings → Connectors – alla andra klickar sedan på Connect för den.
Nackdelen: en anpassad connector är ett enda URL-fält utan plats för ett lösenord, så länken är själva inloggningsuppgiften. Behandla hela URL:en som du skulle behandla ditt lösenord till dashboarden – klistra inte in den i en chatt, ett ärende, en skärmbild eller ett repo.
Alternativ 2 – Claude Code (terminal)
Kopiera kommandot från dialogrutan. Det är en enda rad, så det klistras in problemfritt i bash, zsh, PowerShell och cmd:
claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"
- Klistra in kommandot i en terminal och kör det.
- Kör
claude. - Be den att skapa en Finn.
I den här varianten ligger nyckeln i en header i stället för i URL:en, vilket är det säkrare alternativet.
Andra MCP-klienter
Servern använder streamable HTTP, inte stdio, och är tillståndslös – det finns ingen session att öppna eller som kan löpa ut. Alla klienter som stöder en HTTP MCP-endpoint fungerar med vilken som helst av de två vägarna ovan: nyckeln i en Authorization: Bearer-header mot /mcp, eller nyckeln som sista segmentet i sökvägen /mcp/<key>.
claude_desktop_config.json är inte ett av alternativen. Den filen konfigurerar lokala MCP-servrar. Finn-servern är fjärransluten och läggs därför till som en anpassad connector i stället.
Steg 3 – Kontrollera att det fungerar
Fråga Claude:
”Vilka Finns har jag?”
Om anslutningen fungerar svarar Claude med namnen på dina Finns. Om Claude säger att verktyget saknas, se Felsökning nedan.
Verktygen
Det finns sex verktyg, och Claude väljer själv mellan dem – du anger aldrig något verktyg direkt.
| Verktyg | Vad det gör | Skriver? |
|---|---|---|
list_finns | Dina Finns, nyaste först, med id, namn, status och användningsområde | Nej |
get_finn | En Finns fullständiga konfiguration | Nej |
list_orgs | Vilken organisation din nyckel tillhör och vilken roll du har | Nej |
list_voices | Röstkatalogen, filtrerbar efter leverantör och sökterm | Nej |
create_finn | Skapar en ny Finn som utkast | Ja – skapar ett utkast |
update_finn_draft | Redigerar ett utkasts namn, persona, användningsfall, språk, röst, inledande replik eller ordförråd | Ja – endast utkast |
Bygga en Finn i en konversation
Beskriv vad du vill ha med vanliga ord. Dialogrutan föreslår den här som utgångspunkt:
”Använd Finn-connectorn för att skapa ett Finn-utkast som heter Maya och bokar tider åt en tandvårdsklinik: vänlig, koncis, engelska.”
En mer utförlig begäran kan se ut så här:
”Skapa en Finn som heter Skylar och bokar 15 minuter långa demosamtal åt vårt säljteam. Varm och koncis, avbryter aldrig och bekräftar alltid datum och tid för den som ringer. Den ska bara prata om demos och bokningar – om någon frågar om priser ska den erbjuda sig att koppla vidare till en människa. Använd en vänlig kvinnlig engelsk röst.”
För det behöver Claude fyra uppgifter, och den frågar om du utelämnar någon:
| Fält | Vad det är |
|---|---|
| Namn | Vad Finn heter |
| Roll och identitet | Vem den är och vad den har för uppgift |
| Ton och stil | Hur den ska tala |
| Riktlinjer för svar | Vad den ska och inte ska göra |
Du kan också ange en etikett för användningsfall, ett språk, en röst, en inledande replik och en anpassad ordlista för namn som den annars skulle uttala fel.
Tillbaka får du en länk till det nya utkastet, dess id samt vilken organisation och vilket konto det hamnade i. Därefter:
- Öppna länken och granska utkastet i byggverktyget.
- Be Claude om ändringar – ”gör den inledande repliken kortare”, ”lägg till en gren för röstbrevlåda” – så redigeras utkastet direkt.
- När du är nöjd kopplar du ett nummer till den och lanserar den i dashboarden. Se Deployments.
En dashboard-flik som redan var öppen visar inte den nya Finn förrän du laddar om den.
Röster
Be om en röst genom att beskriva den – ”en lugn manlig engelsk röst” – så söker Claude i katalogen åt dig.
Var uppmärksam på en sak: nya Finns skapas på Cartesia, och ett röst-id från en annan leverantör sparas utan felmeddelande men misslyckas sedan vid ett riktigt samtal. Om du ber om en viss leverantör, se till att det är den som din Finn faktiskt använder. I Voice Gallery finns hela katalogen.
Säkerhet
Connector-länken är ett lösenord. Vid konfigurationen med en enda länk ligger nyckeln i URL:en, så alla som ser URL:en får din åtkomst. Ta inte skärmbilder av den, klistra inte in den i en delad chatt och checka inte in den.
Utgå från att allt du klistrar in är exponerat. Om en nyckel har funnits i ett chattfönster, ett ärende eller ett e-postmeddelande ska du återkalla den och generera en ny. Det kostar ingenting.
Återkalla under Settings → Integrations → AI Assistants → Revoke. Det börjar gälla vid nästa förfrågan. Finns som redan har skapats påverkas inte – att återkalla en nyckel raderar inget som skapats med den.
En nyckel per plats. Med separata nycklar för din bärbara dator, din stationära dator och varje kollega kan du återkalla en utan att påverka de andra, och av connectorns namn framgår vilken som är vilken.
Kontrollera vems konto du är i. Om du tillhör mer än en organisation bör du fråga Claude ”vilken Finn-organisation är jag i?” innan du skapar något. Nya Finns hamnar i den organisation du senast gick med i.
Felsökning
”Claude har inga Finn-verktyg”
- I Claude-appen öppnar du + → Connectors i chatten och kontrollerar att Finn är påslaget. Connectors aktiveras per konversation.
- Starta om Claude Code, eftersom MCP-konfigurationen läses in vid start.
- Om du har en Free-plan bör du kontrollera att du inte redan har använt din enda plats för en anpassad connector till något annat.
”Den här connector-länken är inte giltig”
Nyckeln i URL:en är felaktigt formaterad. Hela nyckeln måste finnas med, med början finn_mcp_, utan att något har klippts bort i slutet och utan avslutande snedstreck eller mellanslag.
”Den här connector-länken har återkallats”
Nyckeln finns inte längre. Generera en ny och uppdatera connectorn.
”Det gick inte att nå Finns backend för att verifiera din nyckel”
Det här är ett tillfälligt problem hos oss, inte ett fel i din konfiguration. Försök igen. Kontakta supporten om problemet kvarstår.
Claude skapade en Finn men du hittar den inte
Nästan alltid beror det på fel konto. Fråga Claude ”i vilken organisation skapades den?” – svaret anger organisationen och den e-postadress som nyckeln tillhör. Om den inte är din använder du någon annans nyckel.
Claude säger att den inte kan redigera en Finn
Den har redan lanserats. Servern kan bara redigera utkast, och en live-Finn redigeras i dashboarden.
Nästa steg
- Skapa en Finn → – dashboardens byggverktyg och vad varje personafält gör.
- Driftsättningar → – koppla ett nummer och gå live med ett utkast.
- Röstgalleri → – hela röstkatalogen.
- Integrationer → – webhooks och resten av integrationsmöjligheterna.
Was this page helpful?
Still stuck or have feedback?
Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.