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, tadaclaude mcp login linkdash(arba/mcpsesijoje). - Cursor: Pridėti prie Cursor įdiegia jį vienu spustelėjimu. Paskui prisijunkite, kai Cursor paprašys. Arba įtraukite serverį į
mcp.jsonsu"url"ir beheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, tadacodex 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.

