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, daarnaclaude mcp login linkdash(of/mcpin 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.jsonmet"url"en zonderheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, daarnacodex 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.

