MCP
Oddaljeni MCP na https://api.linkdash.dev/mcp. Prijavite se z OAuth iz Claude, ChatGPT, Cursor in Codex ali uporabite ključ API.
Oddaljeni MCP na https://api.linkdash.dev/mcp. URL dodajte v svojega odjemalca in se prijavite s svojim računom Linkdash. Za agente, ki delujejo, ne da bi za brskalnikom sedela oseba, namesto tega uporabite ključ API. Navaden markdown: mcp.md.
Povezovanje
Odjemalcu podajte samo URL https://api.linkdash.dev/mcp. Odpre se prijava v Linkdash, nato pa zaslon za soglasje, ki navede aplikacijo in spletno mesto, na katerega se vrne. Dovolite dostop in odjemalec prejme žeton za vaš račun.
- claude.ai in Claude Desktop: odprite Linkdash v imeniku konektorjev (ali Customize → Connectors in poiščite Linkdash) ter kliknite Connect.
- ChatGPT: vnos v imeniku vtičnikov ChatGPT bo kmalu na voljo. Do takrat v Plugins izberite + → Add custom MCP server, vnesite zgornji URL in izberite OAuth.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, natoclaude mcp login linkdash(ali/mcpv seji). - Cursor: Add to Cursor ga namesti z enim klikom, nato se prijavite, ko vas Cursor pozove. Strežnik lahko dodate tudi v
mcp.jsonz"url"in brezheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, natocodex mcp login linkdash.
Aplikacija dobi enak dostop kot ključ API. Povezane aplikacije so navedene pod Nadzorna plošča → Ključi API, kjer jih z Odklopi takoj prekličete.
Avtomatizacija in agenti brez vmesnika
Prijava zahteva osebo za brskalnikom. Za opravila CI, načrtovane agente, strežnike in kodo, ki MCP kliče neposredno, namesto tega pošljite ključ API: Authorization: Bearer ldash_..., to so isti ključi kot pri HTTP API.
Cursor (~/.cursor/mcp.json ali .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 potrebuje "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"
Lokalno: URL Convex .site + /mcp.
Datoteke
Bajtov ne pošiljajte prek MCP JSON. Ustvarite URL ({uploadUrl,storageId}), datoteko z gostitelja naložite s PUT, nato ustvarite povezavo:
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}'
Orodja MCP: files_upload_url vrne {uploadUrl,storageId} → gostitelj izvede PUT na uploadUrl → links_create s tem storageId. Neobvezna kartica predogleda: previewName, previewDescription, previewImageStorageId (enak postopek nalaganja). Neobvezni maxOpenings povezavo zaustavi po določenem številu odpiranj; links_update ga lahko poviša ali poda clearMaxOpenings. uploadUrl uporabniku ne izpisujte.
Orodja
| 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 (brez id) |
GET /shares |
links_shares (brez 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 ali editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → cilj; urejevalcu za 30 minut odklene z geslom zaščiteno različico |
|
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 |
| (gostitelj izvede PUT po ustvarjenem URL-ju) | 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_* |
Mape
Mapa je povezava, ki navaja elemente, ki jih vanjo postavite. Model je opisan v razdelku Mape.
| Orodje | Vhod |
|---|---|
links_create |
{ kind: "folder", name, … } ustvari mapo; vsako ustvarjanje sprejme folder (slug) in folderDomain? za ustvarjanje znotraj mape. Odziv vključuje folder |
links_list |
Ena stran, { items, cursor } (limit 1-100, privzeto 50; cursor podajajte nazaj, dokler ni null). q išče ujemanje besed; folder: "<slug>" navede, kar je neposredno v mapi; folder: "root" navede najvišjo raven; kind doda folder. Vrstice vsebujejo folder, vrstice map pa items |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (enak dostop, nov URL za deljenje, brez oseb) |
links_delete |
contents?: "keep" | "delete" za mape (privzeto keep) |
links_export / links_import dodata stolpca folder in access, vrstice s kind folder pa ustvarijo mape.
Dostop in deljenje
Nove povezave in mape so omejene: url je https://linkdash.dev/s/<token>, ki ga lahko odprete le vi in osebe, s katerimi ga delite. Pri links_create ali links_update podajte access: restricted (privzeto), link (kdorkoli z URL-jem za deljenje) ali public (kdorkoli, na kratkem URL-ju). Zahtevajte access: "public", kadar bo povezava objavljena javno. Glejte Deljenje in dostop.
| Orodje | Vhod |
|---|---|
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? } → ena stran vsega, kar ste delili, { items, cursor }, vsak element s people |
links_shared |
{ limit?, cursor? } → ena stran elementov, ki so jih drugi delili z vami, { items, cursor }, z url za odpiranje vsakega |
links_leave |
{ id } (_id ali URL za deljenje iz links_shared) → { _id, left: true } |
links_update |
access? spremeni, kdo jo lahko odpre; resetShareLink: true izda nov URL za deljenje (stari preneha delovati) |
Vsak url v odzivu je URL za deljenje, razen če je povezava javna – takrat je to kratki URL. Deljenje, preklic deljenja, spremembe dostopa in ponastavitve štejejo vsak kot en dogodek; zapustitev ne.
Različice
Vsaka povezava je vsebnik ene ali več različic: vsebine (url | file | text) z lastnimi omejitvami dostopa (password, starts, expires, maxOpenings, zaustavitev), utežjo weight in neobveznimi pogoji za obiskovalce when. Brez variants ima povezava eno različico z imenom main. Omejitve dostopa povezave imajo prednost pred omejitvami različic. Obiskovalec dobi eno različico: različice, katerih when se ujema, tvorijo nabor (sicer ga tvorijo brezpogojne), nato sledi utežena izbira; sticky (privzeto true) obdrži obiskovalca, ki se vrne, na isti različici, restartSplit pa razdelitev premeša na novo. kind povezave je group, kadar ima več različic; status povezave je mixed, kadar se različice razlikujejo. Največ 20 različic na povezavo. Oblike: HTTP API.
links_create namesto skrajšane oblike sprejme variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], poleg tega pa še sticky in forwardParams. links_update sprejme sticky, forwardParams in restartSplit. links_list filtrira po kind (doda group) in status (doda mixed). links_stats vrne skupne vrednosti variants. links_export / links_import uporabljata CSV različic (ena vrstica na različico).
| Orodje | Vhod |
|---|---|
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? } |
Ključi when: countries, devices, os, browsers, languages, referrerHosts (polja nizov; ujemati se mora vsak nastavljeni ključ), poleg tega še params.
Pravila za parametre poizvedbe. when.params je polje z največ 10 pravili za niz poizvedbe obiskovalca, pri čemer morajo veljati vsa pravila: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value je seznam, ločen z |) | exists | missing (pri zadnjih dveh brez value). Ključi razlikujejo med velikimi in malimi črkami, vrednosti se primerjajo natančno. Vrednosti parametrov se v analitiki nikoli ne shranjujejo.
Posredovanje parametrov poizvedbe. forwardParams (logična vrednost pri links_create / links_update, privzeto false) različicam URL pripne celoten niz poizvedbe obiskovalca; vrednosti obiskovalca preglasijo shranjene, vključno z utm. Samo za različice URL. Gre za usmerjanje, ne za nadzor dostopa.
auth create / auth login / auth logout niso orodja MCP. Preslikava: api.md.

