# Bruk Dvina fra andre apper med MCP

> Koble en MCP-klient som Claude Code, ChatGPT eller Cursor til Dvina, logg inn, og la den lese og legge til innhold i Dvina med din godkjenning.

Dvina har sin egen MCP-server. Koble til en MCP-klient, som Claude Code, ChatGPT eller Cursor, så kan appen søke i Dvina, lese dokumentene og minnet ditt og legge til notater, oppgaver og påminnelser på dine vegne.

## Før du begynner

Du trenger serveradressen:

```text
https://api.dvina.ai/mcp
```

Hvis bedriften din kjører Dvina på egne servere, bruker du bedriftens egen API-adresse for Dvina med `/mcp` til slutt. Be administratoren om adressen.

Serveren bruker Streamable HTTP. Hvis klienten ber deg velge en transport, velger du HTTP.

## Koble til en klient

::: tabs

=== Claude Code

1. Kjør dette i terminalen:

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Start Claude Code, kjør `/mcp`, velg **dvina**, og logg inn på Dvina.

=== ChatGPT

1. Åpne stedet i ChatGPT der du kan legge til en MCP-server.
2. Skriv inn `https://api.dvina.ai/mcp` som serveradresse, og velg OAuth hvis du blir spurt om innloggingsmetode.
3. Logg inn på Dvina når ChatGPT ber om det.

=== Cursor

1. Åpne stedet i Cursor der du kan legge til en MCP-server.
2. Legg til en server med navnet `dvina` og adressen `https://api.dvina.ai/mcp`.
3. Logg inn på Dvina når Cursor ber om det.

:::

Du trenger ikke en klient-ID eller klienthemmelighet. Klienten registrerer seg hos Dvina første gang den kobler til.

## Logg inn

MCP-serveren til Dvina logger deg inn med OAuth i nettleseren:

1. Logg inn på Dvina som vanlig.
2. Hvis du tilhører flere arbeidsområder, velger du ett under **Velg arbeidsområde** og deretter **Fortsett**. Klienten fungerer bare i dette arbeidsområdet.
3. Under **Godkjenn tilgang** sjekker du navnet på appen og velger deretter **Tillat tilgang**. Velg **Avslå** hvis du ikke kjenner den igjen.

Klienten forblir tilkoblet, så du slipper å logge inn hver gang.

## Hva en klient kan gjøre

Klienten ser verktøyene i Dvina og bruker dem når forespørselen din krever det:

| Område                 | Hva klienten kan gjøre                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Søk**                | Søke i samtalene, dokumentene, minnet og verdenen din samtidig.                                                                               |
| **Minne**              | Liste opp og lese minnefilene dine, legge til en ny eller endre en eksisterende.                                                             |
| **Verden**             | Liste opp emnene dine, vise hva Dvina vet om et emne eller noe annet, og liste opp feeden din.                                                |
| **Dokumenter**         | Liste opp, lese og søke i biblioteket ditt, opprette notater og mapper, laste opp filer og erstatte, flytte eller gi nytt navn til et dokument, eller flytte det til papirkurven. |
| **Lerret**             | Liste opp og lese lerretene dine, opprette et lerret eller skrive om en side.                                                                 |
| **Oppgaver og mål**    | Liste opp oppgavene dine og lese hva de har gjort, starte en oppgave eller en oppgave som jobber mot et mål, gi en oppgave mer å gjøre eller stoppe en oppgave. |
| **Planlagte meldinger** | Liste dem opp, planlegge en melding eller påminnelse som sendes én gang eller gjentas, eller avbryte en.                                    |
| **Agenter og ferdigheter** | Liste opp og lese agentene og ferdighetene dine, opprette en agent, legge til en ferdighet eller endre en av dem.                        |
| **Prosjekter**         | Liste opp prosjektene dine og vise mappen og de siste oppgavene til et prosjekt.                                                             |
| **Deling**             | Se hvem som har tilgang til et element, og hva andre har delt med deg, eller gi eller fjerne noens tilgang.                                  |
| **Innstillinger**      | Vise preferansene dine eller slå minnet av eller på.                                                                                        |

Klienten kan ikke slette noe permanent, åpne offentlige lenker, koble til eller fra apper eller endre administrator- eller faktureringsinnstillinger.

## Godkjenn endringer

Det klienten gjør, følger de samme reglene som ellers i Dvina:

- Lesing skjer uten at du blir spurt.
- Nye ting, som et notat, en minnefil eller en oppgave, legges til uten at du blir spurt. Dette endrer aldri noe som allerede finnes.
- Når noe skal endres eller fjernes, som å flytte et dokument til papirkurven, skrive om en side på et lerret, stoppe en oppgave eller dele et element, blir du spurt først. Klienten viser Dvinas eget sammendrag av endringen, og du godkjenner eller avslår den. Hvis du avslår, endres ingenting.

> [!NOTE]
> Hvis en klient ikke kan be deg om å bekrefte, utfører ikke Dvina endringen fra den klienten. Gjør endringen i Dvina-appen i stedet, eller bruk en klient som kan spørre.

## Tilgangen din og bedriftens regler

Klienten handler på dine vegne, med tilgang til det du kan se og gjøre i Dvina:

- Den fungerer bare så lenge du er medlem av arbeidsområdet, og bare innenfor det rollen din tillater.
- Hvis administratoren slår av en funksjon, som filopplasting, kan heller ikke klienten bruke den.
- Det klienten legger til eller endrer, behandles etter bedriftens regler for databeskyttelse, akkurat som i appen.
- Det den legger til eller endrer, registreres i [revisjonsloggen](/docs/teams/audit-log) din som utført av assistenten på dine vegne, med klienten det kom fra.
- Det den gjør, teller med i forbruket ditt, innenfor de vanlige grensene dine.

## Koble til med en API-nøkkel i stedet for OAuth

Med Enterprise-abonnementet kan en klient koble til med et personlig tilgangstoken i stedet for å logge inn. Bruk dette for en klient som ikke kan logge inn med OAuth, eller for et skript.

1. Åpne Innstillinger og velg **API-tilgang**.
2. Under **Personlige tilgangstokener** velger du **Opprett token**.
3. Skriv inn et **Navn**, velg **Tilgang** og når det **Utløper**, og velg deretter **Opprett token**.
4. Under **Kopier tokenet ditt** kopierer du tokenet. Dette er den eneste gangen det vises.

Velg tilgangen klienten trenger:

- **Kun lesing:** Klienten ser bare verktøyene som leser. Den kan søke og lese i Dvina, men kan ikke legge til eller endre noe.
- **Lesing og skriving:** Klienten ser alle verktøyene, og endringer krever fortsatt godkjenning fra deg, som med OAuth.

Send tokenet i `Authorization`-headeren, etter `Bearer`. I Claude Code, for eksempel:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

I en annen klient legger du til den samme headeren der du kan angi headere for en MCP-server.

Tokenet handler på dine vegne i arbeidsområdet du opprettet det i, med rollen du har der nå. For å erstatte det åpner du det under **Personlige tilgangstokener** og velger **Roter…**: Et nytt token erstatter det, og det gamle slutter å fungere med en gang. For å deaktivere det velger du **Tilbakekall…**: Alt som bruker det, slutter å fungere med en gang.

Les mer om tokener under [API-tilgang](/docs/dvina-mcp/api-access).

## Relatert

- [Egendefinerte apper og MCP-servere](/docs/connectors/custom-apps)
- [API-tilgang](/docs/dvina-mcp/api-access)
- [Bruk dvina-kommandoen](/docs/dvina-mcp/cli)
- [Oversikt over team](/docs/teams/overview)
