Naar inhoud springen
LinkdashLinkdash
Nederlands
Esc
↑↓navigeren↵openen⌘Jvoorbeeld
Op deze pagina

MCP

Remote MCP op https://api.linkdash.dev/mcp. Log in met OAuth vanuit Claude, ChatGPT, Cursor en Codex, of gebruik een API-key.

Remote MCP op https://api.linkdash.dev/mcp. Voeg de URL toe aan je client en log in met je Linkdash-account. Voor agents die draaien zonder dat er iemand achter een browser zit, gebruik je in plaats daarvan een API-key. Platte markdown: mcp.md.

Verbinden

Geef de client alleen de URL https://api.linkdash.dev/mcp. Die opent een Linkdash-login en daarna een toestemmingsscherm dat de app noemt en de site waar je naar terugkeert. Sta het toe, en de client krijgt een token voor je account.

  • claude.ai en Claude Desktop: open Linkdash in de connectordirectory (of Customize → Connectors en zoek op Linkdash) en klik op Connect.
  • ChatGPT: een vermelding in de ChatGPT-plugindirectory komt binnenkort. Tot die tijd kies je in Plugins + → Add custom MCP server, vul je de URL hierboven in en kies je OAuth.
  • Claude Code: claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, daarna claude mcp login linkdash (of /mcp in een sessie).
  • Cursor: Add to Cursor installeert het met één klik; log daarna in wanneer Cursor erom vraagt. Of voeg de server toe aan mcp.json met "url" en zonder headers.
  • Codex: codex mcp add linkdash --url https://api.linkdash.dev/mcp, daarna codex mcp login linkdash.

De app krijgt dezelfde toegang als een API-key. Verbonden apps staan onder Dashboard → API-sleutels, waar je met Ontkoppelen de toegang direct intrekt.

Automatisering en headless agents

Inloggen vereist iemand achter een browser. Voor CI-jobs, geplande agents, servers en code die MCP rechtstreeks aanroept, stuur je in plaats daarvan een API-key mee: Authorization: Bearer ldash_..., dezelfde keys als voor de HTTP API.

Cursor (~/.cursor/mcp.json of .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 heeft "type": "http" nodig).

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"

Lokaal: Convex-.site-URL + /mcp.

Bestanden

Stuur geen bytes via MCP-JSON. Maak een URL aan ({uploadUrl,storageId}), PUT het bestand vanaf de host en maak daarna de link aan:

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-tools: files_upload_url geeft {uploadUrl,storageId} terug → de host doet een PUT naar uploadUrl → links_create met die storageId. Optionele unfurl-kaart: previewName, previewDescription, previewImageStorageId (zelfde upload). Met de optionele maxOpenings wordt de link gepauzeerd na dat aantal keer openen; links_update kan dit verhogen of clearMaxOpenings meegeven. Toon uploadUrl niet aan de gebruiker.

Tools

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 (zonder id) GET /shares links_shares (zonder 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 of editor)
links_unlock { id, variant?, password?, variantPassword? } → het doel; ontgrendelt een met een wachtwoord beveiligde variant voor een editor voor 30 minuten
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
(host doet PUT na aanmaken) 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_*

Mappen

Een map is een link die de items toont die je erin zet. Zie Mappen voor het model.

Tool Input
links_create { kind: "folder", name, … } maakt een map aan; elke create accepteert folder (slug) en folderDomain? om iets in een map aan te maken. De response bevat folder
links_list Eén pagina, { items, cursor } (limit 1-100, standaard 50; geef cursor steeds terug tot die null is). q matcht woorden; folder: "<slug>" toont wat er direct in staat; folder: "root" toont het hoogste niveau; kind krijgt er folder bij. Rijen bevatten folder, en maprijen bevatten items
links_move { id, domain?, folder: string | null, folderDomain? } → { id, folder }
links_copy { id, domain? } → { id, url, access, kind, folder } (zelfde toegang, nieuwe share-URL, geen personen)
links_delete contents?: "keep" | "delete" voor mappen (standaard keep)

links_export / links_import voegen de kolommen folder en access toe, en rijen met kind folder maken mappen aan.

Toegang en delen

Nieuwe links en mappen zijn afgeschermd: url is https://linkdash.dev/s/<token>, die alleen jij en de mensen met wie je deelt kunnen openen. Geef access mee bij links_create of links_update: restricted (standaard), link (iedereen met de share-URL) of public (iedereen, via de korte URL). Vraag om access: "public" als de link openbaar gepost gaat worden. Zie Delen en toegang.

Tool 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 pagina met alles wat jij hebt gedeeld, { items, cursor }, elk met people
links_shared { limit?, cursor? } → één pagina met items die anderen met jou hebben gedeeld, { items, cursor }, met de url om elk item te openen
links_leave { id } (de _id of share-URL uit links_shared) → { _id, left: true }
links_update access? wijzigt wie het kan openen; resetShareLink: true geeft een nieuwe share-URL uit (de oude werkt dan niet meer)

Elke url in een response is de share-URL, tenzij de link openbaar is; dan is het de korte URL. Delen, delen intrekken, toegangswijzigingen en resets tellen elk als één event; een gedeeld item verlaten niet.

Varianten

Elke link is een container van een of meer varianten: content (url | file | text) plus een eigen gate (password, starts, expires, maxOpenings, gepauzeerd), een weight en optionele bezoekersvoorwaarden when. Zonder variants heeft een link één variant met de naam main. De gate van de link gaat boven die van de varianten. Een bezoeker krijgt één variant: varianten waarvan when matcht vormen de pool (anders de onvoorwaardelijke), daarna volgt een gewogen keuze; sticky (standaard true) houdt een terugkerende bezoeker op dezelfde variant en restartSplit schudt opnieuw. De kind van een link is group bij meerdere varianten; de status van een link is mixed als varianten verschillen. Maximaal 20 varianten per link. Structuren: HTTP API.

links_create accepteert variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }] in plaats van de verkorte vorm, plus sticky en forwardParams. links_update accepteert sticky, forwardParams en restartSplit. links_list filtert op kind (met group erbij) en status (met mixed erbij). links_stats geeft totalen per variants terug. links_export / links_import gebruiken de varianten-CSV (één rij per variant).

Tool 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-keys: countries, devices, os, browsers, languages, referrerHosts (arrays van strings; elke ingestelde key moet matchen), plus params.

Regels voor queryparameters. when.params is een array van maximaal 10 regels voor de querystring van de bezoeker; aan elke regel moet worden voldaan: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value is een door | gescheiden lijst) | exists | missing (geen value voor de laatste twee). Keys zijn hoofdlettergevoelig, waarden worden exact vergeleken. Parameterwaarden worden nooit opgeslagen in analytics.

Queryparameters doorsturen. forwardParams (boolean op links_create / links_update, standaard false) plakt de volledige querystring van de bezoeker achter URL-varianten; waarden van de bezoeker overschrijven opgeslagen waarden, utm inbegrepen. Alleen voor URL-varianten. Dit is routing, geen toegangscontrole.

auth create / auth login / auth logout zijn geen MCP-tools. Mapping: api.md.

Was deze pagina nuttig?