MCP
Vzdálený MCP server na https://api.linkdash.dev/mcp. Přihlaste se přes OAuth z Claude, ChatGPT, Cursoru a Codexu, nebo použijte klíč API.
Vzdálený MCP server je na adrese https://api.linkdash.dev/mcp. Přidejte tuto URL do svého klienta a přihlaste se účtem Linkdash. Pro agenty, u kterých nesedí člověk u prohlížeče, použijte místo toho klíč API. Čistý markdown: mcp.md.
Připojení
Klientovi zadejte pouze URL https://api.linkdash.dev/mcp. Klient otevře přihlášení do Linkdash a poté obrazovku se souhlasem, na které uvidíte název aplikace a web, na který se po přihlášení vrátí. Po povolení získá klient token k vašemu účtu.
- claude.ai a Claude Desktop: otevřete Linkdash v adresáři konektorů (nebo Customize → Connectors a vyhledejte Linkdash) a klikněte na Connect.
- ChatGPT: záznam v adresáři pluginů ChatGPT brzy přibude. Do té doby v Plugins zvolte + → Add custom MCP server, zadejte výše uvedenou URL a zvolte OAuth.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, potéclaude mcp login linkdash(nebo/mcpv relaci). - Cursor: Add to Cursor server nainstaluje jedním kliknutím, poté se přihlaste, až vás o to Cursor požádá. Případně přidejte server do
mcp.jsons"url"a bezheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, potécodex mcp login linkdash.
Aplikace získá stejný přístup jako klíč API. Připojené aplikace najdete v Dashboard → API klíče, kde je tlačítkem Odpojit okamžitě odvoláte.
Automatizace a agenti bez rozhraní
Přihlášení vyžaduje člověka u prohlížeče. Pro úlohy CI, plánované agenty, servery a kód, který volá MCP přímo, místo toho posílejte klíč API: Authorization: Bearer ldash_..., tedy stejné klíče jako pro HTTP API.
Cursor (~/.cursor/mcp.json nebo .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 vyžaduje "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"
Lokálně: URL .site z Convexu + /mcp.
Soubory
Neposílejte bajty přes JSON MCP. Vygenerujte URL ({uploadUrl,storageId}), nahrajte soubor z hostitele metodou PUT a poté vytvořte odkaz:
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}'
Nástroje MCP: files_upload_url vrátí {uploadUrl,storageId} → hostitel nahraje soubor metodou PUT na uploadUrl → links_create s tímto storageId. Volitelná karta náhledu: previewName, previewDescription, previewImageStorageId (stejné nahrávání). Volitelný parametr maxOpenings odkaz pozastaví po daném počtu otevření; links_update může limit zvýšit nebo předat clearMaxOpenings. uploadUrl uživateli nevypisujte.
Nástroje
| 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 (bez id) |
GET /shares |
links_shares (bez 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 nebo editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → cíl; odemkne editorovi variantu chráněnou heslem na 30 minut |
|
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 |
| (PUT z hostitele po vygenerování URL) | 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_* |
Složky
Složka je odkaz, který zobrazuje položky, které do ní vložíte. Popis modelu najdete v části Složky.
| Nástroj | Vstup |
|---|---|
links_create |
{ kind: "folder", name, … } vytvoří složku; každé vytvoření přijímá folder (slug) a folderDomain? pro vytvoření uvnitř složky. Odpověď obsahuje folder |
links_list |
Jedna stránka, { items, cursor } (limit 1–100, výchozí 50; předávejte cursor zpět, dokud nebude null). q hledá slova; folder: "<slug>" vypíše přímý obsah složky; folder: "root" vypíše nejvyšší úroveň; kind přidává folder. Řádky obsahují folder a řádky složek obsahují items |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (stejný přístup, nová URL pro sdílení, bez lidí) |
links_delete |
contents?: "keep" | "delete" pro složky (výchozí keep) |
links_export / links_import přidávají sloupce folder a access a řádky s kind folder vytvářejí složky.
Přístup a sdílení
Nové odkazy a složky jsou omezené: url je https://linkdash.dev/s/<token>, který můžete otevřít jen vy a lidé, se kterými jej sdílíte. Na links_create nebo links_update předejte access: restricted (výchozí), link (kdokoli s URL pro sdílení) nebo public (kdokoli, přes krátkou URL). Pokud bude odkaz zveřejněn, požádejte o access: "public". Viz Sdílení a přístup.
| Nástroj | Vstup |
|---|---|
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? } → jedna stránka všeho, co sdílíte, { items, cursor }, každá položka s people |
links_shared |
{ limit?, cursor? } → jedna stránka položek, které s vámi sdíleli jiní lidé, { items, cursor }, s url pro otevření každé z nich |
links_leave |
{ id } (_id nebo URL pro sdílení z links_shared) → { _id, left: true } |
links_update |
access? mění, kdo může odkaz otevřít; resetShareLink: true vydá novou URL pro sdílení (stará přestane fungovat) |
Každá url v odpovědi je URL pro sdílení, pokud odkaz není veřejný; u veřejného odkazu je to krátká URL. Sdílení, zrušení sdílení, změny přístupu a resety se každé počítají jako jedna událost; opuštění nikoli.
Varianty
Každý odkaz je kontejnerem jedné nebo více variant: obsah (url | file | text) plus vlastní brána (password, starts, expires, maxOpenings, pozastavení), weight a volitelné podmínky návštěvníka when. Bez variants má odkaz jednu variantu s názvem main. Brána odkazu má přednost před branami variant. Návštěvník dostane jednu variantu: varianty, jejichž when odpovídá, tvoří fond (jinak varianty bez podmínek), z něhož se pak vybírá podle vah; sticky (výchozí true) ponechá vracejícího se návštěvníka na stejné variantě a restartSplit rozdělení přeskupí. kind odkazu je group u více variant; status odkazu je mixed, když se varianty liší. Maximálně 20 variant na odkaz. Struktury: HTTP API.
links_create přijímá místo zkrácené podoby variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], a dále sticky a forwardParams. links_update přijímá sticky, forwardParams a restartSplit. links_list filtruje kind (přidává group) a status (přidává mixed). links_stats vrací součty variants. links_export / links_import používají CSV variant (jeden řádek na variantu).
| Nástroj | Vstup |
|---|---|
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? } |
Klíče when: countries, devices, os, browsers, languages, referrerHosts (pole řetězců; každý nastavený klíč musí odpovídat), plus params.
Pravidla parametrů dotazu. when.params je pole až 10 pravidel pro řetězec dotazu návštěvníka, přičemž musí platit všechna pravidla: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value je seznam oddělený znakem |) | exists | missing (u posledních dvou bez value). Klíče rozlišují velikost písmen, hodnoty se porovnávají přesně. Hodnoty parametrů se v analytice nikdy neukládají.
Předávání parametrů dotazu. forwardParams (boolean na links_create / links_update, výchozí false) připojí k URL variantám celý řetězec dotazu návštěvníka; hodnoty návštěvníka přepíší uložené hodnoty, včetně utm. Pouze pro URL varianty. Jde o směrování, nikoli o řízení přístupu.
auth create / auth login / auth logout nejsou nástroje MCP. Mapování: api.md.

