---
title: MCP
description: >-
  Ekstern MCP på https://api.linkdash.dev/mcp. Logg inn med OAuth fra Claude,
  ChatGPT, Cursor og Codex, eller bruk en API-nøkkel.
sidebar:
  label: MCP
  order: 5
---
Ekstern MCP på `https://api.linkdash.dev/mcp`. Legg til URL-en i klienten din og logg inn med Linkdash-kontoen din. Har du agenter som kjører uten at noen sitter ved en nettleser, bruker du en [API-nøkkel](#automation-and-headless-agents) i stedet. Ren markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Koble til

Gi klienten bare URL-en `https://api.linkdash.dev/mcp`. Klienten åpner en innlogging til Linkdash og deretter en samtykkeskjerm som viser navnet på appen og nettstedet du sendes tilbake til. Tillat tilgangen, så får klienten et token for kontoen din.

- **claude.ai og Claude Desktop:** åpne [Linkdash i koblingskatalogen](https://claude.ai/directory/linkdash) (eller gå til Customize → Connectors og søk etter Linkdash) og klikk **Connect**.
- **ChatGPT:** en oppføring i ChatGPTs plugin-katalog kommer snart. Frem til da går du til [Plugins](https://chatgpt.com/plugins), velger **+** → **Add custom MCP server**, skriver inn URL-en over og velger OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, deretter `claude mcp login linkdash` (eller `/mcp` i en økt).
- **Cursor:** [Legg til i Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) installerer serveren med ett klikk. Logg deretter inn når Cursor ber om det. Du kan også legge til serveren i `mcp.json` med `"url"` og uten `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, deretter `codex mcp login linkdash`.

Appen får samme tilgang som en API-nøkkel. Tilkoblede apper vises under [Dashbord → API-nøkler](https://linkdash.dev/dashboard/keys). Der kan du trykke **Koble fra** for å trekke tilbake tilgangen umiddelbart.

## Automatisering og hodeløse agenter

Innlogging krever at noen sitter ved en nettleser. For CI-jobber, planlagte agenter, servere og kode som kaller MCP direkte, sender du en [API-nøkkel](https://linkdash.dev/dashboard/keys) i stedet: `Authorization: Bearer ldash_...`. Dette er de samme nøklene som brukes i [HTTP-API-et](/no/api).

**Cursor** (`~/.cursor/mcp.json` eller `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}
```

**Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp --header "Authorization: Bearer $LINKDASH_API_KEY"` (i JSON trenger du `"type": "http"`).

**Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp --bearer-token-env-var LINKDASH_API_KEY`

**OpenCode:** `opencode mcp add linkdash --url https://api.linkdash.dev/mcp --header Authorization="Bearer $LINKDASH_API_KEY"`

Lokalt: Convex-URL-en som slutter på `.site`, med `/mcp` lagt til.

## Filer

Ikke send bytes gjennom MCP-JSON. Generer en URL (`{uploadUrl,storageId}`), last opp filen fra verten med PUT, og opprett deretter lenken:

```bash
curl https://api.linkdash.dev/v1/uploads \
  -H "Authorization: Bearer ldash_..." \
  -H "Content-Type: application/json" \
  -d '{"fileSize":12345}'

curl -X PUT -H "Content-Type: video/mp4" --data-binary @clip.mp4 "$uploadUrl"

curl https://api.linkdash.dev/v1/links \
  -H "Authorization: Bearer ldash_..." \
  -H "Content-Type: application/json" \
  -d '{"storageId":"…","fileName":"clip.mp4","fileType":"video/mp4","fileSize":12345}'
```

MCP-verktøy: `files_upload_url` returnerer `{uploadUrl,storageId}` → verten laster opp til `uploadUrl` med PUT → `links_create` med denne `storageId`. Du kan legge til et forhåndsvisningskort med `previewName`, `previewDescription` og `previewImageStorageId` (samme opplastingsflyt). Med `maxOpenings` settes lenken på pause etter så mange åpninger. `links_update` kan øke grensen eller fjerne den med `clearMaxOpenings`. Ikke vis `uploadUrl` til brukeren.

## Verktøy

| CLI | HTTP | MCP |
| --- | --- | --- |
| `auth whoami` | `GET /me` | `whoami` |
| `links list` | `GET /links` (`?q=&tag=&kind=&status=&folder=&limit=&cursor=`) | `links_list` |
| `links get <id>` | `GET /links/:id` (`?domain=`) | `links_get` |
| `links create --url/--file/--text/--folder` | `POST /links` | `links_create` |
| `links update <id>` | `PATCH /links/:id` | `links_update` |
| `links move <id>` | `POST /links/:id/move` | `links_move` |
| `links copy <id>` | `POST /links/:id/copy` | `links_copy` |
| `links delete <id>` | `DELETE /links/:id` (`?contents=keep\|delete`) | `links_delete` |
| `links share <id> --email <e>` | `POST /links/:id/shares` | `links_share` |
| `links unshare <id> --email <e>` | `DELETE /links/:id/shares/:email` | `links_unshare` |
| `links shares <id>` | `GET /links/:id/shares` | `links_shares` |
| `links shares` (uten id) | `GET /shares` | `links_shares` (uten `id`) |
| `links shared` | `GET /shared` | `links_shared` |
| `links leave <_id \| share URL>` | `DELETE /shared/:id` | `links_leave` |
| `links_share_role` | `{ id, email, role }` → `{ id, email, role }` (viewer eller editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → målet; låser opp en passordbeskyttet variant for en editor i 30 minutter |
| `links_activity` | `{ id, limit?, cursor? }` → `{ items: [{ action, detail?, actor, _creationTime }], cursor }` |
| `links role <id> --email <e> --role viewer\|editor` | `PATCH /links/:id/shares/:email` | `links_share_role` |
| `links unlock <_id \| share URL>` | `POST /links/:id/unlock` | `links_unlock` |
| `links activity <id>` | `GET /links/:id/activity` | `links_activity` |
| `links reset-link <id>` | `POST /links/:id/reset-link` | `links_update` (`resetShareLink: true`) |
| `links stats --last 24h` | `GET /links/:id/stats?last=24h` | `links_stats` |
| `links export` | `GET /links/export` | `links_export` |
| `links import` | `POST /links/import` | `links_import` |
| `links variants list <id>` | `GET /links/:id/variants` | `variants_list` |
| `links variants add <id>` | `POST /links/:id/variants` | `variants_add` |
| `links variants update <id> <name>` | `PATCH /links/:id/variants/:name` | `variants_update` |
| `links variants remove <id> <name>` | `DELETE /links/:id/variants/:name` | `variants_remove` |
| (verten laster opp med PUT etter at URL-en er generert) | `POST /uploads` | `files_upload_url` |
| | `DELETE /uploads/:storageId` | `files_discard` |
| `webhooks list/create/get/rotate/delete` | `GET/POST /webhooks`, `GET/DELETE /webhooks/:id`, `POST /webhooks/:id/rotate` | `webhooks_*` |
| `domains list/add/connect/verify/remove` | `GET/POST /domains`, `GET /domains/:host/connect`, `POST /domains/:host/verify`, `DELETE /domains/:host` | `domains_*` |

## Mapper

En mappe er en lenke som viser elementene du legger i den. Se [Mapper](/no/folders) for hvordan modellen fungerer.

| Verktøy | Inndata |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` oppretter en mappe. Alle opprettingskall tar `folder` (slug) og `folderDomain?` hvis du vil opprette elementet inne i en mappe. Svaret inneholder `folder` |
| `links_list` | Returnerer én side, `{ items, cursor }` (`limit` 1-100, standard 50; send `cursor` tilbake til den er `null`). `q` søker etter ord. `folder: "<slug>"` viser det som ligger direkte i mappen, og `folder: "root"` viser toppnivået. `kind` støtter også `folder`. Radene har `folder`, og mapperader har `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (samme tilgang, ny delings-URL, ingen personer lagt til) |
| `links_delete` | `contents?: "keep" \| "delete"` for mapper (standard er `keep`) |

`links_export` / `links_import` har i tillegg kolonnene `folder` og `access`, og rader med `kind` `folder` oppretter mapper.

## Tilgang og deling

Nye lenker og mapper har begrenset tilgang: `url` er `https://linkdash.dev/s/<token>`, og bare du og de du deler med kan åpne den. Send `access` til `links_create` eller `links_update`: `restricted` (standard), `link` (alle som har delings-URL-en) eller `public` (alle, via den korte URL-en). Bruk `access: "public"` når lenken skal publiseres offentlig. Se [Deling og tilgang](/no/sharing).

| Verktøy | Inndata |
| --- | --- |
| `links_share` | `{ id, domain?, emails: string[] (1–50), role? }` → `{ id, url, access, invited, alreadyShared }` |
| `links_unshare` | `{ id, domain?, email }` → `{ id, email, removed: true }` |
| `links_shares` | `{ id, domain? }` → `{ id, access, url, people: [{ email, role, accepted, invitedAt, viaFolder? }] }`. Med `{ limit?, cursor? }` får du én side med alt du har delt, `{ items, cursor }`, hvert element med `people` |
| `links_shared` | `{ limit?, cursor? }` → én side med elementer andre har delt med deg, `{ items, cursor }`, med `url` du bruker for å åpne hvert element |
| `links_leave` | `{ id }` (`_id` eller delings-URL-en fra `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` endrer hvem som kan åpne lenken. `resetShareLink: true` lager en ny delings-URL, og den gamle slutter å virke |

`url` i svarene er alltid delings-URL-en, unntatt når lenken er offentlig. Da er det den korte URL-en. Deling, fjerning av deling, endring av tilgang og tilbakestilling teller hver som én hendelse. Å forlate et delt element teller ikke.

## Varianter

Hver lenke inneholder én eller flere **varianter**. En variant består av innhold (`url` | `file` | `text`) og har sin egen sperre (`password`, `starts`, `expires`, `maxOpenings`, pauset), en `weight` og valgfrie betingelser for besøkende i `when`. Uten `variants` har en lenke én variant som heter `main`. Sperren på lenken går foran sperrene på variantene. Hver besøkende får én variant. Variantene der `when` matcher, danner utvalget (finnes ingen, brukes variantene uten betingelser), og så velges én av dem vektet. `sticky` (standard `true`) gjør at en besøkende som kommer tilbake får samme variant, og `restartSplit` fordeler de besøkende på nytt. Lenkens `kind` er `group` når den har flere varianter, og lenkens `status` er `mixed` når variantene har ulik status. En lenke kan ha maks 20 varianter. Strukturer: [HTTP-API](/no/api#varianter).

`links_create` tar `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` i stedet for kortformen, i tillegg til `sticky` og `forwardParams`. `links_update` tar `sticky`, `forwardParams` og `restartSplit`. I `links_list` kan du også filtrere `kind` på `group` og `status` på `mixed`. `links_stats` returnerer totaler i `variants`. `links_export` / `links_import` bruker CSV-formatet for varianter (én rad per variant).

| Verktøy | Inndata |
| --- | --- |
| `variants_list` | `{ id, domain? }` |
| `variants_add` | `{ id, domain?, name, url \| text \| storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }` |
| `variants_update` | `{ id, name, domain?, newName?, url?, text?, storageId?, password?, clearPassword?, starts?, clearStarts?, expires?, clearExpires?, maxOpenings?, clearMaxOpenings?, status?, weight?, when?, clearWhen?, utm? }` |
| `variants_remove` | `{ id, name, domain? }` |

Nøkler i `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (lister med strenger; alle nøkler du angir, må matche) og `params`.

**Regler for spørreparametere.** `when.params` er en liste med opptil 10 regler for spørrestrengen til den besøkende, og alle reglene må være oppfylt: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` er en liste skilt med `|`) | `exists` | `missing` (de to siste tar ingen `value`). Nøklene skiller mellom store og små bokstaver, og verdiene må være helt like. Parameterverdier lagres aldri i analysedataene.

**Videresending av spørreparametere.** `forwardParams` (boolsk verdi på `links_create` / `links_update`, standard `false`) legger hele spørrestrengen til den besøkende til på URL-varianter. Verdiene fra den besøkende overstyrer de lagrede verdiene, også `utm`. Gjelder bare URL-varianter. Dette styrer ruting, ikke tilgang.

`auth create` / `auth login` / `auth logout` finnes ikke som MCP-verktøy. Oversikt over hvordan verktøyene svarer til hverandre: [api.md](https://linkdash.dev/api.md).
