Integrations · MCP

Oma avustajasi, Cloopin tiedot

Kysy myyntiputkesta, valmistaudu tapaamiseen tai etsi asiakkaan taustatiedot suoraan käyttämässäsi tekoälyavustajassa.

Mitä MCP-yhteys tekee?

Model Context Protocol eli MCP on tapa antaa tekoälyavustajalle pääsy toisen palvelun työkaluihin. Cloopin yhteys antaa avustajan lukea työtilasi CRM-tietoja henkilökohtaisella API-avaimella. Se ei muuta tietueita, lähetä viestejä tai varaa tapaamisia. Käytettävissä ovat työtilallesi ja käyttäjällesi sallitut CRM-työkalut.

1. Luo avain oikeaan työtilaan

Kirjaudu Cloop Appiin järjestelmänvalvojana ja valitse työtila, jonka tiedot haluat yhdistää. Avaa Asetukset → Tiedot ja liittymät → API-avaimet. Connect-konsolissa sama kortti löytyy asetusten Integraatiot-sivulta.

Anna avaimelle tunnistettava nimi, esimerkiksi ”Oma Cursor”, ja valitse Luo avain. Kopioi avain talteen: se näytetään vain kerran. Kopioi myös MCP-palvelimen osoite kortin Kopioi osoite -painikkeella.

Käytä saman ympäristön avainta ja osoitetta. Eri työtilojen ja ympäristöjen avaimet ovat erillisiä. Avaimen voi perua samasta kortista; peruttu avain ei enää kelpaa seuraavaan pyyntöön.

2. Yhdistä avustaja

Yhteys käyttää Streamable HTTP -kuljetusta ja Authorization: Bearer -otsaketta. Korvaa alla CLOOP_MCP_URL kortista kopioimallasi osoitteella. Aseta avain käyttämäsi asiakasohjelman ympäristömuuttujaan CLOOP_API_KEY. Älä liitä avainta keskusteluviestiin tai versionhallintaan. Asiakasohjelman täytyy nähdä muuttuja käynnistyessään.

Cursor: lisää yhteys henkilökohtaiseen ~/.cursor/mcp.json-tiedostoosi.

{ "mcpServers": { "cloop": { "url": "CLOOP_MCP_URL", "headers": { "Authorization": "Bearer ${env:CLOOP_API_KEY}" } } } }

Claude Code: lisää HTTP-palvelin projektisi .mcp.json-tiedostoon. Tämä esimerkki koskee Claude Codea; Claude Desktopin ja verkkoversion yhteyksille ei tässä vaiheessa luvata samaa asetustapaa.

{ "mcpServers": { "cloop": { "type": "http", "url": "CLOOP_MCP_URL", "headers": { "Authorization": "Bearer ${CLOOP_API_KEY}" } } } }

Codex CLI: lisää yhteys ~/.codex/config.toml-tiedostoon.

[mcp_servers.cloop] url = "CLOOP_MCP_URL" bearer_token_env_var = "CLOOP_API_KEY"

ChatGPT: suora yhdistäminen ChatGPT:n liittimeksi tarvitsee OAuth-tuen. Se ei sisälly tähän API-avainversioon.

Ajantasaiset asiakasohjeet: Cursor, Claude Code, Codex CLI ja ChatGPT:n tunnistautuminen.

3. Kokeile omaa työtäsi koskevalla kysymyksellä

Pyydä esimerkiksi: ”Listaa omat avoimet tehtäväni Cloopista” tai ”Näytä Cloopin myyntiputken yhteenveto”. Hyväksy työkalukutsu asiakasohjelmassasi. Vastaus perustuu Cloopissa oleviin tietoihin; tyhjä lista voi tarkoittaa, ettei sinulle ole vielä osoitettu tehtäviä tai tapaamisia.

Omia kauppoja, tehtäviä ja tapaamisia listaavat työkalut käyttävät avaimen luoneen käyttäjän tietoja. Haku ja myyntiputken raportit kattavat kyseisen työtilan. CRM-moduulin puuttuessa työkaluja ei näy.

Avaimet ja tietojen käsittely

Käsittele avainta salasanan tavoin. Työkalun palauttamat CRM-tiedot välittyvät valitsemallesi avustajalle, joten käytä organisaatiosi hyväksymää palvelua ja sen tietosuoja-asetuksia. Cloop ei tallenna avaimen selväkielistä arvoa. Avaimen luominen ja peruminen kirjataan lokiin, ja käyttäjän pääsyn poistaminen työtilasta estää myös hänen avaimensa käytön.

Jos yhteys vastaa 401, tarkista osoite, ympäristömuuttuja ja avaimen voimassaolo. Jos avain on kadonnut, peru se ja luo uusi. Tyhjä työkalulista voi johtua CRM-käyttöoikeuksista. Rajapinnan käyttöä rajoitetaan pyyntömäärän mukaan.

Työkalut

Nämä nimet ja englanninkieliset kuvaukset tulevat Cloopin työkalurekisteristä. Samat kuvaukset näytetään avustajalle. Liikevaihtotyökalu kertoo voitettujen kauppojen arvon, ei sopimuspohjaista MRR:ää tai ARR:ää.