Yhdistä SMOC MCP:hen Claudeen tai mihin tahansa muuhun tekoälypohjaiseen asiakkaaseen

Yksinkertainen opas, joka näyttää, miten SMOC yhdistetään AI-asiakasohjelmiin ja kehitystyökaluihin MCP:n (Model Context Protocol) avulla. Kun yhteys on muodostettu, työkalut kuten Claude Desktop, Claude Code, Cursor tai VS Code voivat lukea SMOC-tietojasi suoraan — kontaktit, yritykset, yritysvarat, vuokaaviot, virta-analytiikka, LinkedIn-inbox-ketjut ja viestivirta-keskustelut — rajattuna yritykseesi. HTTP-kutsujien tulee käyttää REST v2 API -viitettä.

Hanki API-avaimesi

SMOC MCP -integraatio tunnistautuu yksityisellä API-avaimella. Luo avain SMOC Consolessa:

1. Siirry kohtaan Asetukset → Integraatiot → MCP.
2. Anna avaimelle halutessasi nimi ja voimassaoloaika (7, 30 tai 90 päivää). Jätä voimassaolo kohtaan Ei vanhene, jos et halua avaimen vanhenevan.
3. Luo avain ja kopioi se heti — se näytetään vain kerran, joten tallenna se turvalliseen paikkaan.

Avaimesi on sidottu yritykseesi. Jokainen sillä tehty pyyntö rajataan automaattisesti sinun tietoihisi — näet vain omat kontaktit, yritykset, analytiikan, inbox-ketjut ja keskustelut. Uuden avaimen luominen ei mitätöi aiempia avaimia. Luodut avaimet näkyvät samalla sivulla — poista käyttämättömät avaimet sieltä.

API- ja Zapier-sivut käyttävät samaa nimeä, voimassaoloa, kertakopiointibanneria ja luotujen avainten listaa.

Mitä voit käyttää

Yhdistämisen jälkeen seuraavat työkalut ovat käytettävissä (tarkka saatavuus riippuu tilisi oikeuksista ja palvelimen asetuksista). Avaimet ovat oletuksena vain luku. Valitse Salli rajoitetut kirjoitukset avainta luodessa, jos haluat sallia alla mainitut kirjoitukset.

Löydettävyys

• whoami — nykyinen rooli, yritysrajaus ja oikeudet
• mcp_capabilities — näkyvät työkalut, taidot ja kaikki tällä hetkellä poissa käytöstä olevat
• skills_search — etsi resepti lyhyestä tehtäväkuvauksesta
• skills_get — tarkat syötteet ja esimerkki yhdelle taidolle

Yritykset & varat

• companies_get — yritysprofiili (otsikko, avain, URL, kielet, asetukset)
• company_assets_get — tuotteet, positiointi, verkkosivulinkit ja tiedostot
• company_asset_extraction_results_list — poimintatulosten yhteenvedot
• company_asset_extraction_results_get — yksi poimintatulos, halutessa poimitut tiedot
• company_asset_extraction_templates_list — pohjat, tagit ja tuoreus

Superkäyttäjäavaimet voivat myös kutsua companies_list selatakseen kaikkia yrityksiä ennen companyId:n valintaa.

Kontaktit

• contacts_search — haku suodattimilla, lajittelu ja sivutus
• contacts_get — yksi anonymisoitu kontakti id:n perusteella
• contacts_get_stats — määrät ja sitoutumisen yhteenveto
• contacts_get_filter_options — kelvolliset suodatinarvot (sijainti, virta, laite jne.)
• contact_tags_list — kontaktitagit
• prospect_lists_list / prospect_lists_get — prospektilistat

Inbox & keskustelut

• inbox_threads_list — LinkedIn (ja muiden) inbox-ketjut, suodattimet lukemattomille / vastaamattomille / lähettäjälle / virralle
• inbox_threads_get — yksi ketju; aseta includeMessages: true sisällyttääksesi viimeisimmät viestit
• inbox_messages_list — viestihistoria ketjulle, mukaan lukien yhdistetyt rinnakkaisketjut
• conversations_list — viestivirran ajot (osallistuminen, tila, nykyinen solmu)
• conversations_get — yksi keskustelun ajo, mukaan lukien virstanpylväät

Inbox-työkalut vaativat inbox:read-oikeuden. Ne voivat lukea viestisisällöt. Kirjoitusoikeudelliset avaimet voivat myös arkistoida, merkitä lukemattomaksi/käsitellyksi ja lähettää vain tekstimuotoisen vastauksen inbox_threads_send:llä (vaatii threadId, body ja idempotencyKey). Ne eivät voi liittää tiedostoja, muokata virta-kaavioita, julkaista virtoja tai aloittaa LinkedIn-kampanjoita. Superkäyttäjäavaimet voivat tallentaa Mongo-virta- ja teemaluonnoksia (flowcharts_save, flowcharts_create, themes_save ja vastaavat kutsut), mukaan lukien verkkovirta/viestivirta ja chattivirta/korttivirta-tyypit. Nämä kirjoitukset eivät julkaise.

Vuokaaviot

• flowcharts_list — yrityksen staattiset vuokaaviot
• flowcharts_get — yhden vuokaavion yhteenveto tai koko graafi
• flowchart_recommendations_list — vuokaavion suositusdokumentit
• flowcharts_versions_list, themes_get, studio_generation_categories_list, kohdennusportfoliot ja generointi-/käännöstyötehtävien luku
• Superkäyttäjän luonnoskirjoitukset: flowcharts_save, flowcharts_restore_version, flowcharts_create (flowType verkkovirta tai viestivirta, webFormat chattivirta tai korttivirta), flowcharts_duplicate, themes_save. Nämä kirjoittavat Mongo-luonnoksia eivätkä julkaise.
• CPCS-luku: cpcs_overview, URL-osoitteet, indeksoinnit, poiminnat, pohjat, aikataulu

Virta-analytiikka

• analytics_flow_list_flows — virrat liikenteen mukaan järjestettynä
• analytics_flow_kpis — kokonaismäärät, konversiot, edellisen jakson erot
• analytics_flow_timeseries — päivittäiset tai kuukausittaiset trendit
• analytics_flow_dimension_metrics — jaottelut laitteen, maan, kielen, UTM:n tai viikonpäivän mukaan
• analytics_flow_filter_values — kelvolliset analytiikkasuodattimet

Asiakasavaimet ovat aina rajattu omaan yritykseesi. Superkäyttäjäavaimet voivat välittää companyId rajatuissa työkaluissa.

---

Yhdistä Claudeen (web ja desktop)

Lisää SMOC mukautettuna liittimenä. Tämä toimii claude.ai:ssa ja Claude desktop -sovelluksessa. Voit kirjautua SMOC-tililläsi tai yhdistää API-avaimella.

Pika-aloitus

MCP-päätepiste: https://api.smoc.ai/mcp

Kirjaudu sisään

1. Claudessa avaa Mukauta, sitten + Lisää.
2. Nimeä liitin SMOC ja liitä MCP-päätepiste. Jätä kirjautuminen päälle. Älä valitse Ei kirjautumista äläkä lisää pyyntöotsikkoa.
3. Kun Claude pyytää yhdistämään, kirjaudu yrityksen pääkäyttäjätilillä.
4. Keskustelussa avaa +, valitse Liittimet ja laita SMOC päälle. Pyydä Claudelta whoami.

Kirjautuminen on vain yrityksen pääkäyttäjille. Se voi lukea kyseisen yrityksen tiedot. Jäsenet ja muut roolit estetään. Tämä ei salli niitä rajoitettuja kirjoituksia, jotka valitsit API-avainta luodessa. Jos hallinnoit useampaa yritystä, käytä API-avainta haluamallesi yritykselle.

Team- ja Enterprise-tasoilla omistaja lisää liittimen kohdasta Organisaation asetukset → Liittimet → + Lisää → Mukautettu. Jäsenet ottavat sen käyttöön Mukauta-valikosta.

Tai lisää API-avain

1. Luo API-avain kohdassa Asetukset → Integraatiot → MCP ja kopioi se.
2. Claudessa avaa Mukauta, sitten + Lisää.
3. Nimeä liitin SMOC ja liitä MCP-päätepiste.
4. Valitse Ei kirjautumista. Pyyntöotsikot-kohdassa valitse authorization ja aseta arvoksi Bearer YOUR_SMOC_API_KEY — sisällytä sana Bearer ja välilyönti. Merkitse otsikko Pakolliseksi ja lisää liitin.

Käytä avainta, kun haluat yhden yrityksen, voimassaoloajan tai rajoitetut kirjoitukset. Pyyntöotsikot ovat tulossa käyttöön. Jos + Lisää -valikossa ei ole Pyyntöotsikot-osaa, käytä Claude Codea tai alla olevaa desktopin asetustiedostoa.

Yhdistä ChatGPT:hen

ChatGPT lisää SMOCin sovelluksena. Luo-näkymä käyttää kirjautumista, eikä siinä ole kenttää API-avaimelle. Kirjaudu yrityksen pääkäyttäjätilillä.

Pika-aloitus

MCP-päätepiste: https://api.smoc.ai/mcp

1. Avaa Asetukset → Sovellukset → Lisäasetukset ja laita Kehittäjätila päälle. Business-, Enterprise- tai Edu-tasoilla workspace-ylläpitäjä laittaa sen päälle kohdasta Workspace-asetukset → Oikeudet & roolit ensin.
2. Avaa Sovellukset → Luo. Nimeä sovellus SMOC ja liitä MCP-päätepiste.
3. Valitse OAuth, sitten Skannaa työkalut. Kirjaudu yrityksen pääkäyttäjätilillä, kun ChatGPT pyytää, ja klikkaa Luo.
4. Keskustelussa avaa työkalut-valikko ja laita SMOC päälle. Pyydä ChatGPT:tä suorittamaan whoami.

Kirjautuminen on vain yrityksen pääkäyttäjille. Se voi lukea kyseisen yrityksen tiedot. Jäsenet estetään. API-avaimet ovat Claudeen, Cursorille ja VS Codeen. ChatGPT vaatii Plus-, Pro-, Business-, Enterprise- tai Edu-tilauksen mukautettuihin sovelluksiin.

Yhdistä Claude Desktopiin asetustiedostolla

Käytä tätä, kun liitindialogi ei hyväksy API-avainta. SMOC yhdistyy tällöin pienen paikallisen sillan (mcp-remote) kautta.

1. Avaa Claude Desktop → Asetukset → Kehittäjä → Muokkaa asetuksia. Tämä avaa claude_desktop_config.json.
2. Lisää SMOC kohtaan mcpServers:

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

3. Korvaa YOUR_SMOC_API_KEY luomallasi avaimella.
4. Tallenna tiedosto ja käynnistä Claude Desktop uudelleen.

SMOC näkyy nyt työkalulistassasi. Vaatii Node.js:n asennettuna (npx:lle).

---

Yhdistä Claude Codeen

Claude Code voi keskustella SMOC-päätepisteen kanssa suoraan autentikointiotsikolla — siltaa ei tarvita.

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

Claude Code 2.1.1:ssa ja uudemmissa voit lisätä sen myös JSONina:

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

Varmista yhteys suorittamalla /mcp Claude Code -istunnossa — SMOC näkyy yhdistettynä ja työkalut listattuna.

---

Yhdistä muihin asiakasohjelmiin (Cursor, VS Code, Windsurf jne.)

Useimmat MCP-yhteensopivat editorit käyttävät JSON-asetustiedostoa (yleensä mcp.json). Lisää HTTP-palvelinmerkintä, joka osoittaa SMOC-päätepisteeseen ja avain Authorization-otsikkoon:

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

Katso editorisi MCP-dokumentaatiosta tarkka tiedoston sijainti. Tallenna muutokset ja käynnistä tai lataa editori uudelleen.

---

Varmista yhteys

• Terveystarkistus: päätepiste tarjoaa GET https://api.smoc.ai/mcp/health.
• Identiteettitarkistus: pyydä AI:ta suorittamaan whoami-työkalu — se palauttaa, kenenä olet yhdistettynä ja yritysrajaus. Tämä on nopein tapa varmistaa avaimen toimivuus.

Työkalujen löytäminen

AI:n ei tarvitse tietää SMOCin työkalujen nimiä etukäteen. Tarkoitettu korttivirta on:

1. mcp_capabilities — listaa käytettävissä olevat työkalut, roolisi ja rajauksesi.
2. skills_search — kuvaile tehtävä lyhyesti löytääksesi oikean työkalun.
3. skills_get — palauttaa tarkat syötteet ja esimerkin valitulle työkalulle.
4. Suorita työkalu.

Käytännössä voit vain kysyä luonnollisella kielellä (esim. "etsi SMOC-kontaktini Oslossa" tai "näytä vastaamattomat LinkedIn-inbox-ketjut") ja asiakasohjelma valitsee oikean työkalun.

Tietoturvahuomautukset

• API-avaimesi näytetään vain kerran luotaessa — tallenna se salasanojen hallintaan tai ympäristömuuttujaan.
• Älä koskaan tallenna avainta Git-repositorioon tai jaettuun/julkiseen asetukseen.
• Uuden avaimen luominen ei mitätöi aiempia avaimia. Poista käyttämättömät avaimet kohdasta Asetukset → Integraatiot → MCP.
• Asiakasavaimet ovat oletuksena vain luku ja rajattu yrityksesi tietoihin. Kirjoitusoikeudelliset avaimet voivat päivittää kontakteja, tageja, listoja, yritysprofiilia, lisätä CPCS-URL-osoitteita, käsitellä inboxia ja lähettää tekstivastauksia inboxiin. Ne eivät voi poistaa tietoja, julkaista virtoja, vaihtaa live-tilaa tai aloittaa LinkedIn-kampanjoita.
• Inbox- ja keskustelutyökalut tarvitsevat inbox:read-avaimessa. Uudet avaimet kohdasta Asetukset → Integraatiot → MCP sisältävät sen; vanhat avaimet vaativat kierron.

Vianmääritys

• Työkaluja puuttuu listasta: AI voi suorittaa mcp_capabilities ja tarkistaa unavailableTools — se nimeää tarkalleen puuttuvan oikeuden, jonka avain tarvitsee.
• Tunnistautuminen epäonnistuu: varmista, että avain on oikein, sitä ei ole mitätöity ja että otsikko on täsmälleen Authorization: Bearer <key>.
• Clauden + Lisää -dialogissa ei ole Pyyntöotsikot-osaa: käytä Claude Code -komentoa tai yllä olevaa mcp-remote-asetusta. Varmista, että Node.js on asennettu, asetusten JSON on validi ja että käynnistit Claude Desktopin kokonaan uudelleen muokkauksen jälkeen.

Katso myös

• REST v2 API -viite — kaikki POST /api/v2/{toolName}-kutsut
• SMOCin yhdistäminen REST API:lla
• Julkinen Contacts API
• MCP Claudelle, Cursorille ja VS Codelle