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, sedanclaude mcp login linkdash(eller/mcpi 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.jsonmed"url"och utanheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, sedancodex 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.

