Hopp til innhold
LinkdashLinkdash
Norsk
Esc
↑↓naviger↵åpne⌘Jforhåndsvis
På denne siden

MCP

Ekstern MCP på https://api.linkdash.dev/mcp. Logg inn med OAuth fra Claude, ChatGPT, Cursor og Codex, eller bruk en API-nøkkel.

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 i stedet. Ren markdown: 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 (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, 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 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. 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 i stedet: Authorization: Bearer ldash_.... Dette er de samme nøklene som brukes i 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" (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:

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

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.

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.

Var denne siden nyttig?