Anslut SMOC med MCP till Claude eller någon annan AI-baserad klient

Enkel guide som visar hur du kopplar SMOC till AI-klienter och utvecklingsverktyg med MCP (Model Context Protocol). När du är ansluten kan verktyg som Claude Desktop, Claude Code, Cursor eller VS Code läsa din SMOC-data direkt — kontakter, företag, företagsresurser, flödesscheman, flödesanalys, LinkedIn-inkorgstrådar och meddelandeflödeskonversationer — avgränsat till ditt företag. HTTP-anropare ska använda REST v2 API-referensen.

Hämta din API-nyckel

SMOC MCP-integrationen autentiserar med en privat API-nyckel. Skapa en i SMOC Console:

1. Gå till Inställningar → Integrationer → MCP.
2. Ge nyckeln ett namn och ett utgångsdatum (7, 30 eller 90 dagar) om du vill. Lämna utgångsdatum på Ingen utgång om du inte vill att den ska gå ut.
3. Skapa nyckeln och kopiera den direkt — den visas bara en gång, så spara den på ett säkert ställe.

Din nyckel är kopplad till ditt företag. Varje begäran som görs med den är automatiskt avgränsad till din data — du ser bara kontakter, företag, analys, inkorgstrådar och konversationer som tillhör dig. Att skapa en ny nyckel återkallar inte befintliga nycklar. Utfärdade nycklar listas på samma sida — återkalla oanvända nycklar där.

API- och Zapier-sidorna använder samma namn, utgångsdatum, engångskopieringsbanner och lista över utfärdade nycklar.

Vad du kan komma åt

Efter anslutning blir följande verktyg tillgängliga (exakt tillgänglighet beror på ditt kontos behörigheter och serverns konfiguration). Nycklar är skrivskyddade som standard. Markera Tillåt begränsade skrivningar när du skapar en nyckel för att aktivera skrivningarna nedan.

Upptäckt

• whoami — aktuell roll, företagsomfång och behörigheter
• mcp_capabilities — synliga verktyg, färdigheter och allt som för närvarande är otillgängligt
• skills_search — hitta ett recept från en kort uppgiftsfras
• skills_get — exakta indata och ett exempel för en färdighet

Företag & resurser

• companies_get — företagsprofil (titel, nyckel, URL, språk, inställningar)
• company_assets_get — produkter, positionering, webbplatslänkar och filer
• company_asset_extraction_results_list — sammanfattningar av extraktionsresultat
• company_asset_extraction_results_get — ett extraktionsresultat, valfritt med extraherad data
• company_asset_extraction_templates_list — mallar, taggar och färskhet

Superanvändarnycklar kan även anropa companies_list för att bläddra bland alla företag innan ett companyId väljs.

Kontakter

• contacts_search — sök med filter, sortering och paginering
• contacts_get — en sanerad kontakt via id
• contacts_get_stats — antal och engagemangssammanfattning
• contacts_get_filter_options — giltiga filtervärden (plats, flöde, enhet och liknande)
• contact_tags_list — kontakttaggar
• prospect_lists_list / prospect_lists_get — prospektlistor

Inkorg & konversationer

• inbox_threads_list — LinkedIn (och andra) inkorgstrådar, med olästa / obesvarade / avsändare / flödesfilter
• inbox_threads_get — en tråd; ange includeMessages: true för att inkludera senaste meddelanden
• inbox_messages_list — meddelandehistorik för en tråd, inklusive sammanslagna parallella trådar
• conversations_list — meddelandeflödeskörningar (registrering, status, aktuell nod)
• conversations_get — en konversationskörning, inklusive milstolpar

Inkorgsverktyg kräver behörigheten inbox:read. De kan läsa meddelandetexter. Skrivaktiverade nycklar kan även arkivera, markera som oläst/hanterad och skicka ett endast text-svar med inbox_threads_send (kräver threadId, body och idempotencyKey). De kan inte bifoga filer, redigera flödesscheman, publicera flöden eller starta LinkedIn-outreachkampanjer. Superanvändarnycklar kan spara Mongo-flödes- och temautkast (flowcharts_save, flowcharts_create, themes_save och relaterade anrop), inklusive webb-/meddelande- och chatt-/korttyper. Dessa skrivningar publicerar inte.

Flödesscheman

• flowcharts_list — statiska flödesscheman för företaget
• flowcharts_get — en flödesschemasammanfattning eller fullständig graf
• flowchart_recommendations_list — rekommendationsdokument för ett flödesschema
• flowcharts_versions_list, themes_get, studio_generation_categories_list, inriktningsportföljer och läsning av genererings-/översättningsjobb
• Superanvändarutkast: flowcharts_save, flowcharts_restore_version, flowcharts_create (flowType webb eller meddelande, webFormat chatt eller kort), flowcharts_duplicate, themes_save. Dessa skriver Mongo-utkast och publicerar inte.
• CPCS-läsningar: cpcs_overview, URL:er, genomsökningar, extraktioner, mallar, schema

Flödesanalys

• analytics_flow_list_flows — flöden rankade efter trafik
• analytics_flow_kpis — totaler, konvertering, förändringar mot föregående period
• analytics_flow_timeseries — dagliga eller månatliga trender
• analytics_flow_dimension_metrics — uppdelningar per enhet, land, språk, UTM eller veckodag
• analytics_flow_filter_values — giltiga analysfiltervärden

Kundnycklar är alltid begränsade till ditt eget företag. Superanvändarnycklar kan skicka companyId på avgränsade verktyg.

---

Anslut i Claude (webb och desktop)

Lägg till SMOC som en anpassad connector. Detta fungerar på claude.ai och i Claude desktop-appen. Du kan logga in med ditt SMOC-konto eller ansluta med en API-nyckel.

Snabbstart

MCP-endpoint: https://api.smoc.ai/mcp

Logga in

1. I Claude, öppna Anpassa, sedan + Lägg till.
2. Namnge connectorn SMOC och klistra in MCP-endpointen. Lämna inloggning på. Välj inte Ingen inloggning och lägg inte till någon begärandeheader.
3. När Claude ber dig ansluta, logga in med ett företagsadministratörskonto.
4. I en chatt, öppna +, välj Connectors och slå på SMOC. Be Claude köra whoami.

Inloggning är endast för företagsadministratörer. Den kan läsa det företagets data. Medlemmar och andra roller nekas. Det aktiverar inte de begränsade skrivningar du väljer när du skapar en API-nyckel. Om du administrerar mer än ett företag, använd en API-nyckel för det företag du vill.

På Team och Enterprise lägger en Ägare till connectorn under Organisationsinställningar → Connectors → + Lägg till → Anpassad. Medlemmar slår sedan på den via Anpassa.

Eller lägg till en API-nyckel

1. Skapa en API-nyckel under Inställningar → Integrationer → MCP och kopiera den.
2. I Claude, öppna Anpassa, sedan + Lägg till.
3. Namnge connectorn SMOC och klistra in MCP-endpointen.
4. Välj Ingen inloggning. Under Begärandeheaders, välj authorization och ange värdet till Bearer YOUR_SMOC_API_KEY — inkludera ordet Bearer och mellanslaget. Markera headern som Obligatorisk, lägg sedan till connectorn.

Använd en nyckel när du vill ha ett företag, ett utgångsdatum eller begränsade skrivningar. Begärandeheaders rullas ut. Om + Lägg till inte har någon Begärandeheaders-sektion, använd Claude Code eller desktop-konfigurationsfilen nedan.

Anslut i ChatGPT

ChatGPT lägger till SMOC som en app. Skärmen för att skapa använder inloggning och har inget fält för API-nyckel. Logga in med ett företagsadministratörskonto.

Snabbstart

MCP-endpoint: https://api.smoc.ai/mcp

1. Öppna Inställningar → Appar → Avancerade inställningar och slå på Utvecklarläge. På Business, Enterprise eller Edu slår en arbetsyteadministratör på det under Arbetsyteinställningar → Behörigheter & Roller först.
2. Öppna Appar → Skapa. Namnge appen SMOC och klistra in MCP-endpointen.
3. Välj OAuth, sedan Skanna verktyg. Logga in med ett företagsadministratörskonto när ChatGPT ber om det, klicka sedan på Skapa.
4. I en chatt, öppna verktygsmenyn och slå på SMOC. Be ChatGPT köra whoami.

Inloggning är endast för företagsadministratörer. Den kan läsa det företagets data. Medlemmar nekas. API-nycklar är för Claude, Cursor och VS Code. ChatGPT kräver Plus-, Pro-, Business-, Enterprise- eller Edu-plan för anpassade appar.

Anslut till Claude Desktop med en konfigurationsfil

Använd detta när connector-dialogen inte kan ta en API-nyckel. SMOC ansluter då via en liten lokal brygga (mcp-remote).

1. Öppna Claude Desktop → Inställningar → Utvecklare → Redigera konfig. Detta öppnar claude_desktop_config.json.
2. Lägg till SMOC under mcpServers:

{
  "mcpServers": {
    "smoc": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.smoc.ai/mcp",
        "--header",
        "Authorization: Bearer YOUR_SMOC_API_KEY"
      ]
    }
  }
}

3. Ersätt YOUR_SMOC_API_KEY med nyckeln du skapade.
4. Spara filen och starta om Claude Desktop.

SMOC kommer nu att synas i din verktygslista. Kräver att Node.js är installerat (för npx).

---

Anslut till Claude Code

Claude Code kan prata direkt med SMOC-endpointen med en autentiseringsheader — ingen brygga behövs.

claude mcp add --transport http smoc https://api.smoc.ai/mcp \
  --header "Authorization: Bearer YOUR_SMOC_API_KEY"

På Claude Code 2.1.1 och senare kan du även lägga till det som JSON:

claude mcp add-json smoc \
  '{"type":"http","url":"https://api.smoc.ai/mcp","headers":{"Authorization":"Bearer YOUR_SMOC_API_KEY"}}'

Verifiera att det är anslutet genom att köra /mcp i en Claude Code-session — SMOC ska visas som ansluten med sina verktyg listade.

---

Anslut till andra klienter (Cursor, VS Code, Windsurf, etc.)

De flesta MCP-kompatibla editorer använder en JSON-konfigurationsfil (ofta mcp.json). Lägg till en HTTP-serverpost som pekar på SMOC-endpointen med din nyckel i Authorization-headern:

{
  "mcpServers": {
    "smoc": {
      "type": "http",
      "url": "https://api.smoc.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SMOC_API_KEY"
      }
    }
  }
}

Se din editors MCP-dokumentation för exakt filplacering. Efter att du sparat, starta om eller ladda om editorn.

---

Verifiera anslutningen

• Hälsokontroll: endpointen exponerar GET https://api.smoc.ai/mcp/health.
• Identitetskontroll: be AI:n köra verktyget whoami — det returnerar vem du är ansluten som och ditt företagsomfång. Detta är det snabbaste sättet att bekräfta att nyckeln fungerar.

Upptäcka verktyg

AI:n behöver inte känna till SMOC:s verktygsnamn i förväg. Det avsedda flödet är:

1. mcp_capabilities — listar tillgängliga verktyg, din roll och ditt omfång.
2. skills_search — beskriv uppgiften med en kort fras för att hitta rätt verktyg.
3. skills_get — returnerar exakta indata och ett exempel för valt verktyg.
4. Anropa verktyget.

I praktiken kan du bara fråga på vanligt språk (t.ex. "sök mina SMOC-kontakter i Oslo" eller "visa obesvarade LinkedIn-inkorgstrådar") och klienten väljer rätt verktyg.

Säkerhetsnoteringar

• Din API-nyckel visas en gång vid skapande — spara den i en lösenordshanterare eller miljövariabel.
• Lägg aldrig till nyckeln i ett Git-repo eller klistra in den i en delad/offentlig konfig.
• Att skapa en ny nyckel återkallar inte befintliga nycklar. Återkalla oanvända nycklar från listan över utfärdade nycklar under Inställningar → Integrationer → MCP.
• Kundnycklar är skrivskyddade som standard och begränsade till ditt företags data. Skrivaktiverade nycklar kan uppdatera kontakter, taggar, listor, företagsprofil, lägga till CPCS-URL:er, triagera inkorg och skicka textinkorgssvar. De kan inte ta bort data, publicera flöden, slå på live eller starta LinkedIn-outreachkampanjer.
• Inkorgs- och konversationsverktyg kräver inbox:read på nyckeln. Nya nycklar från Inställningar → Integrationer → MCP inkluderar det; äldre nycklar behöver rotation.

Felsökning

• Verktyg saknas i listan: AI:n kan köra mcp_capabilities och kontrollera unavailableTools — den anger exakt vilken behörighet din nyckel saknar.
• Autentisering misslyckas: kontrollera att nyckeln är korrekt, inte har återkallats och att headern är exakt Authorization: Bearer <key>.
• Claudes + Lägg till-dialog har ingen Begärandeheaders: använd Claude Code-kommandot eller mcp-remote-konfigen ovan. Kontrollera att Node.js är installerat, att konfig-JSON är giltig och att du startade om Claude Desktop helt efter att ha redigerat konfigen.

Se även

• REST v2 API-referens — varje POST /api/v2/{toolName}-anrop
• Koppla SMOC med REST API
• Publikt Kontakter-API
• MCP för Claude, Cursor och VS Code