# Käytä Dvina-palvelua muista sovelluksista MCP:n avulla > Yhdistä MCP-asiakas, kuten Claude Code, ChatGPT tai Cursor, Dvina-palveluun, kirjaudu sisään ja anna sen lukea ja lisätä sisältöä Dvina-palveluusi hyväksynnälläsi. Dvina-palvelulla on oma MCP-palvelin. Yhdistä MCP-asiakas, kuten Claude Code, ChatGPT tai Cursor, niin sovellus voi tehdä hakuja Dvina-palvelussasi, lukea dokumenttejasi ja muistiasi sekä lisätä muistiinpanoja, tehtäviä ja muistutuksia nimissäsi. ## Ennen kuin aloitat Tarvitset palvelimen osoitteen: ```text https://api.dvina.ai/mcp ``` Jos yrityksesi käyttää Dvina-palvelua omilla palvelimillaan, käytä yrityksesi omaa Dvina API -osoitetta ja lisää sen loppuun `/mcp`. Pyydä osoite ylläpitäjältäsi. Palvelin käyttää Streamable HTTP -protokollaa. Jos asiakas kysyy siirtotapaa, valitse HTTP. ## Yhdistä asiakas ::: tabs === Claude Code 1. Suorita päätteessä: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp ``` 2. Käynnistä Claude Code, suorita `/mcp`, valitse **dvina** ja kirjaudu Dvina-palveluun. === ChatGPT 1. Avaa ChatGPT:n kohta, jossa voit lisätä MCP-palvelimen. 2. Anna palvelimen osoitteeksi `https://api.dvina.ai/mcp` ja valitse OAuth, jos kirjautumistapaa kysytään. 3. Kirjaudu Dvina-palveluun, kun ChatGPT pyytää. === Cursor 1. Avaa Cursorin kohta, jossa voit lisätä MCP-palvelimen. 2. Lisää palvelin nimeltä `dvina` ja anna sen osoitteeksi `https://api.dvina.ai/mcp`. 3. Kirjaudu Dvina-palveluun, kun Cursor pyytää. ::: Et tarvitse asiakastunnusta tai salaisuutta. Asiakas rekisteröityy itse Dvina-palveluun ensimmäisellä yhdistämiskerralla. ## Kirjaudu sisään Dvina-palvelun MCP-palvelin kirjaa sinut sisään OAuthin avulla selaimessasi: 1. Kirjaudu Dvina-palveluun tavalliseen tapaan. 2. Jos kuulut useampaan kuin yhteen työtilaan, valitse työtila kohdasta **Valitse työtila** ja valitse sitten **Jatka**. Asiakas toimii vain kyseisessä työtilassa. 3. Tarkista sovelluksen nimi kohdasta **Valtuuta käyttö** ja valitse sitten **Salli käyttö**. Valitse **Estä**, jos et tunnista sovellusta. Asiakas pysyy yhdistettynä, joten sinun ei tarvitse kirjautua sisään joka kerta. ## Mitä asiakas voi tehdä Asiakas näkee Dvina-palvelun työkalut ja käyttää niitä, kun pyyntösi sitä edellyttää: | Osa-alue | Mitä asiakasohjelma voi tehdä | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | **Haku** | Hakea keskusteluista, asiakirjoista, muistista ja maailmasta samalla kertaa. | | **Muisti** | Luetella ja lukea muistitiedostojasi, lisätä uuden tai muokata olemassa olevaa. | | **Maailma** | Luetella aiheesi, näyttää, mitä Dvina tietää jostakin aiheesta tai mistä tahansa muusta, ja luetella syötteesi sisällön. | | **Asiakirjat** | Luetella, lukea ja hakea kirjastosi sisältöä, luoda muistiinpanoja ja kansioita, ladata tiedostoja sekä korvata, siirtää tai nimetä asiakirjan uudelleen tai siirtää sen roskakoriin. | | **Kanvaasi** | Luetella ja lukea kanvaasejasi, luoda kanvaasin tai kirjoittaa sivun uudelleen. | | **Tehtävät ja tavoitteet** | Luetella tehtäväsi ja lukea, mitä ne ovat tehneet, käynnistää tehtävän tai tavoitetta edistävän tehtävän, antaa tehtävälle lisää tekemistä tai pysäyttää sen. | | **Ajastetut viestit** | Luetella ajastetut viestit, ajastaa viestin tai muistutuksen kertaluonteiseksi tai toistuvaksi tai peruuttaa sen. | | **Agentit ja taidot** | Luetella ja lukea agenttejasi ja taitojasi, luoda agentin, lisätä taidon tai muokata kumpaa tahansa. | | **Projektit** | Luetella projektisi ja näyttää projektin kansion ja viimeaikaiset tehtävät. | | **Jakaminen** | Näyttää, kenellä on kohteen käyttöoikeus ja mitä muut ovat jakaneet kanssasi, tai antaa tai poistaa jonkun käyttöoikeuden. | | **Asetukset** | Näyttää asetuksesi tai ottaa muistin käyttöön tai poistaa sen käytöstä. | Asiakasohjelma ei voi poistaa mitään pysyvästi, avata julkisia linkkejä, yhdistää sovelluksia tai katkaista niiden yhteyksiä eikä muuttaa ylläpito- tai laskutusasetuksia. ## Hyväksy muutokset Asiakasohjelman toimintaa koskevat samat säännöt kuin kaikkea muutakin Dvina-palvelussa: - Lukeminen ei vaadi vahvistusta. - Uuden sisällön, kuten muistiinpanon, muistitiedoston tai tehtävän, lisääminen ei vaadi vahvistusta. Se ei koskaan muuta olemassa olevaa sisältöä. - Muuttaminen tai poistaminen, kuten asiakirjan siirtäminen roskakoriin, kanvaasisivun kirjoittaminen uudelleen, tehtävän pysäyttäminen tai kohteen jakaminen, vaatii ensin vahvistuksesi. Asiakasohjelma näyttää Dvina-palvelun oman yhteenvedon muutoksesta, ja voit hyväksyä tai hylätä sen. Jos hylkäät sen, mikään ei muutu. > [!NOTE] > Jos asiakasohjelma ei voi pyytää sinulta vahvistusta, Dvina ei tee sen pyytämää muutosta. Tee muutos sen sijaan Dvina-sovelluksessa tai käytä asiakasohjelmaa, joka voi pyytää vahvistusta. ## Käyttöoikeutesi ja yrityksesi säännöt Asiakasohjelma toimii nimissäsi ja voi nähdä ja tehdä samat asiat kuin sinä Dvina-palvelussa: - Se toimii vain niin kauan kuin olet työtilan jäsen ja vain roolisi sallimissa rajoissa. - Jos ylläpitäjä poistaa ominaisuuden käytöstä, esimerkiksi tiedostojen lataamisen, asiakasohjelmakaan ei voi käyttää sitä. - Asiakasohjelman lisäyksiin ja muutoksiin sovelletaan yrityksesi tietosuojasääntöjä samalla tavalla kuin sovelluksessa. - Sen lisäykset ja muutokset kirjataan [tapahtumalokiisi](/docs/teams/audit-log) avustajan puolestasi tekemiksi toimiksi. Lokissa näkyy myös, mistä asiakasohjelmasta ne tulivat. - Sen toiminta lasketaan mukaan käyttöösi ja siihen sovelletaan tavanomaisia käyttörajojasi. ## Yhdistä API-avaimella OAuthin sijaan Enterprise-tilauksessa asiakasohjelma voi muodostaa yhteyden henkilökohtaisella käyttöoikeustunnuksella kirjautumisen sijaan. Käytä tätä asiakasohjelmassa, joka ei voi kirjautua OAuthilla, tai komentosarjassa. 1. Avaa Asetukset ja valitse **API-käyttöoikeus**. 2. Valitse kohdasta **Henkilökohtaiset käyttöoikeustunnukset** vaihtoehto **Luo tunnus**. 3. Anna **Nimi**, valitse **Käyttöoikeus** ja **Vanhenemisaika** ja valitse sitten **Luo tunnus**. 4. Kopioi tunnus kohdasta **Kopioi tunnuksesi**. Tunnus näytetään vain tämän kerran. Valitse asiakasohjelman tarvitsemat käyttöoikeudet: - **Vain luku:** asiakasohjelma näkee vain lukemiseen tarkoitetut työkalut. Se voi hakea ja lukea sisältöäsi Dvina-palvelussa, mutta ei lisätä tai muuttaa mitään. - **Luku ja kirjoitus:** asiakasohjelma näkee kaikki työkalut, ja muutokset vaativat edelleen hyväksyntäsi, kuten OAuthia käytettäessä. Lähetä tunnus `Authorization`-otsakkeessa arvon `Bearer` jälkeen. Esimerkiksi Claude Code -ohjelmassa: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` Lisää toisessa asiakasohjelmassa sama otsake kohtaan, jossa voit määrittää MCP-palvelimen otsakkeet. Tunnus toimii nimissäsi siinä työtilassa, jossa loit sen, ja sen oikeudet määräytyvät nykyisen roolisi mukaan. Jos haluat korvata tunnuksen, avaa se kohdasta **Henkilökohtaiset käyttöoikeustunnukset** ja valitse **Vaihda…**: uusi tunnus korvaa vanhan, ja vanha lakkaa toimimasta heti. Jos haluat poistaa tunnuksen käytöstä, valitse **Peruuta…**: kaikki sitä käyttävät yhteydet lakkaavat toimimasta heti. Lisätietoja tunnuksista on sivulla [API-käyttöoikeus](/docs/dvina-mcp/api-access). ## Aiheeseen liittyvää - [Mukautetut sovellukset ja MCP-palvelimet](/docs/connectors/custom-apps) - [API-käyttöoikeus](/docs/dvina-mcp/api-access) - [Käytä dvina-komentoa](/docs/dvina-mcp/cli) - [Tiimien yleiskatsaus](/docs/teams/overview)