---
title: MCP
description: >-
  Remote MCP op https://api.linkdash.dev/mcp. Log in met OAuth vanuit Claude,
  ChatGPT, Cursor en Codex, of gebruik een API-key.
sidebar:
  label: MCP
  order: 5
---
Remote MCP op `https://api.linkdash.dev/mcp`. Voeg de URL toe aan je client en log in met je Linkdash-account. Voor agents die draaien zonder dat er iemand achter een browser zit, gebruik je in plaats daarvan een [API-key](#automation-and-headless-agents). Platte markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Verbinden

Geef de client alleen de URL `https://api.linkdash.dev/mcp`. Die opent een Linkdash-login en daarna een toestemmingsscherm dat de app noemt en de site waar je naar terugkeert. Sta het toe, en de client krijgt een token voor je account.

- **claude.ai en Claude Desktop:** open [Linkdash in de connectordirectory](https://claude.ai/directory/linkdash) (of Customize → Connectors en zoek op Linkdash) en klik op **Connect**.
- **ChatGPT:** een vermelding in de ChatGPT-plugindirectory komt binnenkort. Tot die tijd kies je in [Plugins](https://chatgpt.com/plugins) **+** → **Add custom MCP server**, vul je de URL hierboven in en kies je OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, daarna `claude mcp login linkdash` (of `/mcp` in een sessie).
- **Cursor:** [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) installeert het met één klik; log daarna in wanneer Cursor erom vraagt. Of voeg de server toe aan `mcp.json` met `"url"` en zonder `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, daarna `codex mcp login linkdash`.

De app krijgt dezelfde toegang als een API-key. Verbonden apps staan onder [Dashboard → API-sleutels](https://linkdash.dev/dashboard/keys), waar je met **Ontkoppelen** de toegang direct intrekt.

## Automatisering en headless agents

Inloggen vereist iemand achter een browser. Voor CI-jobs, geplande agents, servers en code die MCP rechtstreeks aanroept, stuur je in plaats daarvan een [API-key](https://linkdash.dev/dashboard/keys) mee: `Authorization: Bearer ldash_...`, dezelfde keys als voor de [HTTP API](/nl/api).

**Cursor** (`~/.cursor/mcp.json` of `.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 heeft `"type": "http"` nodig).

**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"`

Lokaal: Convex-`.site`-URL + `/mcp`.

## Bestanden

Stuur geen bytes via MCP-JSON. Maak een URL aan (`{uploadUrl,storageId}`), PUT het bestand vanaf de host en maak daarna de link aan:

```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-tools: `files_upload_url` geeft `{uploadUrl,storageId}` terug → de host doet een PUT naar `uploadUrl` → `links_create` met die `storageId`. Optionele unfurl-kaart: `previewName`, `previewDescription`, `previewImageStorageId` (zelfde upload). Met de optionele `maxOpenings` wordt de link gepauzeerd na dat aantal keer openen; `links_update` kan dit verhogen of `clearMaxOpenings` meegeven. Toon `uploadUrl` niet aan de gebruiker.

## Tools

| 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` (zonder id) | `GET /shares` | `links_shares` (zonder `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 of editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → het doel; ontgrendelt een met een wachtwoord beveiligde variant voor een editor voor 30 minuten |
| `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` |
| (host doet PUT na aanmaken) | `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_*` |

## Mappen

Een map is een link die de items toont die je erin zet. Zie [Mappen](/nl/folders) voor het model.

| Tool | Input |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` maakt een map aan; elke create accepteert `folder` (slug) en `folderDomain?` om iets in een map aan te maken. De response bevat `folder` |
| `links_list` | Eén pagina, `{ items, cursor }` (`limit` 1-100, standaard 50; geef `cursor` steeds terug tot die `null` is). `q` matcht woorden; `folder: "<slug>"` toont wat er direct in staat; `folder: "root"` toont het hoogste niveau; `kind` krijgt er `folder` bij. Rijen bevatten `folder`, en maprijen bevatten `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (zelfde toegang, nieuwe share-URL, geen personen) |
| `links_delete` | `contents?: "keep" \| "delete"` voor mappen (standaard `keep`) |

`links_export` / `links_import` voegen de kolommen `folder` en `access` toe, en rijen met `kind` `folder` maken mappen aan.

## Toegang en delen

Nieuwe links en mappen zijn afgeschermd: `url` is `https://linkdash.dev/s/<token>`, die alleen jij en de mensen met wie je deelt kunnen openen. Geef `access` mee bij `links_create` of `links_update`: `restricted` (standaard), `link` (iedereen met de share-URL) of `public` (iedereen, via de korte URL). Vraag om `access: "public"` als de link openbaar gepost gaat worden. Zie [Delen en toegang](/nl/sharing).

| Tool | 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 pagina met alles wat jij hebt gedeeld, `{ items, cursor }`, elk met `people` |
| `links_shared` | `{ limit?, cursor? }` → één pagina met items die anderen met jou hebben gedeeld, `{ items, cursor }`, met de `url` om elk item te openen |
| `links_leave` | `{ id }` (de `_id` of share-URL uit `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` wijzigt wie het kan openen; `resetShareLink: true` geeft een nieuwe share-URL uit (de oude werkt dan niet meer) |

Elke `url` in een response is de share-URL, tenzij de link openbaar is; dan is het de korte URL. Delen, delen intrekken, toegangswijzigingen en resets tellen elk als één event; een gedeeld item verlaten niet.

## Varianten

Elke link is een container van een of meer **varianten**: content (`url` | `file` | `text`) plus een eigen gate (`password`, `starts`, `expires`, `maxOpenings`, gepauzeerd), een `weight` en optionele bezoekersvoorwaarden `when`. Zonder `variants` heeft een link één variant met de naam `main`. De gate van de link gaat boven die van de varianten. Een bezoeker krijgt één variant: varianten waarvan `when` matcht vormen de pool (anders de onvoorwaardelijke), daarna volgt een gewogen keuze; `sticky` (standaard `true`) houdt een terugkerende bezoeker op dezelfde variant en `restartSplit` schudt opnieuw. De `kind` van een link is `group` bij meerdere varianten; de `status` van een link is `mixed` als varianten verschillen. Maximaal 20 varianten per link. Structuren: [HTTP API](/nl/api#varianten).

`links_create` accepteert `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` in plaats van de verkorte vorm, plus `sticky` en `forwardParams`. `links_update` accepteert `sticky`, `forwardParams` en `restartSplit`. `links_list` filtert op `kind` (met `group` erbij) en `status` (met `mixed` erbij). `links_stats` geeft totalen per `variants` terug. `links_export` / `links_import` gebruiken de varianten-CSV (één rij per variant).

| Tool | 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`-keys: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (arrays van strings; elke ingestelde key moet matchen), plus `params`.

**Regels voor queryparameters.** `when.params` is een array van maximaal 10 regels voor de querystring van de bezoeker; aan elke regel moet worden voldaan: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` is een door `|` gescheiden lijst) | `exists` | `missing` (geen `value` voor de laatste twee). Keys zijn hoofdlettergevoelig, waarden worden exact vergeleken. Parameterwaarden worden nooit opgeslagen in analytics.

**Queryparameters doorsturen.** `forwardParams` (boolean op `links_create` / `links_update`, standaard `false`) plakt de volledige querystring van de bezoeker achter URL-varianten; waarden van de bezoeker overschrijven opgeslagen waarden, `utm` inbegrepen. Alleen voor URL-varianten. Dit is routing, geen toegangscontrole.

`auth create` / `auth login` / `auth logout` zijn geen MCP-tools. Mapping: [api.md](https://linkdash.dev/api.md).
