---
title: MCP
description: >-
  Remote MCP på https://api.linkdash.dev/mcp. Log ind med OAuth fra Claude,
  ChatGPT, Cursor og Codex, eller brug en API-nøgle.
sidebar:
  label: MCP
  order: 5
---
Remote MCP på `https://api.linkdash.dev/mcp`. Tilføj URL'en til din klient, og log ind med din Linkdash-konto. Til agenter, der kører uden en person ved en browser, skal du i stedet bruge en [API-nøgle](#automation-and-headless-agents). Ren markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Opret forbindelse

Giv kun klienten URL'en `https://api.linkdash.dev/mcp`. Den åbner et Linkdash-login og derefter en samtykkeskærm, der viser navnet på appen og det site, den vender tilbage til. Tillad det, så får klienten et token til din konto.

- **claude.ai og Claude Desktop:** åbn [Linkdash i connector-oversigten](https://claude.ai/directory/linkdash) (eller Customize → Connectors, og søg efter Linkdash), og klik på **Connect**.
- **ChatGPT:** Linkdash kommer snart i ChatGPT's plugin-oversigt. Indtil da kan du i [Plugins](https://chatgpt.com/plugins) vælge **+** → **Add custom MCP server**, indtaste URL'en ovenfor og vælge OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, derefter `claude mcp login linkdash` (eller `/mcp` i en session).
- **Cursor:** [Tilføj til Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) installerer den med ét klik. Log derefter ind, når Cursor beder om det. Eller tilføj serveren til `mcp.json` med `"url"` og uden `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, derefter `codex mcp login linkdash`.

Appen får samme adgang som en API-nøgle. Forbundne apps vises under [Dashboard → API-nøgler](https://linkdash.dev/dashboard/keys), hvor **Afbryd forbindelse** tilbagekalder dem med det samme.

## Automatisering og headless agenter

Login kræver en person ved en browser. Til CI-jobs, planlagte agenter, servere og kode, der kalder MCP direkte, skal du i stedet sende en [API-nøgle](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Det er de samme nøgler som til [HTTP API'et](/da/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"` (JSON kræver `"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-`.site`-URL + `/mcp`.

## Filer

Send ikke bytes gennem MCP JSON. Opret en upload-URL (`{uploadUrl,storageId}`), lav en PUT af filen fra hosten, og opret derefter linket:

```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-værktøjer: `files_upload_url` returnerer `{uploadUrl,storageId}` → hosten laver en PUT til `uploadUrl` → `links_create` med det `storageId`. Valgfrit unfurl-kort: `previewName`, `previewDescription`, `previewImageStorageId` (samme slags upload). Med den valgfri `maxOpenings` sættes linket på pause efter det antal åbninger. `links_update` kan hæve grænsen eller sende `clearMaxOpenings`. Vis ikke `uploadUrl` til brugeren.

## Værktøjer

| 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` (uden id) | `GET /shares` | `links_shares` (uden `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 en adgangskodebeskyttet variant op 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` |
| (hosten laver PUT efter upload-URL'en er oprettet) | `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 et link, der viser de elementer, du lægger i den. Se [Mapper](/da/folders), hvis du vil vide, hvordan de fungerer.

| Værktøj | Input |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` opretter en mappe. Alle create-kald tager `folder` (slug) og `folderDomain?`, hvis du vil oprette inde i en mappe. Svaret indeholder `folder` |
| `links_list` | Én side, `{ items, cursor }` (`limit` 1-100, standard 50; send `cursor` tilbage, indtil den er `null`). `q` matcher ord; `folder: "<slug>"` viser det, der ligger direkte i mappen; `folder: "root"` viser det øverste niveau; `kind` får værdien `folder` som ekstra mulighed. Rækker har `folder`, og mapperækker har `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (samme adgang, ny share-URL, ingen personer) |
| `links_delete` | `contents?: "keep" \| "delete"` for mapper (standard `keep`) |

`links_export` / `links_import` tilføjer kolonnerne `folder` og `access`, og rækker med `kind` `folder` opretter mapper.

## Adgang og deling

Nye links og mapper er begrænsede: `url` er `https://linkdash.dev/s/<token>`, som kun du og de personer, du deler med, kan åbne. Send `access` med til `links_create` eller `links_update`: `restricted` (standard), `link` (alle med share-URL'en) eller `public` (alle, via den korte URL). Brug `access: "public"`, når linket skal deles offentligt. Se [Deling og adgang](/da/sharing).

| Værktøj | Input |
| --- | --- |
| `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? }] }`; `{ limit?, cursor? }` → én side med alt, hvad du har delt, `{ items, cursor }`, hver med `people` |
| `links_shared` | `{ limit?, cursor? }` → én side med elementer, som andre har delt med dig, `{ items, cursor }`, med den `url`, du åbner hvert element med |
| `links_leave` | `{ id }` (`_id` eller share-URL'en fra `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` ændrer, hvem der kan åbne det; `resetShareLink: true` udsteder en ny share-URL (den gamle holder op med at virke) |

Den `url`, der kommer tilbage i et svar, er altid share-URL'en, medmindre linket er offentligt. Så er det den korte URL. Deling, fjernelse af deling, adgangsændringer og nulstillinger tæller hver som én hændelse. Når nogen forlader et delt element, tæller det ikke.

## Varianter

Hvert link indeholder en eller flere **varianter**. En variant består af indhold (`url` | `file` | `text`) plus sine egne adgangsbetingelser (`password`, `starts`, `expires`, `maxOpenings`, sat på pause), en `weight` og valgfrie besøgsbetingelser i `when`. Uden `variants` har et link én variant ved navn `main`. Linkets adgangsbetingelser går forud for variantens. En besøgende får én variant: De varianter, hvis `when` matcher, udgør puljen (ellers bruges dem uden betingelser), og derefter vælges én ud fra vægtene. `sticky` (standard `true`) holder en tilbagevendende besøgende på den samme variant, og `restartSplit` fordeler de besøgende forfra. Linkets `kind` er `group`, når der er flere varianter, og linkets `status` er `mixed`, når varianternes status er forskellig. Maks. 20 varianter pr. link. Datastrukturer: [HTTP API](/da/api#varianter).

`links_create` tager `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` i stedet for kortformen, plus `sticky` og `forwardParams`. `links_update` tager `sticky`, `forwardParams` og `restartSplit`. `links_list` filtrerer på `kind` (med `group` som ekstra værdi) og `status` (med `mixed` som ekstra værdi). `links_stats` returnerer totaler for `variants`. `links_export` / `links_import` bruger variant-CSV'en (én række pr. variant).

| Værktøj | Input |
| --- | --- |
| `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? }` |

`when`-nøgler: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (arrays af strenge; alle angivne nøgler skal matche), plus `params`.

**Regler for query-parametre.** `when.params` er et array med op til 10 regler for den besøgendes query string, og alle regler skal være opfyldt: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` er en `|`-separeret liste) | `exists` | `missing` (ingen `value` for de to sidste). Nøgler skelner mellem store og små bogstaver, og værdier skal matche præcist. Parameterværdier gemmes aldrig i analytics.

**Videresend query-parametre.** `forwardParams` (boolean på `links_create` / `links_update`, standard `false`) tilføjer hele den besøgendes query string til URL-varianter. Den besøgendes værdier overskriver de gemte, også `utm`. Virker kun på URL-varianter. Det styrer routing og er ikke adgangskontrol.

`auth create` / `auth login` / `auth logout` er ikke MCP-værktøjer. Oversigt: [api.md](https://linkdash.dev/api.md).
