---
title: MCP
description: >-
  Fjärr-MCP på https://api.linkdash.dev/mcp. Logga in med OAuth från Claude,
  ChatGPT, Cursor och Codex, eller använd en API-nyckel.
sidebar:
  label: MCP
  order: 5
---
Fjärr-MCP på `https://api.linkdash.dev/mcp`. Lägg till URL:en i din klient och logga in med ditt Linkdash-konto. För agenter som körs utan att någon sitter vid en webbläsare använder du en [API-nyckel](#automation-and-headless-agents) i stället. Ren markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Anslut

Ge klienten bara URL:en `https://api.linkdash.dev/mcp`. Den öppnar en inloggning till Linkdash och sedan en samtyckesskärm som visar appens namn och webbplatsen den skickar dig tillbaka till. Godkänn, så får klienten en token för ditt konto.

- **claude.ai och Claude Desktop:** öppna [Linkdash i kopplingskatalogen](https://claude.ai/directory/linkdash) (eller Customize → Connectors och sök efter Linkdash) och klicka på **Connect**.
- **ChatGPT:** Linkdash kommer snart att finnas i ChatGPT:s plugin-katalog. Tills dess väljer du **+** → **Add custom MCP server** i [Plugins](https://chatgpt.com/plugins), anger URL:en ovan och väljer OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, sedan `claude mcp login linkdash` (eller `/mcp` i en session).
- **Cursor:** [Lägg till i Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) installerar den med ett klick. Logga sedan in när Cursor ber om det. Du kan också lägga till servern i `mcp.json` med `"url"` och utan `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, sedan `codex mcp login linkdash`.

Appen får samma åtkomst som en API-nyckel. Anslutna appar listas under [Dashboard → API-nycklar](https://linkdash.dev/dashboard/keys), där **Koppla från** återkallar dem direkt.

## Automatisering och headless-agenter

Inloggning kräver att någon sitter vid en webbläsare. För CI-jobb, schemalagda agenter, servrar och kod som anropar MCP direkt skickar du i stället en [API-nyckel](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Det är samma nycklar som för [HTTP-API:et](/sv/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 krävs `"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 för `.site` + `/mcp`.

## Filer

Skicka inte filens bytes genom MCP-JSON. Skapa en uppladdnings-URL (`{uploadUrl,storageId}`), gör en PUT av filen från värden och skapa sedan länken:

```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-verktyg: `files_upload_url` returnerar `{uploadUrl,storageId}` → värden gör en PUT till `uploadUrl` → `links_create` med det `storageId`. Valfritt förhandsgranskningskort (unfurl): `previewName`, `previewDescription`, `previewImageStorageId` (laddas upp på samma sätt). Med valfria `maxOpenings` pausas länken efter så många öppningar. `links_update` kan höja gränsen eller skicka `clearMaxOpenings`. Visa inte `uploadUrl` för användaren.

## Verktyg

| 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` (utan id) | `GET /shares` | `links_shares` (utan `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 upp en lösenordsskyddad variant för en redigerare i 30 minuter |
| `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` |
| (värden gör en PUT när URL:en har skapats) | `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_*` |

## Mappar

En mapp är en länk som listar det du lägger i den. Se [Mappar](/sv/folders) för hur modellen fungerar.

| Verktyg | Indata |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` skapar en mapp. Alla create-anrop tar `folder` (slug) och `folderDomain?` för att skapa något i en mapp. Svaret innehåller `folder` |
| `links_list` | En sida, `{ items, cursor }` (`limit` 1-100, standard 50; skicka tillbaka `cursor` tills den är `null`). `q` matchar ord, `folder: "<slug>"` listar det som ligger direkt i mappen och `folder: "root"` listar toppnivån. `kind` får värdet `folder`. Varje rad har `folder` och mapprader har `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (samma åtkomst, ny delnings-URL, ingen delning med personer) |
| `links_delete` | `contents?: "keep" \| "delete"` för mappar (standard `keep`) |

`links_export` / `links_import` lägger till kolumnerna `folder` och `access`, och rader med `kind` `folder` skapar mappar.

## Åtkomst och delning

Nya länkar och mappar är begränsade: `url` är `https://linkdash.dev/s/<token>`, som bara du och de du delar med kan öppna. Skicka `access` till `links_create` eller `links_update`: `restricted` (standard), `link` (alla som har delnings-URL:en) eller `public` (alla, via den korta URL:en). Använd `access: "public"` när länken ska publiceras offentligt. Se [Delning och åtkomst](/sv/sharing).

| Verktyg | Indata |
| --- | --- |
| `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? }` → en sida med allt du har delat, `{ items, cursor }`, var och en med `people` |
| `links_shared` | `{ limit?, cursor? }` → en sida med det andra har delat med dig, `{ items, cursor }`, med den `url` som öppnar varje objekt |
| `links_leave` | `{ id }` (`_id` eller delnings-URL:en från `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` ändrar vem som kan öppna länken. `resetShareLink: true` skapar en ny delnings-URL (den gamla slutar fungera) |

`url` i varje svar är delnings-URL:en, utom när länken är publik. Då är det den korta URL:en. Delning, borttagen delning, ändrad åtkomst och återställning räknas var för sig som en händelse, men det gör inte att lämna en delning.

## Varianter

Varje länk innehåller en eller flera **varianter**. En variant är innehåll (`url` | `file` | `text`) plus egna villkor för åtkomst (`password`, `starts`, `expires`, `maxOpenings`, pausad), en `weight` och valfria villkor för besökaren i `when`. Utan `variants` har en länk en enda variant som heter `main`. Länkens åtkomstvillkor går före variantens. En besökare får en variant: de varianter vars `when` matchar bildar urvalet (annars de som saknar villkor), och sedan görs ett viktat val. `sticky` (standard `true`) håller kvar en återkommande besökare på samma variant, och `restartSplit` gör om fördelningen. Länkens `kind` är `group` när den har flera varianter, och länkens `status` är `mixed` när varianterna har olika status. Max 20 varianter per länk. Datastrukturer: [HTTP-API](/sv/api#varianter).

`links_create` tar `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` i stället för kortformen, plus `sticky` och `forwardParams`. `links_update` tar `sticky`, `forwardParams` och `restartSplit`. `links_list` kan filtrera på `kind` (som också kan vara `group`) och `status` (som också kan vara `mixed`). `links_stats` returnerar totaler i `variants`. `links_export` / `links_import` använder variant-CSV:n (en rad per variant).

| Verktyg | Indata |
| --- | --- |
| `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? }` |

Nycklar i `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (arrayer av strängar; alla nycklar du anger måste matcha), plus `params`.

**Regler för query-parametrar.** `when.params` är en array med upp till 10 regler för besökarens query-sträng, och alla regler måste vara uppfyllda: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` är en lista separerad med `|`) | `exists` | `missing` (de två sista tar inget `value`). Nycklar är skiftlägeskänsliga och värden jämförs exakt. Parametervärden sparas aldrig i statistiken.

**Vidarebefordra query-parametrar.** `forwardParams` (boolean i `links_create` / `links_update`, standard `false`) lägger till besökarens hela query-sträng på URL-varianter. Besökarens värden ersätter sparade värden, även `utm`. Gäller bara URL-varianter. Det styr routning och är ingen åtkomstkontroll.

`auth create` / `auth login` / `auth logout` är inte MCP-verktyg. Mappning: [api.md](https://linkdash.dev/api.md).
