SMOC er nu en API: MCP, REST og skrivning som tilvalg

Skrevet af: Kristoffer Kvam
September 11, 2026

Et virksomheds-scopet invoke-lag driver nu to overflader: AI-klienter bruger MCP, pipelines bruger REST v2, og det gamle kontakt-endpoint forbliver. Standardnøgler er skrivebeskyttede. Marker Tillad begrænsede skriverettigheder, når du opretter en nøgle, og de samme værktøjer kan opdatere kontakter, lister og tags — og sende et tekstsvar i indbakken.

Hvad er lanceret

SMOC havde allerede en Streamable HTTP MCP-server på samme worker som det offentlige API. Hvert domæneværktøj kan kaldes på to måder:

MCP på https://api.smoc.ai/mcp til Claude, Cursor, VS Code og andre MCP-klienter
REST v2 på POST /api/v2/{toolName} med samme JSON-body

Politik, lejeforhold, rate limits, bekræftelse og idempotens køres én gang. Et skriv, der blokeres på MCP, blokeres også på REST.

GET /api/company/mongocontact er uændret. Zapier-nøgler forbliver skrivebeskyttede og beholder samme sti, token-header og responsformat.

Hvad du kan læse

Kundernøgler dækker virksomheden, ikke kun kontakter:

Kontakter, statistik, tags og prospect-lister
Virksomhedsprofil, aktiver og CPCS-crawl-status
Studio-katalog — versioner, temaer, målretningsporteføljer, genererings- og oversættelsesjobs
Flow-analyse
LinkedIn-indbakke-tråde og beskedflow-samtaler

Et kundetoken kan ikke vælge en anden virksomhed. Superbruger-nøgler kan stadig sende companyId, når det er nødvendigt.

Hvad nøgler med skriverettigheder kan gøre

Opret nøglen under Indstillinger → Integrationer → MCP eller API og marker Tillad begrænsede skriverettigheder. Eksisterende skrivebeskyttede nøgler får ikke skriverettigheder, før du opretter en ny med dette felt markeret.

Kontakter og lister

Opret eller opdater en kontakt
Opret eller omdøb et tag, tildel eller fjern det
Opret eller omdøb en prospect-liste, tilføj eller fjern en kontakt

Virksomhed og crawl

Opdater felter i virksomhedsprofilen
Opdater virksomhedsaktivers grunddata
Tilføj en CPCS-URL til crawl

Studio metadata

Omdøb et flowchart
Opdater status på en anbefaling (anvend / afvis — ikke publicer)

Indbakke

Arkiver en tråd, markér den som ulæst, eller markér ubesvarede som håndteret
Send et kun tekst-svar med inbox_threads_send

Send kræver threadId, body og idempotencyKey. Nøglen skal kunne indlæse tråden først; en manglende eller anden virksomheds tråd returnerer ikke fundet. Gentagelser med samme nøgle sender ikke dobbelt. Rate limit er 10 send pr. minut. Ingen vedhæftninger.

Hvad der stadig ikke er tilladt med kundernøgler

Skriveaktiveret betyder ikke fuld admin.

Kundernøgler kan stadig ikke:

Slette kontakter, tags, lister, virksomheder eller aktiver
Publicere et webforløb eller slå det live (flowcharts_set_active)
Oprette eller duplikere et flowchart
Ændre målretning
Starte kreditforbrugende jobs (generering, ændringer i crawl-skema)
Starte en LinkedIn-outreach-kampagne

Disse forbliver kun for superbrugere. Det er grænsen mellem "din AI kan arbejde i din virksomhed" og "din AI kan tage produktet live".

Sådan vælger du

Zapier / eksisterende synkroniseringer: behold GET /api/company/mongocontact
Pipelines og scripts: POST /api/v2/{toolName} (Bearer eller token)
AI-klienter: MCP, derefter skills_search hvis værktøjsnavnet ikke er åbenlyst

OpenAPI findes på GET /api/v2/openapi.json.

Sådan aktiverer du skriverettigheder

Console → Indstillinger → Integrationer → MCP (eller API).
Generér en nøgle. Marker Tillad begrænsede skriverettigheder.
Kopiér den én gang. Opbevar den som enhver anden hemmelighed.
Peg klienten på https://api.smoc.ai/mcp med Authorization: Bearer <key>, eller kald POST /api/v2/{toolName}.
Bed klienten om at køre whoami, derefter mcp_capabilities. Kapabilitetslisten fortæller dig, hvilke skriverettigheder nøglen har.

Hvis et værktøj mangler, navngiver mcp_capabilities tilladelsen. Indbakke-send kræver inbox:write på en skriveaktiveret nøgle. Ældre nøgler uden indbakke-scopes skal roteres.

Hvorfor denne form

Vi åbnede læseadgang først, så Claude og Cursor kunne se virksomheden uden et ekstra API. Vi åbnede skriverettigheder kun, hvor en fejl kan rettes: et tag, et liste-medlemskab, en virksomheds-URL, et tekstsvar med idempotensnøgle.

Vi åbnede ikke publicering, live toggle, sletninger eller kampagneafsendelse. Disse bruger credits eller ændrer, hvad prospects ser. De forbliver bag et menneske i Console — eller et superbruger-token.

De samme værktøjer findes på REST v2, så et script og en MCP-klient kan ikke drive fra hinanden.