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

MCP

Nuotolinis MCP adresu https://api.linkdash.dev/mcp. Prisijunkite per OAuth iš Claude, ChatGPT, Cursor ir Codex arba naudokite API raktą.

Nuotolinis MCP adresu https://api.linkdash.dev/mcp. Įtraukite URL į savo klientą ir prisijunkite su Linkdash paskyra. Agentams, kurie veikia be žmogaus prie naršyklės, naudokite API raktą. Paprastas Markdown: mcp.md.

Prisijungimas

Klientui nurodykite tik URL https://api.linkdash.dev/mcp. Jis atvers Linkdash prisijungimo langą, o tada sutikimo ekraną. Jame nurodyta programa ir svetainė, į kurią bus grįžtama. Suteikite leidimą, ir klientas gaus jūsų paskyros prieigos raktą.

  • claude.ai ir Claude Desktop: atidarykite Linkdash jungčių kataloge (arba Customize → Connectors ir ieškokite Linkdash) ir spustelėkite Connect.
  • ChatGPT: įrašas ChatGPT papildinių kataloge netrukus pasirodys. Iki tol skiltyje Plugins pasirinkite + → Add custom MCP server, įveskite aukščiau nurodytą URL ir pasirinkite OAuth.
  • Claude Code: claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, tada claude mcp login linkdash (arba /mcp sesijoje).
  • Cursor: Pridėti prie Cursor įdiegia jį vienu spustelėjimu. Paskui prisijunkite, kai Cursor paprašys. Arba įtraukite serverį į mcp.json su "url" ir be headers.
  • Codex: codex mcp add linkdash --url https://api.linkdash.dev/mcp, tada codex mcp login linkdash.

Programa gauna tokią pačią prieigą kaip API raktas. Prijungtos programos rodomos skiltyje Valdymo skydelis → API raktai. Ten paspaudus Atjungti, jų prieiga iš karto atšaukiama.

Automatizavimas ir agentai be naršyklės

Prisijungti galima tik tada, kai prie naršyklės yra žmogus. CI užduotims, suplanuotiems agentams, serveriams ir kodui, kuris kviečia MCP tiesiogiai, siųskite API raktą: Authorization: Bearer ldash_.... Tai tie patys raktai kaip ir HTTP API.

Cursor (~/.cursor/mcp.json arba .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 konfigūracijai reikia "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"

Lokaliai: Convex .site URL + /mcp.

Failai

Nesiųskite baitų per MCP JSON. Sugeneruokite URL ({uploadUrl,storageId}), įkelkite failą PUT užklausa iš host aplinkos ir tada sukurkite nuorodą:

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 įrankiai: files_upload_url grąžina {uploadUrl,storageId} → host aplinka siunčia PUT į uploadUrl → links_create su tuo storageId. Neprivaloma peržiūros kortelė: previewName, previewDescription, previewImageStorageId (įkeliama tuo pačiu būdu). Neprivalomas maxOpenings pristabdo nuorodą po nurodyto atidarymų skaičiaus. links_update gali šią ribą padidinti arba perduoti clearMaxOpenings. Nerodykite uploadUrl naudotojui.

Įrankiai

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 (be id) GET /shares links_shares (be 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 arba editor)
links_unlock { id, variant?, password?, variantPassword? } → tikslas; redaktoriui 30 minučių atrakina slaptažodžiu apsaugotą variantą
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 PUT po URL sugeneravimo) 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_*

Aplankai

Aplankas yra nuoroda, kurioje pateikiami į ją įdėti elementai. Modelis aprašytas puslapyje Aplankai.

Įrankis Įvestis
links_create { kind: "folder", name, … } sukuria aplanką. Bet kuri kūrimo užklausa priima folder (slug) ir folderDomain?, kad elementas būtų sukurtas aplanko viduje. Atsakyme yra folder
links_list Vienas puslapis, { items, cursor } (limit 1-100, numatytoji reikšmė 50; perduokite cursor atgal, kol jis taps null). q ieško pagal žodžius; folder: "<slug>" pateikia tai, kas yra tiesiogiai aplanke; folder: "root" pateikia aukščiausią lygį; kind papildomas reikšme folder. Eilutėse yra folder, o aplankų eilutėse – items
links_move { id, domain?, folder: string | null, folderDomain? } → { id, folder }
links_copy { id, domain? } → { id, url, access, kind, folder } (ta pati prieiga, naujas bendrinimo URL, be bendrinimo žmonių)
links_delete contents?: "keep" | "delete" aplankams (numatytoji reikšmė keep)

links_export / links_import prideda stulpelius folder ir access, o eilutės, kuriose kind yra folder, sukuria aplankus.

Prieiga ir bendrinimas

Naujų nuorodų ir aplankų prieiga yra ribota: url yra https://linkdash.dev/s/<token>, ir jį gali atidaryti tik jūs bei žmonės, su kuriais bendrinate. Perduokite access per links_create arba links_update: restricted (numatytoji reikšmė), link (bet kas, turintis bendrinimo URL) arba public (bet kas, trumpuoju URL). Nurodykite access: "public", kai nuoroda bus skelbiama viešai. Žr. Bendrinimas ir prieiga.

Įrankis Įvestis
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? } → vienas puslapis su visais jūsų bendrinamais elementais, { items, cursor }, kiekvienas su people
links_shared { limit?, cursor? } → vienas puslapis elementų, kuriuos su jumis bendrino kiti žmonės, { items, cursor }, su kiekvieno elemento url jam atidaryti
links_leave { id } (_id arba bendrinimo URL iš links_shared) → { _id, left: true }
links_update access? keičia, kas gali atidaryti nuorodą; resetShareLink: true išduoda naują bendrinimo URL (senasis nustoja veikti)

Kiekviename atsakyme url yra bendrinimo URL. Jei nuoroda vieša, tai trumpasis URL. Bendrinimas, bendrinimo atšaukimas, prieigos pakeitimai ir atstatymai kiekvienas skaičiuojami kaip vienas įvykis, o išėjimas – ne.

Variantai

Kiekviena nuoroda yra vieno ar daugiau variantų konteineris. Variantą sudaro turinys (url | file | text), jo paties apribojimai (password, starts, expires, maxOpenings, pristabdymas), weight ir neprivalomos lankytojo sąlygos when. Be variants nuoroda turi vieną variantą, pavadintą main. Nuorodos apribojimai turi pirmenybę prieš variantų apribojimus. Lankytojas gauna vieną variantą. Variantai, kurių when atitinka lankytoją, sudaro rinkinį (jei tokių nėra, rinkinį sudaro besąlyginiai variantai), o tada variantas parenkamas pagal svorį. sticky (numatytoji reikšmė true) grįžtančiam lankytojui palieka tą patį variantą, o restartSplit paskirsto lankytojus iš naujo. Nuorodos kind yra group, kai variantų yra keli. Nuorodos status yra mixed, kai variantai skiriasi. Vienoje nuorodoje gali būti daugiausia 20 variantų. Struktūros: HTTP API.

Vietoj sutrumpintos formos links_create priima variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], taip pat sticky ir forwardParams. links_update priima sticky, forwardParams ir restartSplit. links_list filtruoja pagal kind (papildoma group) ir status (papildoma mixed). links_stats grąžina variants sumas. links_export / links_import naudoja variantų CSV (viena eilutė vienam variantui).

Įrankis Įvestis
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? }

when raktai: countries, devices, os, browsers, languages, referrerHosts (eilučių masyvai; turi atitikti kiekvienas nustatytas raktas), taip pat params.

Užklausos parametrų taisyklės. when.params yra iki 10 taisyklių masyvas, taikomas lankytojo užklausos eilutei. Turi galioti kiekviena taisyklė: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value yra | atskirtas sąrašas) | exists | missing (paskutiniams dviem value nenurodomas). Raktuose skiriamos didžiosios ir mažosios raidės, o reikšmės lyginamos tiksliai. Parametrų reikšmės analitikoje niekada nesaugomos.

Užklausos parametrų perdavimas. forwardParams (loginė reikšmė per links_create / links_update, numatytoji reikšmė false) prie URL variantų prideda visą lankytojo užklausos eilutę. Lankytojo reikšmės pakeičia išsaugotąsias, įskaitant utm. Veikia tik URL variantams. Tai maršrutizavimas, o ne prieigos valdymas.

auth create / auth login / auth logout nėra MCP įrankiai. Atitikmenys: api.md.

Was this page helpful?