Forbind SMOC med MCP til Claude eller en anden AI-baseret klient

Enkel guide, der viser, hvordan du forbinder SMOC til AI-klienter og udviklingsværktøjer ved hjælp af MCP (Model Context Protocol). Når forbindelsen er oprettet, kan værktøjer som Claude Desktop, Claude Code, Cursor eller VS Code læse dine SMOC-data direkte — kontakter, virksomheder, virksomhedsaktiver, flowcharts, flowanalyse, LinkedIn-indbakke-tråde og beskedflow-samtaler — afgrænset til din virksomhed. HTTP-kaldere bør bruge REST v2 API reference.

Hent din API-nøgle

SMOC MCP-integrationen godkendes med en privat API-nøgle. Generér en i SMOC Console:

1. Gå til Indstillinger → Integrationer → MCP.
2. Giv eventuelt nøglen et navn og en udløbsdato (7, 30 eller 90 dage). Lad udløb stå på Ingen udløb, hvis du ikke ønsker, at den skal udløbe.
3. Generér nøglen og kopier den straks — den vises kun én gang, så opbevar den et sikkert sted.

Din nøgle er knyttet til din virksomhed. Hver anmodning, der foretages med den, er automatisk afgrænset til dine data — du vil kun kunne se kontakter, virksomheder, analyser, indbakke-tråde og samtaler, der tilhører dig. At generere en ny nøgle fjerner ikke eksisterende nøgler. Udstedte nøgler vises på samme side — tilbagekald ubrugte nøgler der.

API- og Zapier-siderne bruger samme navn, udløb, engangs-kopieringsbanner og liste over udstedte nøgler.

Hvad du kan tilgå

Når du har forbundet, bliver følgende værktøjer tilgængelige (præcis tilgængelighed afhænger af din kontos rettigheder og serverens konfiguration). Nøgler er som standard kun til læsning. Marker Tillad begrænsede skrivninger ved oprettelse af en nøgle for at aktivere de nedenfor nævnte skrivemuligheder.

Discovery

• whoami — nuværende rolle, virksomhedsafgrænsning og rettigheder
• mcp_capabilities — synlige værktøjer, superevner og alt, der aktuelt er utilgængeligt
• skills_search — find en opskrift ud fra en kort opgavebeskrivelse
• skills_get — præcise input og et eksempel for én superevne

Virksomheder & aktiver

• companies_get — virksomhedsprofil (titel, nøgle, URL, sprog, indstillinger)
• company_assets_get — produkter, positionering, webstedslinks og filer
• company_asset_extraction_results_list — ekstraktionsresultat-resuméer
• company_asset_extraction_results_get — ét ekstraktionsresultat, evt. med udtrukne data
• company_asset_extraction_templates_list — skabeloner, tags og friskhed

Superbruger-nøgler kan også kalde companies_list for at gennemse alle virksomheder før valg af en companyId.

Kontakter

• contacts_search — søgning med filtre, sortering og pagination
• contacts_get — én anonymiseret kontakt via id
• contacts_get_stats — tællinger og engagement-resumé
• contacts_get_filter_options — gyldige filterværdier (lokation, flow, enhed og lignende)
• contact_tags_list — kontakt-tags
• prospect_lists_list / prospect_lists_get — prospektlister

Indbakke & samtaler

• inbox_threads_list — LinkedIn (og andre) indbakke-tråde, med ulæste / ubesvarede / afsender / flow-filtre
• inbox_threads_get — én tråd; sæt includeMessages: true for at inkludere seneste beskeder
• inbox_messages_list — beskedhistorik for en tråd, inkl. sammenlagte peer-tråde
• conversations_list — beskedflow-kørsler (tilmelding, status, nuværende node)
• conversations_get — én samtalekørsel, inkl. milepæle

Indbakkeværktøjer kræver inbox:read-rettighed. De kan læse beskedindhold. Skrivemulige nøgler kan også arkivere, markere som ulæst/håndteret og sende et kun tekst-svar med inbox_threads_send (kræver threadId, body og idempotencyKey). De kan ikke vedhæfte filer, redigere flow-grafer, udgive flows eller starte LinkedIn-outreach-kampagner. Superbruger-nøgler kan gemme Mongo-flow- og temaudkast (flowcharts_save, flowcharts_create, themes_save og relaterede kald), inkl. web-/besked- og chat-/kortflow-typer. Disse skrivninger udgiver ikke.

Flowcharts

• flowcharts_list — statiske flowcharts for virksomheden
• flowcharts_get — ét flowchart-resumé eller fuld graf
• flowchart_recommendations_list — anbefalingsdokumenter for et flowchart
• flowcharts_versions_list, themes_get, studio_generation_categories_list, målretningsporteføljer og læsning af genererings-/oversættelsesjobs
• Superbruger-udkast-skrivninger: flowcharts_save, flowcharts_restore_version, flowcharts_create (flowType web eller besked, webFormat chat eller kort), flowcharts_duplicate, themes_save. Disse skriver Mongo-udkast og udgiver ikke.
• CPCS-læsninger: cpcs_overview, URL'er, crawls, ekstraktioner, skabeloner, tidsplan

Flowanalyse

• analytics_flow_list_flows — flows rangeret efter trafik
• analytics_flow_kpis — totaler, konvertering, ændringer fra forrige periode
• analytics_flow_timeseries — daglige eller månedlige tendenser
• analytics_flow_dimension_metrics — opdelinger efter enhed, land, sprog, UTM eller ugedag
• analytics_flow_filter_values — gyldige analysefilterværdier

Kundernøgler er altid begrænset til din egen virksomhed. Superbruger-nøgler kan sende companyId på afgrænsede værktøjer.

---

Forbind i Claude (web og desktop)

Tilføj SMOC som en brugerdefineret connector. Dette virker på claude.ai og i Claude desktop-appen. Du kan logge ind med din SMOC-konto eller forbinde med en API-nøgle.

Kom hurtigt i gang

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

Log ind

1. I Claude, åbn Tilpas, derefter + Tilføj.
2. Navngiv connectoren SMOC og indsæt MCP-endpointet. Lad login være aktiveret. Vælg ikke Ingen login og tilføj ikke en request header.
3. Når Claude beder dig om at forbinde, skal du logge ind med en virksomhedsadmin-konto.
4. I en chat, åbn +, vælg Connectors, og slå SMOC til. Bed Claude om at køre whoami.

Login er kun for virksomhedsadmins. Det kan læse den pågældende virksomheds data. Medlemmer og andre roller afvises. Det aktiverer ikke de begrænsede skrivemuligheder, du vælger ved oprettelse af en API-nøgle. Hvis du administrerer mere end én virksomhed, skal du bruge en API-nøgle for den virksomhed, du ønsker.

På Team og Enterprise tilføjer en ejer connectoren under Organisationsindstillinger → Connectors → + Tilføj → Brugerdefineret. Medlemmer slår den derefter til under Tilpas.

Eller tilføj en API-nøgle

1. Generér en API-nøgle under Indstillinger → Integrationer → MCP og kopier den.
2. I Claude, åbn Tilpas, derefter + Tilføj.
3. Navngiv connectoren SMOC og indsæt MCP-endpointet.
4. Vælg Ingen login. Under Request headers, vælg authorization og sæt værdien til Bearer YOUR_SMOC_API_KEY — inkluder ordet Bearer og mellemrum. Marker headeren som Required, og tilføj derefter connectoren.

Brug en nøgle, når du ønsker én virksomhed, en udløbsdato eller begrænsede skrivemuligheder. Request headers rulles ud. Hvis + Tilføj ikke har et Request headers-afsnit, brug Claude Code eller desktop-konfigurationsfilen nedenfor.

Forbind i ChatGPT

ChatGPT tilføjer SMOC som en app. Oprettelsesskærmen bruger login og har ikke felt til API-nøgle. Log ind med en virksomhedsadmin-konto.

Kom hurtigt i gang

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

1. Åbn Indstillinger → Apps → Avancerede indstillinger og slå Udviklertilstand til. På Business, Enterprise eller Edu slår en workspace-admin det først til under Workspace-indstillinger → Rettigheder & Roller.
2. Åbn Apps → Opret. Navngiv appen SMOC og indsæt MCP-endpointet.
3. Vælg OAuth, derefter Scan værktøjer. Log ind med en virksomhedsadmin-konto, når ChatGPT beder om det, og klik derefter på Opret.
4. I en chat, åbn værktøjsmenuen og slå SMOC til. Bed ChatGPT om at køre whoami.

Login er kun for virksomhedsadmins. Det kan læse den pågældende virksomheds data. Medlemmer afvises. API-nøgler er til Claude, Cursor og VS Code. ChatGPT kræver et Plus-, Pro-, Business-, Enterprise- eller Edu-abonnement for brugerdefinerede apps.

Forbind til Claude Desktop med en konfigurationsfil

Brug dette, når connector-dialogen ikke kan tage en API-nøgle. SMOC forbinder så via en lille lokal bro (mcp-remote).

1. Åbn Claude Desktop → Indstillinger → Udvikler → Rediger konfiguration. Dette åbner claude_desktop_config.json.
2. Tilføj SMOC under mcpServers:

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

3. Erstat YOUR_SMOC_API_KEY med den nøgle, du har genereret.
4. Gem filen og genstart Claude Desktop.

SMOC vil nu fremgå på din værktøjsliste. Kræver Node.js installeret (til npx).

---

Forbind til Claude Code

Claude Code kan tale direkte med SMOC-endpointet via en authentication header — 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å tilføje det som JSON:

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

Bekræft forbindelsen ved at køre /mcp i en Claude Code-session — SMOC bør vises som forbundet med sine værktøjer listet.

---

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

De fleste MCP-kompatible editorer bruger en JSON-konfigurationsfil (ofte mcp.json). Tilføj en HTTP-server-post, der peger på SMOC-endpointet med din nøgle i Authorization-headeren:

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

Se din editors MCP-dokumentation for præcis filplacering. Efter gemning, genstart eller genindlæs editoren.

---

Bekræft forbindelsen

• Health check: endpointet eksponerer GET https://api.smoc.ai/mcp/health.
• Identitetstjek: bed AI'en om at køre whoami-værktøjet — det returnerer, hvem du er forbundet som, og din virksomhedsafgrænsning. Dette er den hurtigste måde at bekræfte, at nøglen virker.

Opdag værktøjer

AI'en behøver ikke kende SMOC's værktøjsnavne på forhånd. Det tilsigtede flow er:

1. mcp_capabilities — lister tilgængelige værktøjer, din rolle og dit scope.
2. skills_search — beskriv opgaven med en kort sætning for at finde det rigtige værktøj.
3. skills_get — returnerer præcise input og et eksempel for det valgte værktøj.
4. Kald værktøjet.

I praksis kan du bare spørge på almindeligt dansk (fx "søg mine SMOC-kontakter i Oslo" eller "vis ubesvarede LinkedIn-indbakke-tråde"), og klienten vælger det rigtige værktøj.

Sikkerhedsnoter

• Din API-nøgle vises kun én gang ved oprettelse — opbevar den i en password manager eller miljøvariabel.
• Del aldrig nøglen i et Git-repository eller i en delt/offentlig konfiguration.
• At generere en ny nøgle fjerner ikke eksisterende nøgler. Tilbagekald ubrugte nøgler fra listen over udstedte nøgler under Indstillinger → Integrationer → MCP.
• Kundernøgler er som standard kun til læsning og begrænset til din virksomheds data. Skrivemulige nøgler kan opdatere kontakter, tags, lister, virksomhedsprofil, tilføje CPCS-URL'er, triagere indbakke og sende tekstsvar i indbakken. De kan ikke slette data, udgive flows, slå live til/fra eller starte LinkedIn-outreach-kampagner.
• Indbakke- og samtaleværktøjer kræver inbox:read på nøglen. Nye nøgler fra Indstillinger → Integrationer → MCP inkluderer det; ældre nøgler kræver rotation.

Fejlfinding

• Værktøjer mangler på listen: AI'en kan køre mcp_capabilities og tjekke unavailableTools — den navngiver den præcise manglende rettighed, din nøgle mangler.
• Godkendelse fejler: bekræft, at nøglen er korrekt, ikke er tilbagekaldt, og at headeren præcis er Authorization: Bearer <key>.
• Claudes + Tilføj-dialog har ikke Request headers: brug Claude Code-kommandoen eller mcp-remote-konfigurationen ovenfor. Sørg for, at Node.js er installeret, at konfigurations-JSON er gyldig, og at du har genstartet Claude Desktop helt efter redigering af konfigurationen.

Se også

• REST v2 API reference — alle POST /api/v2/{toolName}-kald
• Forbind SMOC med REST API
• Offentlig Kontakter API
• MCP til Claude, Cursor og VS Code