Koble SMOC med MCP til Claude eller en annen AI-basert klient

Enkel guide som viser hvordan du kobler SMOC til AI-klienter og utviklingsverktøy ved hjelp av MCP (Model Context Protocol). Når du har koblet til, kan verktøy som Claude Desktop, Claude Code, Cursor eller VS Code lese SMOC-dataene dine direkte — kontakter, selskaper, selskapsressurser, flytskjemaer, flytanalyse, LinkedIn-innbokstråder og meldingsflyt-samtaler — avgrenset til ditt selskap. HTTP-klienter bør bruke REST v2 API-dokumentasjonen.

Hent din API-nøkkel

SMOC MCP-integrasjonen autentiserer med en privat API-nøkkel. Generer en i SMOC Console:

1. Gå til Innstillinger → Integrasjoner → MCP.
2. Gi eventuelt nøkkelen et navn og en utløpsdato (7, 30 eller 90 dager). La utløp stå på Ingen utløpsdato hvis du ikke vil at den skal utløpe.
3. Generer nøkkelen og kopier den umiddelbart — den vises kun én gang, så lagre den et sikkert sted.

Nøkkelen din er knyttet til ditt selskap. Hver forespørsel gjort med den er automatisk avgrenset til dine data — du vil kun se kontakter, selskaper, analyser, innbokstråder og samtaler som tilhører deg. Å generere en ny nøkkel opphever ikke eksisterende nøkler. Utstedte nøkler vises på samme side — opphev ubrukte nøkler der.

API- og Zapier-sidene bruker samme navn, utløp, engangskopieringsbanner og liste over utstedte nøkler.

Hva du får tilgang til

Etter tilkobling blir følgende verktøy tilgjengelige (nøyaktig tilgjengelighet avhenger av kontoens tillatelser og serverens konfigurerte bindinger). Nøkler er skrivebeskyttet som standard. Huk av for Tillat begrenset skriving når du lager en nøkkel for å aktivere skrivingene som er listet under.

Oppdagelse

• whoami — nåværende rolle, selskapsomfang og tillatelser
• mcp_capabilities — synlige verktøy, ferdigheter og alt som for øyeblikket er utilgjengelig
• skills_search — finn en oppskrift fra en kort oppgavebeskrivelse
• skills_get — eksakte inndata og et eksempel for én ferdighet

Selskaper og ressurser

• companies_get — selskapsprofil (tittel, nøkkel, URL, språk, innstillinger)
• company_assets_get — produkter, posisjonering, nettsidelenker og filer
• company_asset_extraction_results_list — sammendrag av ekstraksjonsresultater
• company_asset_extraction_results_get — ett ekstraksjonsresultat, eventuelt med uttrukne data
• company_asset_extraction_templates_list — maler, tagger og oppdateringsfrekvens

Superbruker-nøkler kan også kalle companies_list for å bla gjennom alle selskaper før de velger en companyId.

Kontakter

• contacts_search — søk med filtre, sortering og paginering
• contacts_get — én anonymisert kontakt per id
• contacts_get_stats — tellinger og engasjementsoppsummering
• contacts_get_filter_options — gyldige filterverdier (lokasjon, flyt, enhet og lignende)
• contact_tags_list — kontakt-tagger
• prospect_lists_list / prospect_lists_get — prospektlister

Innboks og samtaler

• inbox_threads_list — LinkedIn (og andre) innbokstråder, med uleste / ubesvarte / avsender / flyt-filtre
• inbox_threads_get — én tråd; sett includeMessages: true for å inkludere nylige meldinger
• inbox_messages_list — meldingshistorikk for en tråd, inkludert sammenslåtte tråder
• conversations_list — meldingsflyt-kjøringer (påmelding, status, nåværende node)
• conversations_get — én samtalekjøring, inkludert milepæler

Innboksverktøy krever inbox:read-tillatelsen. De kan lese meldingsinnhold. Skriveaktiverte nøkler kan også arkivere, merke som ulest/behandlet og sende et kun tekst-svar med inbox_threads_send (krever threadId, body og idempotencyKey). De kan ikke legge ved filer, redigere flytdiagrammer, publisere flyter eller starte LinkedIn-utsendelser. Superbruker-nøkler kan lagre Mongo-flyt- og temautkast (flowcharts_save, flowcharts_create, themes_save og relaterte kall), inkludert nett-/melding og chat-/korttyper. Disse skrivingene publiserer ikke.

Flytskjemaer

• flowcharts_list — statiske flytskjemaer for selskapet
• flowcharts_get — ett flytskjema-sammendrag eller fullstendig graf
• flowchart_recommendations_list — anbefalingsdokumenter for et flytskjema
• flowcharts_versions_list, themes_get, studio_generation_categories_list, målrettingsporteføljer og lesing av genererings-/oversettelsesjobber
• Superbruker-utkastskriving: flowcharts_save, flowcharts_restore_version, flowcharts_create (flowType nett eller melding, webFormat chat eller kort), flowcharts_duplicate, themes_save. Disse skriver Mongo-utkast og publiserer ikke.
• CPCS-lesing: cpcs_overview, URL-er, gjennomsøk, ekstraksjoner, maler, tidsplan

Flytanalyse

• analytics_flow_list_flows — flyter rangert etter trafikk
• analytics_flow_kpis — totaler, konvertering, endringer fra forrige periode
• analytics_flow_timeseries — daglige eller månedlige trender
• analytics_flow_dimension_metrics — oppdelinger etter enhet, land, språk, UTM eller ukedag
• analytics_flow_filter_values — gyldige analysefilterverdier

Kundenøkler er alltid begrenset til ditt eget selskap. Superbruker-nøkler kan sende companyId på avgrensede verktøy.

---

Koble til i Claude (web og desktop)

Legg til SMOC som en egendefinert kobling. Dette fungerer på claude.ai og i Claude desktop-appen. Du kan logge inn med din SMOC-konto, eller koble til med en API-nøkkel.

Kom i gang raskt

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

Logg inn

1. I Claude, åpne Tilpass, deretter + Legg til.
2. Gi koblingen navnet SMOC og lim inn MCP-endepunktet. La innlogging være på. Ikke velg Ingen innlogging og ikke legg til en forespørselsheader.
3. Når Claude ber deg koble til, logg inn med en administrator-konto for selskapet.
4. I en chat, åpne +, velg Koblinger, og slå på SMOC. Be Claude kjøre whoami.

Innlogging er kun for selskapsadministratorer. Den kan lese det selskapets data. Medlemmer og andre roller nektes. Det aktiverer ikke de begrensede skrivingene du velger når du lager en API-nøkkel. Hvis du administrerer mer enn ett selskap, bruk en API-nøkkel for det selskapet du ønsker.

På Team og Enterprise legger en Eier til koblingen under Organisasjonsinnstillinger → Koblinger → + Legg til → Egendefinert. Medlemmer slår den deretter på fra Tilpass.

Eller legg til en API-nøkkel

1. Generer en API-nøkkel under Innstillinger → Integrasjoner → MCP og kopier den.
2. I Claude, åpne Tilpass, deretter + Legg til.
3. Gi koblingen navnet SMOC og lim inn MCP-endepunktet.
4. Velg Ingen innlogging. Under Forespørselsheadere, velg authorization og sett verdien til Bearer YOUR_SMOC_API_KEY — inkluder ordet Bearer og mellomrommet. Merk headeren som Påkrevd, og legg deretter til koblingen.

Bruk en nøkkel når du ønsker ett selskap, en utløpsdato eller begrenset skriving. Forespørselsheadere rulles ut nå. Hvis + Legg til ikke har seksjonen for forespørselsheadere, bruk Claude Code eller desktop-konfigurasjonsfilen nedenfor.

Koble til i ChatGPT

ChatGPT legger til SMOC som en app. Opprettelsesskjermen bruker innlogging og har ikke felt for API-nøkkel. Logg inn med en administrator-konto for selskapet.

Kom i gang raskt

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

1. Åpne Innstillinger → Apper → Avanserte innstillinger og slå på Utviklermodus. På Business, Enterprise eller Edu slår en arbeidsområdeadministrator det på under Arbeidsområdeinnstillinger → Tillatelser og roller først.
2. Åpne Apper → Opprett. Gi appen navnet SMOC og lim inn MCP-endepunktet.
3. Velg OAuth, deretter Skann verktøy. Logg inn med en administrator-konto for selskapet når ChatGPT ber om det, og klikk deretter Opprett.
4. I en chat, åpne verktøymenyen og slå på SMOC. Be ChatGPT kjøre whoami.

Innlogging er kun for selskapsadministratorer. Den kan lese det selskapets data. Medlemmer nektes. API-nøkler er for Claude, Cursor og VS Code. ChatGPT krever Plus-, Pro-, Business-, Enterprise- eller Edu-abonnement for egendefinerte apper.

Koble til Claude Desktop med en konfigurasjonsfil

Bruk dette når koblingsdialogen ikke kan ta en API-nøkkel. SMOC kobles da via en liten lokal bro (mcp-remote).

1. Åpne Claude Desktop → Innstillinger → Utvikler → Rediger konfig. Dette åpner claude_desktop_config.json.
2. Legg til SMOC under mcpServers:

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

3. Bytt ut YOUR_SMOC_API_KEY med nøkkelen du genererte.
4. Lagre filen og start Claude Desktop på nytt.

SMOC vil nå vises i verktøyslisten din. Krever at Node.js er installert (for npx).

---

Koble til Claude Code

Claude Code kan snakke direkte med SMOC-endepunktet med en autentiseringsheader — ingen bro nødvendig.

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

På Claude Code 2.1.1 og nyere kan du også legge det til som JSON:

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

Bekreft at det er koblet til ved å kjøre /mcp inne i en Claude Code-økt — SMOC skal vises som tilkoblet med sine verktøy listet.

---

Koble til andre klienter (Cursor, VS Code, Windsurf, osv.)

De fleste MCP-kompatible editorer bruker en JSON-konfigurasjonsfil (ofte mcp.json). Legg til en HTTP-serveroppføring som peker til SMOC-endepunktet med nøkkelen din i Authorization-headeren:

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

Se editorens MCP-dokumentasjon for nøyaktig filplassering. Etter lagring, start eller last editoren på nytt.

---

Bekreft tilkoblingen

• Helsesjekk: endepunktet eksponerer GET https://api.smoc.ai/mcp/health.
• Identitetssjekk: be AI-en kjøre whoami-verktøyet — det returnerer hvem du er koblet som og ditt selskapsomfang. Dette er den raskeste måten å bekrefte at nøkkelen fungerer på.

Oppdage verktøy

AI-en trenger ikke å vite SMOCs verktøynavn på forhånd. Den tiltenkte flyten er:

1. mcp_capabilities — lister tilgjengelige verktøy, din rolle og ditt omfang.
2. skills_search — beskriv oppgaven med en kort frase for å finne riktig verktøy.
3. skills_get — returnerer eksakte inndata og et eksempel for valgt verktøy.
4. Kall verktøyet.

I praksis kan du bare spørre på vanlig språk (f.eks. "søk etter mine SMOC-kontakter i Oslo" eller "vis ubesvarte LinkedIn-innbokstråder") og klienten velger riktig verktøy.

Sikkerhetsnotater

• Din API-nøkkel vises kun én gang ved opprettelse — lagre den i en passordbehandler eller miljøvariabel.
• Aldri legg nøkkelen i et Git-repositorium eller lim den inn i en delt/offentlig konfigurasjon.
• Å generere en ny nøkkel opphever ikke eksisterende nøkler. Opphev ubrukte nøkler fra listen over utstedte nøkler under Innstillinger → Integrasjoner → MCP.
• Kundenøkler er skrivebeskyttet som standard og begrenset til ditt selskaps data. Skriveaktiverte nøkler kan oppdatere kontakter, tagger, lister, selskapsprofil, legge til CPCS-URL-er, triagere innboks og sende tekstsvar i innboks. De kan ikke slette data, publisere flyter, slå live av/på eller starte LinkedIn-utsendelser.
• Innboks- og samtaleverktøy trenger inbox:read på nøkkelen. Nye nøkler fra Innstillinger → Integrasjoner → MCP inkluderer det; eldre nøkler må roteres.

Feilsøking

• Verktøy mangler fra listen: AI-en kan kjøre mcp_capabilities og sjekke unavailableTools — den navngir nøyaktig hvilken tillatelse nøkkelen din mangler.
• Autentisering feiler: bekreft at nøkkelen er korrekt, ikke er opphevet, og at headeren er nøyaktig Authorization: Bearer <key>.
• Claudes + Legg til-dialog har ingen forespørselsheadere: bruk Claude Code-kommandoen eller mcp-remote-konfigen over. Sørg for at Node.js er installert, at konfig-JSON er gyldig, og at du har startet Claude Desktop helt på nytt etter redigering av konfigen.

Se også

• REST v2 API-dokumentasjon — alle POST /api/v2/{toolName}-kall
• Koble SMOC til REST API
• Offentlig Kontakter-API
• MCP for Claude, Cursor og VS Code