Skip to content
LinkdashLinkdash
Eesti
Esc
↑↓navigate↵open⌘Jpreview
On this page

MCP

Kaug-MCP aadressil https://api.linkdash.dev/mcp. Logi Claude'ist, ChatGPT-st, Cursorist ja Codexist sisse OAuthiga või kasuta API-võtit.

Kaug-MCP asub aadressil https://api.linkdash.dev/mcp. Lisa URL oma klienti ja logi sisse oma Linkdashi kontoga. Kui agent töötab ilma, et keegi brauseri taga oleks, kasuta selle asemel API-võtit. Lihtne markdown: mcp.md.

Ühendamine

Anna kliendile ainult URL https://api.linkdash.dev/mcp. Klient avab Linkdashi sisselogimise ja siis nõusolekuekraani. Sellel on näha rakenduse nimi ja sait, kuhu sind tagasi suunatakse. Kui lubad, saab klient sinu konto jaoks tokeni.

  • claude.ai ja Claude Desktop: ava Linkdash konnektorite kataloogis (või vali Customize → Connectors ja otsi Linkdashi) ning klõpsa Connect.
  • ChatGPT: Linkdash tuleb peagi ka ChatGPT pluginate kataloogi. Seni ava Plugins, vali + → Add custom MCP server, sisesta ülaltoodud URL ja vali OAuth.
  • Claude Code: claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, seejärel claude mcp login linkdash (või sessioonis /mcp).
  • Cursor: Lisa Cursorisse paigaldab serveri ühe klõpsuga. Kui Cursor küsib, logi sisse. Teine võimalus on lisada server faili mcp.json, kus on "url", aga headers puudub.
  • Codex: codex mcp add linkdash --url https://api.linkdash.dev/mcp, seejärel codex mcp login linkdash.

Rakendus saab samasuguse ligipääsu nagu API-võti. Ühendatud rakendused on loetletud lehel Töölaud → API-võtmed. Seal saad nupuga Ühenda lahti nende ligipääsu kohe tühistada.

Automatiseerimine ja peata agendid

Sisselogimiseks peab keegi brauseri taga olema. CI-tööde, ajastatud agentide, serverite ja otse MCP-d kutsuva koodi jaoks saada selle asemel API-võti: Authorization: Bearer ldash_.... Need on samad võtmed, mida kasutab HTTP API.

Cursor (~/.cursor/mcp.json või .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-is on vaja "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"

Lokaalselt: Convexi .site URL + /mcp.

Failid

Ära saada faili baite MCP JSON-iga. Loo üleslaadimise URL ({uploadUrl,storageId}), saada fail hostist PUT-päringuga ja seejärel loo link:

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 tööriistad: files_upload_url tagastab {uploadUrl,storageId} → host saadab faili PUT-päringuga aadressile uploadUrl → links_create saab selle storageId. Valikuline eelvaatekaart: previewName, previewDescription, previewImageStorageId (pilt laaditakse üles samal viisil). Valikulise maxOpenings puhul peatatakse link pärast nii mitut avamist. links_update saab piirangut suurendada või selle clearMaxOpenings abil eemaldada. Ära näita uploadUrl-i kasutajale.

Tööriistad

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 (ilma id-ta) GET /shares links_shares (ilma id-ta)
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 või editor)
links_unlock { id, variant?, password?, variantPassword? } → sihtkoht; avab parooliga kaitstud variandi muutjale 30 minutiks
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 teeb PUT-päringu pärast URL-i loomist) 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_*

Kaustad

Kaust on link, mis näitab nimekirja sinna pandud üksustest. Mudeli kohta loe lähemalt lehelt Kaustad.

Tööriist Sisend
links_create { kind: "folder", name, … } loob kausta. Iga loomiskutse võtab vastu ka folder (slug) ja folderDomain?, kui tahad üksuse luua kausta sisse. Vastuses on folder
links_list Tagastab ühe lehekülje kujul { items, cursor } (limit 1-100, vaikimisi 50). Saada cursor tagasi, kuni see on null. q otsib sõnade järgi. folder: "<slug>" näitab, mis on otse selle kausta sees, ja folder: "root" näitab ülemist taset. kind lubab ka väärtust folder. Igal real on folder ja kaustaridadel ka items
links_move { id, domain?, folder: string | null, folderDomain? } → { id, folder }
links_copy { id, domain? } → { id, url, access, kind, folder } (sama ligipääs, uus jagamis-URL, ilma jagatud inimesteta)
links_delete Kaustade puhul contents?: "keep" | "delete" (vaikimisi keep)

links_export / links_import lisavad veerud folder ja access. Read, kus kind on folder, loovad kaustu.

Ligipääs ja jagamine

Uued lingid ja kaustad on vaikimisi piiratud: url on https://linkdash.dev/s/<token> ja seda saad avada ainult sina ja inimesed, kellega oled selle jaganud. Ligipääsu muutmiseks anna links_create või links_update kutses access: restricted (vaikimisi), link (igaüks, kellel on jagamis-URL) või public (igaüks, lühi-URL-i kaudu). Kui link postitatakse avalikult, küsi access: "public". Loe lähemalt lehelt Jagamine ja ligipääs.

Tööriist Sisend
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? } tagastab ühe lehekülje kõigest, mida oled jaganud, kujul { items, cursor }, ja igal üksusel on people
links_shared { limit?, cursor? } tagastab ühe lehekülje üksustest, mida teised on sinuga jaganud, kujul { items, cursor }. Igal üksusel on url, millega seda avada
links_leave { id } (_id või jagamis-URL links_shared vastusest) → { _id, left: true }
links_update access? muudab, kes saab üksust avada. resetShareLink: true loob uue jagamis-URL-i ja vana lakkab töötamast

Vastuses olev url on alati jagamis-URL, välja arvatud avaliku lingi puhul: siis on see lühi-URL. Jagamine, jagamise lõpetamine, ligipääsu muutmine ja lingi lähtestamine loetakse igaüks üheks sündmuseks. Lahkumist sündmuseks ei loeta.

Variandid

Iga link sisaldab ühte või mitut varianti. Variandil on sisu (url | file | text), oma värav (password, starts, expires, maxOpenings, peatatud olek), weight ja valikulised külastaja tingimused when. Kui variants puudub, on lingil üks variant nimega main. Kui lingi ja variandi väravad lähevad vastuollu, kehtib lingi värav. Külastaja saab ühe variandi. Kõigepealt kogutakse kokku variandid, mille when sobib (kui ükski ei sobi, siis tingimusteta variandid), ja nende seast valitakse üks kaalude järgi. sticky (vaikimisi true) hoiab tagasi tulnud külastaja samal variandil ja restartSplit jagab külastajad uuesti. Kui variante on mitu, on lingi kind väärtusega group. Kui variantide olekud erinevad, on lingi status väärtusega mixed. Ühel lingil saab olla kuni 20 varianti. Andmekujud leiad siit: HTTP API.

Lühivormi asemel võtab links_create vastu variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }] ning lisaks sticky ja forwardParams. links_update võtab vastu sticky, forwardParams ja restartSplit. links_list filtreerib kind (lubab ka group) ja status (lubab ka mixed) järgi. links_stats tagastab variants kogusummad. links_export / links_import kasutavad variantide CSV-d, kus iga variant on eraldi real.

when võtmed on countries, devices, os, browsers, languages ja referrerHosts (sõnede massiivid; iga määratud võti peab sobima) ning lisaks params.

Päringuparameetrite reeglid. when.params on kuni 10 reeglist koosnev massiiv, mis kontrollib külastaja päringustringi. Kõik reeglid peavad kehtima: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value on |-ga eraldatud loend) | exists | missing (kahe viimasega value ei anta). Võtmetes on suur- ja väiketähed erinevad ning väärtusi võrreldakse täpselt. Parameetrite väärtusi analüütikasse ei salvestata.

Päringuparameetrite edasisaatmine. forwardParams on tõeväärtus, mille saad anda links_create / links_update kutses (vaikimisi false). See lisab URL-variantidele külastaja kogu päringustringi. Külastaja väärtused kirjutavad salvestatud väärtused üle, ka utm. See töötab ainult URL-variantidega. Parameetrid mõjutavad ainult suunamist, mitte ligipääsu.

auth create / auth login / auth logout ei ole MCP tööriistad. Vastavustabel: api.md.

Was this page helpful?