MCP
Udaljeni MCP na https://api.linkdash.dev/mcp. Prijavite se putem OAuth-a iz Claudea, ChatGPT-a, Cursora i Codexa ili upotrijebite API ključ.
Udaljeni MCP na https://api.linkdash.dev/mcp. Dodajte URL u svoj klijent i prijavite se svojim Linkdash računom. Za agente koji rade bez osobe za preglednikom umjesto toga upotrijebite API ključ. Čisti markdown: mcp.md.
Povezivanje
Klijentu navedite samo URL https://api.linkdash.dev/mcp. Klijent otvara prijavu u Linkdash, a zatim zaslon za privolu na kojem su navedeni aplikacija i web-mjesto na koje se vraća. Dopustite pristup i klijent dobiva token za vaš račun.
- claude.ai i Claude Desktop: otvorite Linkdash u direktoriju konektora (ili Customize → Connectors i potražite Linkdash) i kliknite Connect.
- ChatGPT: unos u direktoriju dodataka ChatGPT-a uskoro stiže. Do tada u Plugins odaberite + → Add custom MCP server, unesite gornji URL i odaberite OAuth.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, zatimclaude mcp login linkdash(ili/mcpunutar sesije). - Cursor: Dodaj u Cursor ga instalira jednim klikom, a zatim se prijavite kada to Cursor zatraži. Ili dodajte poslužitelj u
mcp.jsons"url"i bezheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, zatimcodex mcp login linkdash.
Aplikacija dobiva isti pristup kao API ključ. Povezane aplikacije navedene su pod Nadzorna ploča → API ključevi, gdje ih Odspoji odmah opoziva.
Automatizacija i agenti bez sučelja
Za prijavu je potrebna osoba za preglednikom. Za CI poslove, zakazane agente, poslužitelje i kôd koji izravno poziva MCP umjesto toga pošaljite API ključ: Authorization: Bearer ldash_..., iste ključeve kao za HTTP API.
Cursor (~/.cursor/mcp.json ili .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 zahtijeva "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: Convex .site URL + /mcp.
Datoteke
Ne šaljite bajtove kroz MCP JSON. Generirajte URL ({uploadUrl,storageId}), datoteku pošaljite PUT zahtjevom s hosta, a zatim stvorite poveznicu:
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 alati: files_upload_url vraća {uploadUrl,storageId} → host šalje PUT na uploadUrl → links_create s tim storageId. Neobavezna kartica pregleda: previewName, previewDescription, previewImageStorageId (isti postupak prijenosa). Neobavezni maxOpenings pauzira poveznicu nakon toliko otvaranja; links_update može povećati tu vrijednost ili proslijediti clearMaxOpenings. Ne ispisujte uploadUrl korisniku.
Alati
| 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-a) |
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 ili editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → cilj; otključava varijantu zaštićenu lozinkom za urednika na 30 minuta |
|
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 šalje PUT nakon generiranja URL-a) | 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 poveznica koja navodi stavke koje u nju stavite. Za model pogledajte Mape.
| Alat | Ulaz |
|---|---|
links_create |
{ kind: "folder", name, … } stvara mapu; svako stvaranje prima folder (slug) i folderDomain? za stvaranje unutar mape. Odgovor uključuje folder |
links_list |
Jedna stranica, { items, cursor } (limit 1-100, zadano 50; vraćajte cursor dok ne postane null). q traži podudaranje riječi; folder: "<slug>" navodi ono što se nalazi izravno unutra; folder: "root" navodi najvišu razinu; kind dodaje folder. Retci sadrže folder, a retci mapa sadrže items |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (isti pristup, novi URL za dijeljenje, bez osoba) |
links_delete |
contents?: "keep" | "delete" za mape (zadano keep) |
links_export / links_import dodaju stupce folder i access, a retci s kind folder stvaraju mape.
Pristup i dijeljenje
Nove poveznice i mape su ograničene: url je https://linkdash.dev/s/<token>, a mogu ga otvoriti samo vi i osobe s kojima ga dijelite. Proslijedite access u links_create ili links_update: restricted (zadano), link (svatko s URL-om za dijeljenje) ili public (svatko, na kratkom URL-u). Zatražite access: "public" kada će poveznica biti javno objavljena. Pogledajte Dijeljenje i pristup.
| Alat | Ulaz |
|---|---|
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 stranica svega što ste podijelili, { items, cursor }, svaka stavka s people |
links_shared |
{ limit?, cursor? } → jedna stranica stavki koje su drugi podijelili s vama, { items, cursor }, s url za otvaranje svake stavke |
links_leave |
{ id } (_id ili URL za dijeljenje iz links_shared) → { _id, left: true } |
links_update |
access? mijenja tko je može otvoriti; resetShareLink: true izdaje novi URL za dijeljenje (stari prestaje raditi) |
Svaki url u odgovoru je URL za dijeljenje, osim ako je poveznica javna, kada je to kratki URL. Dijeljenje, prestanak dijeljenja, promjene pristupa i resetiranja broje se kao po jedan događaj; napuštanje se ne broji.
Varijante
Svaka poveznica je spremnik jedne ili više varijanti: sadržaj (url | file | text) plus vlastita zaštita (password, starts, expires, maxOpenings, pauzirano), weight i neobavezni uvjeti za posjetitelje when. Bez variants poveznica ima jednu varijantu nazvanu main. Zaštita poveznice ima prednost pred zaštitama varijanti. Posjetitelj dobiva jednu varijantu: varijante čiji se when podudara čine skup (inače one bezuvjetne), a zatim slijedi ponderirani odabir; sticky (zadano true) zadržava posjetitelja koji se vraća na istoj varijanti, a restartSplit ponovno miješa raspodjelu. kind poveznice je group kada ima više varijanti; status poveznice je mixed kada se varijante razlikuju. Najviše 20 varijanti po poveznici. Oblici: HTTP API.
links_create umjesto skraćenog oblika prima variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], plus sticky i forwardParams. links_update prima sticky, forwardParams i restartSplit. links_list filtrira po kind (dodaje group) i status (dodaje mixed). links_stats vraća ukupne vrijednosti za variants. links_export / links_import koriste CSV varijanti (jedan redak po varijanti).
| Alat | Ulaz |
|---|---|
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čevi za when: countries, devices, os, browsers, languages, referrerHosts (nizovi stringova; svaki postavljeni ključ mora se podudarati), plus params.
Pravila za parametre upita. when.params je niz od najviše 10 pravila nad nizom upita (query string) posjetitelja; svako pravilo mora biti zadovoljeno: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value je popis odvojen znakom |) | exists | missing (bez value za posljednja dva). Ključevi razlikuju velika i mala slova, a vrijednosti se uspoređuju točno. Vrijednosti parametara nikada se ne pohranjuju u analitici.
Prosljeđivanje parametara upita. forwardParams (boolean u links_create / links_update, zadano false) dodaje cijeli niz upita posjetitelja URL varijantama; vrijednosti posjetitelja nadjačavaju pohranjene, uključujući utm. Samo za URL varijante. Služi za usmjeravanje, a ne za kontrolu pristupa.
auth create / auth login / auth logout nisu MCP alati. Mapiranje: api.md.

