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:
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
Claude Code
Suorita päätteessä:
claude mcp add --transport http dvina https://api.dvina.ai/mcpKäynnistä Claude Code, suorita
/mcp, valitse dvina ja kirjaudu Dvina-palveluun.
ChatGPT
- Avaa ChatGPT:n kohta, jossa voit lisätä MCP-palvelimen.
- Anna palvelimen osoitteeksi
https://api.dvina.ai/mcpja valitse OAuth, jos kirjautumistapaa kysytään. - Kirjaudu Dvina-palveluun, kun ChatGPT pyytää.
Cursor
- Avaa Cursorin kohta, jossa voit lisätä MCP-palvelimen.
- Lisää palvelin nimeltä
dvinaja anna sen osoitteeksihttps://api.dvina.ai/mcp. - 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:
- Kirjaudu Dvina-palveluun tavalliseen tapaan.
- Jos kuulut useampaan kuin yhteen työtilaan, valitse työtila kohdasta Valitse työtila ja valitse sitten Jatka. Asiakas toimii vain kyseisessä työtilassa.
- 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.
Huomio
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 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.
- Avaa Asetukset ja valitse API-käyttöoikeus.
- Valitse kohdasta Henkilökohtaiset käyttöoikeustunnukset vaihtoehto Luo tunnus.
- Anna Nimi, valitse Käyttöoikeus ja Vanhenemisaika ja valitse sitten Luo tunnus.
- 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:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
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.