SMOC er nå et API: MCP, REST og valgfri skriving

Skrevet av: Kristoffer Kvam
September 11, 2026

Ett invoke-lag for hele selskapet driver nå to flater: AI-klienter bruker MCP, pipelines bruker REST v2, og den gamle kontakt-endepunktet forblir. Standardnøkler er skrivebeskyttet. Huk av for Tillat begrenset skriving når du oppretter en nøkkel, og de samme verktøyene kan oppdatere kontakter, lister og tagger — og sende et tekstsvar i innboksen.

Hva som er lansert

SMOC hadde allerede en Streamable HTTP MCP-server på samme worker som det offentlige API-et. Hvert domeneverktøy kan kalles på to måter:

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

Policy, leietakertilgang, raterestriksjoner, bekreftelse og idempotens kjøres én gang. En skriving som blokkeres i MCP, blokkeres også i REST.

GET /api/company/mongocontact er uendret. Zapier-nøkler forblir skrivebeskyttet og beholder samme sti, token-header og responsformat.

Hva du kan lese

Kundenøkler dekker hele selskapet, ikke bare kontakter:

Kontakter, statistikk, tagger og prospektlister
Selskapsprofil, eiendeler og CPCS-crawl-status
Studio-katalog — versjoner, temaer, målrettingsporteføljer, genererings- og oversettelsesjobber
Flytanalyse
LinkedIn-innbokstråder og meldingsflyt-samtaler

En kundetoken kan ikke velge et annet selskap. Superbruker-nøkler kan fortsatt sende companyId når det trengs.

Hva nøkler med skrivetilgang kan gjøre

Opprett nøkkelen under Innstillinger → Integrasjoner → MCP eller API og huk av for Tillat begrenset skriving. Eksisterende skrivebeskyttede nøkler får ikke skrivetilgang før du lager en ny med denne boksen huket av.

Kontakter og lister

Opprett eller oppdater en kontakt
Opprett eller gi nytt navn til en tag, tildel eller fjern den
Opprett eller gi nytt navn til en prospektliste, legg til eller fjern en kontakt

Selskap og crawl

Oppdater felter i selskapsprofilen
Oppdater grunnleggende selskapseiendeler
Legg til en CPCS-URL for crawling

Studio-metadata

Gi nytt navn til et flytskjema
Oppdater status på en anbefaling (bruk / avvis — ikke publiser)

Innboks

Arkiver en tråd, marker den som ulest, eller marker ubesvarte som håndtert
Send et kun tekst-svar med inbox_threads_send

Send krever threadId, body og idempotencyKey. Nøkkelen må kunne laste inn tråden først; en manglende eller annen-selskap-tråd gir ikke funnet. Forsøk med samme nøkkel dobbeltsender ikke. Raterestriksjon er 10 sendinger per minutt. Ingen vedlegg.

Hva som fortsatt ikke er tilgjengelig for kundenøkler

Skrivetilgang betyr ikke full admin.

Kundenøkler kan fortsatt ikke:

Slette kontakter, tagger, lister, selskaper eller eiendeler
Publisere en flyt eller slå den live (flowcharts_set_active)
Opprette eller duplisere et flytskjema
Endre målretting
Starte kredittbelastende jobber (generering, endring av crawl-plan)
Starte en LinkedIn-utsendelseskampanje

Dette forblir kun for superbrukere. Det er skillet mellom «din AI kan jobbe i ditt selskap» og «din AI kan ta produktet live».

Hvordan velge

Zapier / eksisterende synkroniseringer: behold GET /api/company/mongocontact
Pipelines og skript: POST /api/v2/{toolName} (Bearer eller token)
AI-klienter: MCP, deretter skills_search hvis verktøynavnet ikke er åpenbart

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

Hvordan aktivere skriving

Console → Innstillinger → Integrasjoner → MCP (eller API).
Generer en nøkkel. Huk av for Tillat begrenset skriving.
Kopier den én gang. Oppbevar den som enhver annen hemmelighet.
Pek klienten til https://api.smoc.ai/mcp med Authorization: Bearer <key>, eller kall POST /api/v2/{toolName}.
Be klienten kjøre whoami, deretter mcp_capabilities. Kapabilitetslisten forteller hvilke skrivinger den nøkkelen har tilgang til.

Hvis et verktøy mangler, navngir mcp_capabilities tillatelsen. Innbokssending krever inbox:write på en nøkkel med skrivetilgang. Eldre nøkler uten innboks-omfang må roteres.

Hvorfor denne formen

Vi åpnet for lesing først slik at Claude og Cursor kunne se selskapet uten et ekstra API. Vi åpnet for skriving kun der feil er reversible: en tag, et liste-medlemskap, en selskaps-URL, et tekstsvar med idempotensnøkkel.

Vi åpnet ikke for publisering, live-toggling, sletting eller kampanjeutsendelse. Disse bruker kreditter eller endrer hva prospekter ser. De forblir bak et menneske i Console — eller en superbruker-token.

De samme verktøyene finnes på REST v2, så et skript og en MCP-klient kan ikke avvike.