SMOC on nyt API: MCP, REST ja valinnaiset kirjoitukset

Kirjoittanut: Kristoffer Kvam
September 11, 2026

Yksi yritystasoinen kutsukerros ohjaa nyt kahta käyttöliittymää: AI-asiakkaat käyttävät MCP:tä, putket käyttävät REST v2:ta, ja vanha kontaktipäätepiste säilyy. Oletusavaimet ovat vain luku -tilassa. Valitse Salli rajoitetut kirjoitukset luodessasi avaimen, jolloin samat työkalut voivat päivittää kontakteja, listoja ja tageja — sekä lähettää tekstivastauksen saapuneet-kansioon.

Mitä julkaistiin

SMOC:ssa oli jo Streamable HTTP MCP -palvelin samalla työntekijällä kuin julkinen API. Jokainen domain-työkalu on kutsuttavissa kahdella tavalla:

MCP osoitteessa https://api.smoc.ai/mcp Claudea, Cursor, VS Codea ja muita MCP-asiakkaita varten
REST v2 osoitteessa POST /api/v2/{toolName} samalla JSON-sisällöllä

Käytännöt, vuokraus, nopeusrajoitukset, vahvistus ja idempotenssi suoritetaan kerran. Kirjoitus, joka estetään MCP:ssä, estetään myös REST:ssä.

GET /api/company/mongocontact pysyy muuttumattomana. Zapier-avaimet pysyvät vain luku -tilassa ja säilyttävät saman polun, token-otsikon ja vastausmuodon.

Mitä voit lukea

Asiakasavaimet kattavat yrityksen, eivät vain kontaktit:

Kontaktit, tilastot, tagit ja prospektilistat
Yritysprofiili, varat ja CPCS-indeksoinnin tila
Studio-katalogi — versiot, teemat, kohdennusportfoliot, generointi- ja käännöstyöt
Virta-analytiikka
LinkedIn-saapuneet-keskustelut ja viestivirta-keskustelut

Asiakasavain ei voi valita toista yritystä. Superkäyttäjäavaimet voivat edelleen välittää companyId tarvittaessa.

Mitä kirjoitusoikeudelliset avaimet voivat tehdä

Luo avain kohdassa Asetukset → Integraatiot → MCP tai API ja valitse Salli rajoitetut kirjoitukset. Olemassa olevat vain luku -avaimet eivät saa kirjoitusoikeuksia ennen kuin luot uuden, jossa tämä valinta on tehty.

Kontaktit ja listat

Luo tai päivitä kontakti
Luo tai nimeä tagi uudelleen, liitä tai poista se
Luo tai nimeä prospektilista uudelleen, lisää tai poista kontakti

Yritys ja indeksointi

Päivitä yritysprofiilin kenttiä
Päivitä yritysvarojen perustiedot
Lisää CPCS-URL indeksoitavaksi

Studio-metatiedot

Nimeä kaaviovirta uudelleen
Päivitä suosituksen tila (hyväksy / hylkää — ei julkaise)

Saapuneet

Arkistoi keskustelu, merkitse se lukemattomaksi tai käsitellyksi
Lähetä vain teksti -vastaus inbox_threads_send:llä

Lähettäminen vaatii threadId, body ja idempotencyKey. Avaimen on ensin pystyttävä lataamaan kyseinen keskustelu; puuttuva tai toisen yrityksen keskustelu palauttaa "ei löydy". Uudelleenyritykset samalla avaimella eivät lähetä viestiä kahdesti. Nopeusrajoitus on 10 lähetystä minuutissa. Ei liitteitä.

Mitä asiakasavaimilla ei vieläkään voi tehdä

Kirjoitusoikeus ei tarkoita täyttä ylläpitäjää.

Asiakasavaimet eivät edelleenkään voi:

Poistaa kontakteja, tageja, listoja, yrityksiä tai varoja
Julkaista virtaa tai kytkeä sitä päälle (flowcharts_set_active)
Luoda tai kopioida kaaviovirtaa
Muuttaa kohdennusta
Käynnistää krediittejä kuluttavia töitä (generointi, indeksointiaikataulun muutokset)
Käynnistää LinkedIn-viestintäkampanjaa

Nämä jäävät vain superkäyttäjille. Tämä on raja "AI voi toimia yrityksessäsi" ja "AI voi julkaista tuotteen" välillä.

Miten valita

Zapier / olemassa olevat synkronoinnit: pidä GET /api/company/mongocontact
Putket ja skriptit: POST /api/v2/{toolName} (Bearer tai token)
AI-asiakkaat: MCP, sitten skills_search jos työkalun nimi ei ole ilmeinen

OpenAPI löytyy osoitteesta GET /api/v2/openapi.json.

Miten kirjoitukset otetaan käyttöön

Console → Asetukset → Integraatiot → MCP (tai API).
Luo avain. Valitse Salli rajoitetut kirjoitukset.
Kopioi se kerran. Säilytä kuten mikä tahansa muu salaisuus.
Ohjaa asiakas https://api.smoc.ai/mcp:ään Authorization: Bearer <key>:llä tai kutsu POST /api/v2/{toolName}.
Pyydä asiakasta suorittamaan whoami, sitten mcp_capabilities. Ominaisuuslista kertoo, mitkä kirjoitukset avain sallii.

Jos työkalu puuttuu, mcp_capabilities nimeää oikeuden. Saapuneet-lähetys vaatii inbox:write kirjoitusoikeudellisella avaimella. Vanhemmat avaimet ilman saapuneet-oikeuksia vaativat kierrätystä.

Miksi näin

Avasimme lukuoikeudet ensin, jotta Claude ja Cursor näkisivät yrityksen ilman toista API:a. Avasimme kirjoitukset vain, missä virhe on palautettavissa: tagi, listajäsenyys, yrityksen URL, tekstivastaus idempotenssiavaimella.

Emme avanneet julkaisu-, live-tilan, poisto- tai kampanjalähetystä. Ne kuluttavat krediittejä tai muuttavat, mitä prospektit näkevät. Ne pysyvät ihmisen Console-käytön — tai superkäyttäjäavaimen — takana.

Samat työkalut ovat REST v2:ssa, joten skripti ja MCP-asiakas eivät voi eriytyä.