Tekoälyavustajan liittäminen (MCP)

Mistä on kyse

MCP-yhteydellä tekoälyavustaja hakee tiedot suoraan Cleveniosta. Dataa ei tarvitse viedä CSV:nä ja liittää keskusteluun. Avustaja etsii päättäjiä pohjoismaisesta tietokannasta, paljastaa sähköposteja ja puhelinnumeroita, rakentaa listoja sekä lukee ja kirjoittaa CRM-tietojasi.

MCP (Model Context Protocol) on avoin standardi. Jokainen sitä tukeva avustaja yhdistyy Clevenioon samalla osoitteella:

https://app.clevenio.io/mcp

Kirjaudut avustajan sisällä tavallisella Clevenio-tunnuksellasi. API-avainta ei tarvitse luoda eikä kierrättää. Yhteys käyttää samoja krediittejä ja kutsurajoja kuin rajapinta, ja kaikki pysyy oman työtilasi sisällä. Pääkäyttäjät näkevät valmiin asetuslohkon kopiointipainikkeineen kohdassa Settings → API → Install MCP.

Ennen kuin aloitat

• Clevenio-tunnus. Yhteys perii käyttäjäsi oikeudet ja rajautuu omaan työtilaasi.

• Tekoälytyökalu, joka tukee etä-MCP-palvelimia (Streamable HTTP). Kaikki tämän ohjeen työkalut tukevat.

• Node.js 18 tai uudempi vain, jos työkalusi tarvitsee mcp-remote-välityksen (ks. alempaa).

Älä liitä API-avainta MCP-asetuksiin. MCP tunnistautuu vain selainkirjautumisella, ja clv_-alkuinen avain hylätään. API-avaimet ovat REST-rajapintaa varten.

Claude (web, työpöytä ja mobiili)

Toimii claude.ai:ssa sekä Clauden työpöytä- ja mobiilisovelluksissa.

1. Avaa Settings → Connectors. claude.ai:ssa asetukset ovat profiilivalikon alla.

2. Valitse Add custom connector.

3. Anna nimeksi Clevenio ja osoitteeksi https://app.clevenio.io/mcp.

4. Valitse Add ja sitten Connect. Selainikkuna aukeaa.

5. Kirjaudu Clevenioon ja hyväksy käyttöoikeus.

6. Palaa keskusteluun, avaa työkaluvalikko ja varmista, että Clevenio on päällä.

Kerran lisätty connector toimii kaikissa Claude-sovelluksissasi, myös Claude Codessa.

Claude Code

Aja terminaalissa kerran:

claude mcp add --transport http clevenio https://app.clevenio.io/mcp

Käynnistä Claude Code, aja /mcp, valitse clevenio ja sitten Authenticate. Selain aukeaa kirjautumista varten.

• Kaikkiin projekteihin: lisää komennon perään -s user.

• Tarkista yhteys: claude mcp list.

• Poista: claude mcp remove clevenio.

Jos lisäsit connectorin jo claude.ai:ssa, se on käytössä Claude Codessa ilman tätä vaihetta.

ChatGPT

Omat connectorit ovat ChatGPT:n web-sovelluksessa Developer moden takana. Ne ovat käytettävissä Plus-, Pro-, Business-, Enterprise- ja Edu-tilauksissa.

1. Avaa Settings → Apps & Connectors → Advanced settings.

2. Kytke Developer mode päälle.

3. Palaa kohtaan Apps & Connectors ja valitse Add custom connector.

4. Nimi: Clevenio. Osoite: https://app.clevenio.io/mcp. Tunnistautuminen: OAuth.

5. Luo connector ja kirjaudu Clevenioon avautuvassa ikkunassa.

6. Ota Clevenio käyttöön keskustelun +- tai Apps-valikosta. Hyväksy työkalukutsut, kun ChatGPT kysyy.

ChatGPT pyytää vahvistuksen jokaisen työkalun ensimmäisellä käyttökerralla. Lue, mitä hyväksyt: osa työkaluista kirjoittaa CRM:ään, ja sekvenssin käynnistys lähettää oikeaa sähköpostia.

OpenAI muuttaa valikkojen nimiä usein. Jos nimet eivät täsmää, etsi asetuksista Connectors, Apps tai Developer mode. Osoite pysyy samana.

Microsoft Copilot Studio ja Microsoft 365 Copilot

1. Avaa agenttisi Copilot Studiossa ja valitse Tools.

2. Valitse Add a tool → New tool → Model Context Protocol.

3. Nimi: Clevenio. Kuvaus: pohjoismainen B2B-päättäjädata ja CRM. Osoite: https://app.clevenio.io/mcp.

4. Tunnistautuminen: OAuth 2.0.

5. Luo työkalu. Copilot Studio tuo Clevenion työkalut automaattisesti, eikä niitä tarvitse kuvata käsin.

6. Julkaise agentti.

Jokainen käyttäjä kirjautuu ensimmäisellä kerralla omalla Clevenio-tunnuksellaan, joten oikeudet ja krediittien kulutus pysyvät henkilökohtaisina. Kun Clevenio lisää uuden työkalun, se tulee mukaan seuraavassa synkronoinnissa.

Cursor

Lisää tämä tiedostoon ~/.cursor/mcp.json (kaikki projektit) tai projektin .cursor/mcp.json-tiedostoon:

{
  "mcpServers": {
    "clevenio": {
      "type": "http",
      "url": "https://app.clevenio.io/mcp"
    }
  }
}

Avaa sitten Cursor Settings → Tools & MCP. Clevenio näkyy listalla kirjautumiskehotteen kanssa. Klikkaa sitä ja kirjaudu.

VS Code ja GitHub Copilot

Luo työtilaan tiedosto .vscode/mcp.json:

{
  "servers": {
    "clevenio": {
      "type": "http",
      "url": "https://app.clevenio.io/mcp"
    }
  }
}

Tai ohita tiedosto: Command Palette → MCP: Add Server → HTTP, ja liitä osoite. Käynnistä palvelin merkinnän yläpuolella olevasta Start-linkistä ja hyväksy selainkirjautuminen. Avaa sitten Chat, vaihda Agent-tilaan ja ota Clevenio käyttöön työkaluvalitsimesta.

Huomaa: VS Code käyttää ylätason avainta servers, GitHub Copilot CLI avainta mcpServers.

Windsurf

Tiedosto on ~/.codeium/windsurf/mcp_config.json (macOS ja Linux) tai %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):

{
  "mcpServers": {
    "clevenio": {
      "serverUrl": "https://app.clevenio.io/mcp"
    }
  }
}

Avaa Cascade → MCP-paneeli → Refresh ja valitse Clevenion kohdalla Login.

Huomaa: Windsurfissa kentän nimi on serverUrl, ei url. Cursorin tai Clauden asetusten kopioiminen sellaisenaan on yleisin syy siihen, ettei palvelin näy listalla.

Gemini CLI

Lisää tiedostoon ~/.gemini/settings.json:

{
  "mcpServers": {
    "clevenio": {
      "httpUrl": "https://app.clevenio.io/mcp"
    }
  }
}

Aja gemini ja sitten /mcp. Ensimmäinen työkalukutsu avaa selaimen kirjautumista varten. Uudemmissa versioissa toimii myös komento gemini mcp add --transport http clevenio https://app.clevenio.io/mcp.

Muut MCP-työkalut

Cline, Continue, Zed, Goose, LibreChat, Raycast, n8n ja useimmat muut lukevat saman lohkon. Liitä se työkalun MCP-asetustiedostoon:

{
  "mcpServers": {
    "clevenio": {
      "type": "http",
      "url": "https://app.clevenio.io/mcp"
    }
  }
}

Jos työkalu kysyy tiedot erikseen: yhteystapa Streamable HTTP, osoite https://app.clevenio.io/mcp ja tunnistautuminen OAuth. Avainta tai omia otsakkeita ei tarvita.

Jos työkalu ei osaa selainkirjautumista: mcp-remote

mcp-remote hoitaa kirjautumisen koneellasi ja välittää muun liikenteen sellaisenaan. Se vaatii Node.js 18:n tai uudemman.

{
  "mcpServers": {
    "clevenio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.clevenio.io/mcp"]
    }
  }
}

Ensimmäinen ajo avaa selaimen kerran, ja tunniste tallentuu hakemistoon ~/.mcp-auth. Poista hakemisto, jos haluat kirjautua uudelleen.

Toimiiko yhteys?

Kysy avustajalta tavallisella kielellä:

• ”Paljonko minulla on Cleveniossa krediittejä?”

• ”Millä kentillä voin suodattaa suomalaisia päättäjiä?”

Kumpikaan ei kuluta krediittejä. Jos saat oikean saldon ja listan kentistä, yhteys toimii. Jos avustaja sanoo, ettei sillä ole Clevenio-työkaluja, käynnistä työkalu uudelleen ja varmista työkaluvalitsimesta, että Clevenio on päällä tässä keskustelussa.

Mitä voit pyytää

• Haku: yritykset, päättäjät ja tilinpäätöstiedot Suomesta, Ruotsista, Norjasta ja Tanskasta sekä muut tilaukseesi kuuluvat aineistot. Suodatus esimerkiksi senioriteetin, tehtäväalueen, toimialan, henkilöstömäärän, liikevaihdon, kaupungin, teknologioiden ja verkkosivujen tiivistelmien mukaan.

• Yhteystiedot: varmennetut sähköpostit ja puhelinnumerot valitulle joukolle. Isommat joukot toimitetaan ladattavana CSV-tiedostona.

• Työtila: listat, päättäjät, yritykset, diilit, myyntiputket, tehtävät, muistiinpanot, sekvenssit ja triggerit.

Esimerkki ketjusta:

1. ”Etsi helsinkiläiset yli 100 hengen yritykset, joiden kuvauksessa mainitaan logistiikka. Anonymisoituna, ensin pelkkä lukumäärä.”

2. ”Rajaa C-tason ja operatiivisen johdon päättäjiin. Montako nyt?”

3. ”Paljasta 60 parasta ja anna CSV-linkki.”

4. ”Tallenna ne uudelle listalle nimellä Q3 Logistiikka ja luo minulle tehtävä käydä lista läpi huomenna.”

Krediittejä kuluu vasta kolmannessa vaiheessa, koska rajaus tehdään ilmaisilla, anonymisoiduilla tuloksilla.

Krediitit ja turvallinen käyttö

Ilmaista: kenttien selaus, suodattimen tarkistus, saldon tarkistus, päättäjäprofiilit, tilinpäätöstiedot, CRM:n luku ja kirjoitus sekä anonymisoitu haku. Maksullista: haku tunnistetietoineen, yhteystietojen paljastus ja rikastus. Avustaja näkee työkalun hinnan ennen kutsua, ja voit aina kysyä, paljonko jokin maksoi.

• Rajaa ensin anonymisoituna ja paljasta vasta kavennettu joukko. Sano sana ”anonymisoitu”, niin olet varma.

• Yli noin 50 rivistä pyydä CSV-linkki. Se on halvempi käsitellä ja pitää keskustelun siistinä.

• Kutsuraja on 60 pyyntöä minuutissa.

• Poistot ovat pehmeitä: poistettu CRM-tietue katoaa listoilta, mutta sitä ei tuhota.

• Massa-ajoissa pyydä avustajaa kertomaan myös virheet, ei vain onnistuneiden määrää.

Sekvenssin käynnistys lähettää oikeaa sähköpostia oikeille ihmisille. Älä anna avustajan tehdä sitä valvomatta. Pyydä sitä näyttämään päättäjät ja sekvenssi ensin, ja vahvista erikseen.

Jos yhteys ei toimi

Tietoturva

• Rajattu työtilaan. Yhteys lukee ja kirjoittaa vain siinä työtilassa, johon kirjauduit.

• Perii oikeutesi. Avustaja pystyy täsmälleen siihen, mihin sinä pystyt käyttöliittymässä, ei enempään.

• Ei jaettua salaisuutta. Asetustiedostoon ei liitetä avainta. Clevenio-tunnustasi ei anneta tekoälytoimittajalle, vain peruttavissa oleva kirjautumistunniste.

• Hallittavissa. Näet ja perut liitetyt sovellukset kohdassa Settings → MCP Sessions. Connectorin poistaminen työkalusta päättää pääsyn.

Lue myös

Oma profiili ja MCP-istunnot · Sähköpostisynkronointi, webhookit ja API · Krediitit ja tilaus