Spring til indhold
LinkdashLinkdash
Dansk
Esc
↑↓navigér↵åbn⌘Jforhåndsvis
På denne side

MCP

Remote MCP på https://api.linkdash.dev/mcp. Log ind med OAuth fra Claude, ChatGPT, Cursor og Codex, eller brug en API-nøgle.

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. Ren markdown: 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 (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 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 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, 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: Authorization: Bearer ldash_.... Det er de samme nøgler som til HTTP API’et.

Cursor (~/.cursor/mcp.json eller .cursor/mcp.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:

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, 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.

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.

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.

Var denne side nyttig?