Hoppa till innehåll
LinkdashLinkdash
Svenska
Esc
↑↓navigera↵öppna⌘Jförhandsvisa
På den här sidan

MCP

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.

Fjärr-MCP på https://api.linkdash.dev/mcp. Lägg till URL 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 i stället. Ren markdown: mcp.md.

Anslut

Ge klienten bara URL 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 (eller Customize → Connectors och sök efter Linkdash) och klicka på Connect.
  • ChatGPT: Linkdash kommer snart att finnas i ChatGPT plugin-katalog. Tills dess väljer du + → Add custom MCP server i Plugins, anger URL 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 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, 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: Authorization: Bearer ldash_.... Det är samma nycklar som för HTTP-API.

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

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 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 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) eller public (alla, via den korta URL). Använd access: "public" när länken ska publiceras offentligt. Se Delning och åtkomst.

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 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, utom när länken är publik. Då är det den korta URL. 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.

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

Var den här sidan till hjälp?