MCP
Vzdialený MCP server na https://api.linkdash.dev/mcp. Prihláste sa cez OAuth z Claude, ChatGPT, Cursor a Codex alebo použite API kľúč.
Vzdialený MCP server na https://api.linkdash.dev/mcp. Pridajte URL do svojho klienta a prihláste sa svojím účtom Linkdash. Pre agentov, ktorí bežia bez človeka pri prehliadači, použite namiesto toho API kľúč. Čistý markdown: mcp.md.
Pripojenie
Klientovi zadajte iba URL https://api.linkdash.dev/mcp. Klient otvorí prihlásenie do Linkdash. Potom zobrazí obrazovku so súhlasom, na ktorej je uvedený názov aplikácie a stránka, na ktorú sa vráti. Ak to povolíte, klient získa token pre váš účet.
- claude.ai a Claude Desktop: otvorte Linkdash v adresári konektorov (alebo Customize → Connectors a vyhľadajte Linkdash) a kliknite na Connect.
- ChatGPT: Linkdash čoskoro pribudne v adresári pluginov ChatGPT. Dovtedy v Plugins zvoľte + → Add custom MCP server, zadajte URL uvedenú vyššie a zvoľte OAuth.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, potomclaude mcp login linkdash(alebo/mcpv relácii). - Cursor: Add to Cursor ho nainštaluje jedným kliknutím. Potom sa prihláste, keď vás Cursor vyzve. Prípadne pridajte server do
mcp.jsons"url"a bezheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, potomcodex mcp login linkdash.
Aplikácia získa rovnaký prístup ako API kľúč. Pripojené aplikácie nájdete v Ovládací panel → API kľúče. Tlačidlo Odpojiť im tam prístup okamžite odoberie.
Automatizácia a agenti bez rozhrania
Prihlásenie vyžaduje človeka pri prehliadači. Pre úlohy CI, plánovaných agentov, servery a kód, ktorý volá MCP priamo, posielajte namiesto toho API kľúč: Authorization: Bearer ldash_.... Sú to rovnaké kľúče ako pre HTTP API.
Cursor (~/.cursor/mcp.json alebo .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álne: Convex .site URL + /mcp.
Súbory
Neposielajte bajty cez MCP JSON. Vygenerujte URL ({uploadUrl,storageId}), nahrajte súbor z hostiteľa metódou PUT a potom vytvorte 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áti {uploadUrl,storageId} → hostiteľ odošle súbor metódou PUT na uploadUrl → links_create s týmto storageId. Voliteľná náhľadová karta: previewName, previewDescription, previewImageStorageId (rovnaký postup nahrávania). Voliteľný parameter maxOpenings pozastaví odkaz po zadanom počte otvorení. Pomocou links_update ho môžete zvýšiť alebo odovzdať clearMaxOpenings. Nezobrazujte uploadUrl používateľovi.
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 alebo editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → cieľ; odomkne variant chránený heslom pre editora na 30 minút |
|
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 hostiteľa po vygenerovaní 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_* |
Priečinky
Priečinok je odkaz, ktorý zobrazuje položky, ktoré doň vložíte. Ako priečinky fungujú, sa dozviete v časti Priečinky.
| Nástroj | Vstup |
|---|---|
links_create |
{ kind: "folder", name, … } vytvorí priečinok. Každé vytvorenie prijíma folder (slug) a folderDomain? na vytvorenie položky v priečinku. Odpoveď obsahuje folder |
links_list |
Jedna stránka, { items, cursor } (limit 1-100, predvolene 50; cursor odovzdávajte späť, kým nebude null). q vyhľadáva podľa slov; folder: "<slug>" zobrazí položky priamo v priečinku; folder: "root" zobrazí najvyššiu úroveň; kind pridáva hodnotu folder. Riadky obsahujú folder a riadky priečinkov obsahujú items |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (rovnaký prístup, nová URL na zdieľanie, bez zdieľaných osôb) |
links_delete |
contents?: "keep" | "delete" pre priečinky (predvolene keep) |
links_export / links_import pridávajú stĺpce folder a access a riadky s kind folder vytvárajú priečinky.
Prístup a zdieľanie
Nové odkazy a priečinky majú obmedzený prístup: url je https://linkdash.dev/s/<token> a otvoriť ju môžete iba vy a ľudia, s ktorými ju zdieľate. V links_create alebo links_update odovzdajte access: restricted (predvolené), link (ktokoľvek s URL na zdieľanie) alebo public (ktokoľvek cez krátku URL). Ak bude odkaz zverejnený, nastavte access: "public". Pozrite si Zdieľanie a prí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šetkého, čo ste zdieľali, { items, cursor }, každá položka s people |
links_shared |
{ limit?, cursor? } → jedna stránka položiek, ktoré s vami zdieľali iní ľudia, { items, cursor }, s url na otvorenie každej z nich |
links_leave |
{ id } (_id alebo URL na zdieľanie z links_shared) → { _id, left: true } |
links_update |
access? mení, kto ho môže otvoriť; resetShareLink: true vydá novú URL na zdieľanie (stará prestane fungovať) |
Každá url v odpovedi je URL na zdieľanie. Ak je odkaz verejný, je to krátka URL. Zdieľanie, zrušenie zdieľania, zmena prístupu a reset sa počítajú ako jedna udalosť; opustenie zdieľania sa nepočíta.
Varianty
Každý odkaz obsahuje jeden alebo viac variantov. Variant tvorí obsah (url | file | text), vlastné obmedzenia prístupu (password, starts, expires, maxOpenings, pozastavenie), weight a voliteľné podmienky pre návštevníka when. Bez variants má odkaz jeden variant s názvom main. Obmedzenia prístupu odkazu majú prednosť pred obmedzeniami variantov. Návštevník dostane jeden variant. Kandidátmi sú varianty, ktorých when vyhovuje (inak varianty bez podmienok). Z nich sa variant vyberie náhodne podľa váhy. sticky (predvolene true) ponechá vracajúcemu sa návštevníkovi rovnaký variant a restartSplit rozdelenie premieša nanovo. kind odkazu je group, ak má viacero variantov; status odkazu je mixed, keď sa stavy variantov líšia. Odkaz môže mať najviac 20 variantov. Štruktúry: HTTP API.
links_create prijíma namiesto skráteného zápisu variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], ďalej sticky a forwardParams. links_update prijíma sticky, forwardParams a restartSplit. links_list filtruje podľa kind (pribudne group) a status (pribudne mixed). links_stats vracia súhrny variants. links_export / links_import používajú CSV s variantmi (jeden riadok na variant).
| 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? } |
Kľúče when: countries, devices, os, browsers, languages, referrerHosts (polia reťazcov; každý nastavený kľúč musí vyhovovať), plus params.
Pravidlá pre parametre dotazu. when.params je pole s najviac 10 pravidlami pre query string návštevníka. Musia platiť všetky pravidlá: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value je zoznam oddelený znakom |) | exists | missing (posledné dva nemajú value). Kľúče rozlišujú veľké a malé písmená a hodnoty sa porovnávajú presne. Hodnoty parametrov sa nikdy neukladajú do analytiky.
Preposielanie parametrov dotazu. forwardParams (boolean v links_create / links_update, predvolene false) pripojí celý query string návštevníka k URL variantom. Hodnoty návštevníka prepíšu uložené hodnoty vrátane utm. Platí iba pre URL varianty. Ide o smerovanie, nie o riadenie prístupu.
auth create / auth login / auth logout nie sú nástroje MCP. Mapovanie: api.md.

