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, deretterclaude mcp login linkdash(eller/mcpi 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.jsonmed"url"og utenheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, derettercodex 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.

