Claude MCP

Model Context Protocol (MCP) är en öppen standard som låter AI-assistenter som Claude säkert komma åt externa verktyg och datakällor. Finn tillhandahåller en MCP-server, så du kan koppla in Finn i Claude (eller vilken MCP-kompatibel klient som helst) och låta din AI-assistent söka i, konfigurera och styra plattformen konversationellt.

Vem detta är för. Detta är för avancerade användare — utvecklare, automationsingenjörer och AI-vana operatörer som vill styra Finn från Claude Desktop, Claude Code eller någon annan MCP-klient. Om du inte är bekant med Claude eller MCP behöver du inte detta — dashboarden gör allt som MCP:n exponerar.

Status: Finn:s MCP-server är i publik beta. API:erna är stabila, men fler verktyg läggs till löpande.

Vad du kan göra med MCP:n

När anslutningen är klar kan din Claude (eller annan MCP-kompatibel AI) göra allt följande åt dig:

Läsoperationer

• Hämta status för valfri distribution.
• Lista dina Finns, målgrupper och telefonnummer.
• Hämta samtalstranskript och analyser för valfri tidsperiod.
• Sök i samtalshistoriken efter specifika mönster ("visa mig samtal där den som ringde nämnde 'återbetalning'").
• Läs distributionskostnader, planförbrukning och faktureringssammanfattningar.

Skrivoperationer

• Starta en ny distribution.
• Pausa eller stoppa en aktiv distribution.
• Lägg till kontakter i en målgrupp.
• Uppdatera fält för analys efter samtal på en Finn.
• Spärra nummer (lägg till i spärrlistan).

Samordning

• Generera vecko- och månadsrapporter automatiskt.
• Korsreferera samtalsutfall mot ditt CRM för att upptäcka luckor i attributionen.
• Skapa automatiskt en ny distribution när en CRM-lista når en viss storlek.
• Sammanfatta en distribution på vanlig svenska, lämplig att dela med en icke-teknisk intressent.

Konfigurera MCP-servern

Steg 1 — Generera en MCP-token

Inställningar → Integrationer → MCP → Generera token.

Kopiera token direkt — du ser den bara en gång. Spara den i din lösenordshanterare eller ditt hemlighetsvalv.

Tokens omfattning är konfigurerbar:

• Endast läsning — hämta data men inte ändra
• Läsning + skrivning — full operativ åtkomst (var försiktig)
• Begränsad till specifika Finns/målgrupper — begränsa åtkomsten till en delmängd

För de flesta användare är det bäst att börja med Endast läsning och utöka senare.

Steg 2 — Konfigurera din MCP-klient

Claude Desktop (Mac, Windows):

Redigera din konfigurationsfil för Claude Desktop:

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

Lägg till Finn-servern:

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

Starta om Claude Desktop. Finn-verktygen blir tillgängliga i alla konversationer.

Claude Code (CLI):

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

Sedan claude från valfri katalog – Finn-verktygen är tillgängliga.

Andra MCP-klienter (Continue, Cursor, egna):

Använd samma npx-kommando i klientens MCP-serverkonfiguration. Servern använder standard-MCP över stdio.

Steg 3 – Testa anslutningen

Fråga i Claude (valfri klient):

”Vilka Finns har jag konfigurerade?”

Om anslutningen fungerar anropar Claude verktyget list_finns och svarar med ett verkligt svar.

Verktyg som MCP exponerar

Servern tillhandahåller cirka 30 verktyg. Höjdpunkter:

Hantera Finns

• list_finns – lista alla Finns i kontot.
• get_finn – hämta en Finns fullständiga konfiguration.
• create_finn – skapa en ny Finn (avancerat).
• update_finn – ändra inställningar för en Finn.

Hantera målgrupper

• list_audiences – lista alla målgrupper.
• get_audience_stats – antal, valideringsstatus, senaste importer.
• add_contacts – lägg till kontakter i grupp.
• remove_contact – ta bort en enskild kontakt.

Distributionens livscykel

• list_deployments – lista tidigare och aktiva distributioner.
• launch_deployment – starta en ny.
• pause_deployment / resume_deployment / stop_deployment.
• get_deployment_status – livestatus med aktuellt antal samtal.

Analys

• get_deployment_analytics – fullständiga mätvärden för en distribution.
• search_calls – hitta samtal som matchar innehållsmönster.
• get_call – hämta ett enskilt samtals transkript och analys.
• aggregate_calls – egna sammanställningar per valfritt fält över valfri tidsperiod.

Efterlevnad

• add_to_suppression_list – blockera ett nummer globalt.
• remove_from_suppression_list – ta bort blockering.
• check_suppression – finns numret på listan?

Fakturering

• get_usage_this_month – löpande kostnad.
• forecast_month_end – prognos baserad på utvecklingen.
• set_spend_cap – justera tak.

Fullständigt schema för varje verktyg: api.hirefinn.ai/academy/mcp.

Saker du kan be Claude göra

Riktiga prompter som fungerar:

"Visa gårdagens deployment-resultat och berätta vilken Finn som presterade bäst."

"Hitta alla samtal från senaste veckan där den som ringde sa 'för dyrt' och sammanfatta det gemensamma sammanhanget."

"Starta samma deployment som förra måndagen, men mot den nya målgruppen jag laddade upp i morse."

"Hur mycket spenderade vi förra veckan, och ligger det i linje med vår budget?"

"Lägg till dessa telefonnummer i spärrlistan: [klistra in lista]"

"Vad är skillnaden i lyckandegrad mellan våra förmiddagssamtal och eftermiddagssamtal?"

"Skapa en sammanfattning på en sida av förra månadens kampanj för påminnelser om bokade tider, till klinikchefen."

MCP gör Finn konversationsdrivet. Åtgärder som skulle kräva 5–10 klick i dashboarden blir en enda fråga på naturligt språk.

Säkerhetsaspekter

Vad token kan göra

Tokenens scopes avgör vad som är tillåtet:

• Skrivskyddad token → kan läsa allt men ändra ingenting.
• Läs + skriv → full operativ åtkomst. Behandla den som ditt lösenord till dashboarden.
• Avgränsade tokens → begränsa per Finn-ID, målgrupps-ID eller åtgärdstyp.

Rekommenderad praxis

• Klistra inte in tokens i chattmeddelanden. Använd miljövariabler i konfigurationen för din MCP-klient.
• Rotera tokens regelbundet. Inställningar → Integrationer → MCP → Rotera.
• Använd avgränsade tokens för teammedlemmar. Ge inte en konsult en token med full åtkomst.
• Granskningslogg. Varje MCP-anrop loggas. Inställningar → Integrationer → MCP → Aktivitetslogg.
• Återkalla tokens omedelbart vid läcka. Inställningar → Integrationer → MCP → Återkalla.

Vad Claude inte kan göra

MCP exponerar inte:

• Skapa/ta bort konto
• Ändring av betalningsmetod
• Uppgradering/nedgradering av plan
• Inbjudan av teammedlemmar
• SSO-konfiguration

Detta kräver åtkomst till dashboarden. Avsiktligt — det är beslut som en människa bör fatta.

Godkänna känsliga åtgärder

Som standard kräver MCP uttryckligt godkännande från en människa (via behörighetssystemet i din MCP-klient) för alla skriv-åtgärder:

• Starta deployments
• Lägga till/ta bort kontakter
• Ändra Finn-konfigurationer
• Spendera pengar

Detta upprätthålls på protokollnivå — Claude kan inte utföra en skrivning utan att du bekräftar i klientens gränssnitt. Läsåtgärder kräver inget godkännande.

Du kan inaktivera detta per verktyg under Inställningar → Integrationer → MCP → Lista för automatiskt godkännande om du vill att vissa verktyg ska köras utan förfrågningar. Använd sparsamt — att automatiskt godkänna "launch_deployment" är ett effektivt sätt att spendera mycket pengar snabbt.

Vanliga mönster

Daglig standup

Konfigurera Claude att hämta gårdagens mätvärden varje morgon:

"Sammanfatta gårdagens distributionsresultat varje vardag kl. 09.00, lyft fram eventuella avvikelser och publicera i min Slack."

(Kräver Claude Code med schemalagda uppgifter, eller egen cron + MCP-wrapper.)

Avvikelsedetektering

"Kontrollera om någon distribution under de senaste 24 timmarna hade en framgångsgrad under 50 % eller en kostnad mer än 2 gånger sitt 7-dagarsgenomsnitt. Flagga dem med detaljer."

Massgranskning

"Lista alla Finn som inte har fält för analys efter samtal definierade. Föreslå rimliga standardvärden för var och en utifrån Finns identitetsbeskrivning."

Snabba exporter

"Hämta alla samtal från distribution X där qualified=true, exportera som CSV och mejla till mig."

Felsökning

"Claude hittar inte Finn-verktygen"

• Starta om Claude Desktop efter att du har redigerat konfigurationen.
• Kontrollera att konfigurations-JSON är giltig (kommatecken, citattecken).
• Kör npx -y @finnai/mcp-server --test i terminalen för att verifiera att servern startar.

"Autentisering misslyckades"

• Token har upphört att gälla eller återkallats. Generera en ny.
• Token-miljövariabeln skickas inte vidare (konfigurationsfel).

"Verktygsanropet tog för lång tid"

• Stora frågor (t.ex. sökning i samtalshistorik) kan ta 30+ sekunder.
• Standardtidsgränsen i de flesta klienter är 30 s. Öka vid behov.

"Åtkomst nekad för verktyg X"

• Din tokens omfattning inkluderar inte detta verktyg.
• Generera en ny token med bredare omfattning, eller använd instrumentpanelen för den åtgärden.

Vad som kommer

MCP-färdplanen (i skrivande stund):

• Arbetsflödesverktyg — skapa och redigera visuella arbetsflöden via Claude.
• Test-on-Call-verktyg — starta testsamtal från Claude.
• Strömmande prenumerationer — realtidsströmmar av händelser för live-distributioner.
• Stöd för flera konton — hantera flera Finn-konton från en enda Claude-session.
• Uppspelning av inspelningar — strömma samtalsljud till Claude för direkt lyssning (Enterprise).

Föreslå verktyg du vill ha på [email protected].

Bortom Claude

Även om den här sidan fokuserar på Claude är MCP-servern leverantörsoberoende. Den fungerar med:

• Continue.dev (AI-tillägg för VS Code)
• Cursor (AI-först IDE)
• OpenAI ChatGPT Desktop (när MCP-stöd lanseras)
• Egna MCP-klienter byggda på den öppna specifikationen

Alla klienter som talar MCP kan använda Finn via samma server.

Nästa

• Integrationer → REST API — det underliggande API:et som MCP:n omsluter.
• Integrationer → Webhooks — pushnotiser för händelsestyrda arbetsflöden.
• Kapacitet och skala → — hastighetsgränser som gäller för MCP-anrop.