MCP
Attālais MCP adresē https://api.linkdash.dev/mcp. Pierakstieties ar OAuth no Claude, ChatGPT, Cursor un Codex vai izmantojiet API atslēgu.
Attālais MCP adresē https://api.linkdash.dev/mcp. Pievienojiet URL savam klientam un pierakstieties ar savu Linkdash kontu. Ja aģents darbojas bez cilvēka pie pārlūkprogrammas, izmantojiet API atslēgu. Vienkāršs markdown: mcp.md.
Pievienošana
Norādiet klientam tikai URL https://api.linkdash.dev/mcp. Tas atvērs Linkdash pierakstīšanās lapu un pēc tam piekrišanas ekrānu. Šajā ekrānā ir norādīta lietotne un vietne, uz kuru tā atgriezīsies. Atļaujiet piekļuvi, un klients saņems jūsu konta marķieri.
- claude.ai un Claude Desktop: atveriet Linkdash savienotāju katalogā (vai Customize → Connectors un meklējiet Linkdash) un noklikšķiniet uz Connect.
- ChatGPT: ieraksts ChatGPT spraudņu katalogā būs pieejams drīzumā. Līdz tam sadaļā Plugins izvēlieties + → Add custom MCP server, ievadiet iepriekš norādīto URL un izvēlieties OAuth.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, pēc tamclaude mcp login linkdash(vai/mcpsesijā). - Cursor: Pievienot Cursor to instalē ar vienu klikšķi. Pēc tam pierakstieties, kad Cursor to pieprasa. Vai arī pievienojiet serveri failam
mcp.jsonar"url"un bezheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, pēc tamcodex mcp login linkdash.
Lietotne iegūst tādu pašu piekļuvi kā API atslēga. Pievienotās lietotnes ir redzamas sadaļā Vadības panelis → API atslēgas. Tur ar Atvienot to piekļuvi var nekavējoties atsaukt.
Automatizācija un aģenti bez saskarnes
Pierakstīšanās prasa cilvēku pie pārlūkprogrammas. CI uzdevumiem, ieplānotiem aģentiem, serveriem un kodam, kas tieši izsauc MCP, sūtiet API atslēgu: Authorization: Bearer ldash_.... Tās ir tās pašas atslēgas, ko izmanto HTTP API.
Cursor (~/.cursor/mcp.json vai .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 konfigurācijā nepieciešams "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"
Lokāli: Convex .site URL + /mcp.
Faili
Nesūtiet baitus caur MCP JSON. Izveidojiet URL ({uploadUrl,storageId}), augšupielādējiet failu no resursdatora ar PUT un pēc tam izveidojiet saiti:
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 rīki: files_upload_url atgriež {uploadUrl,storageId} → resursdators veic PUT uz uploadUrl → links_create ar šo storageId. Neobligāta priekšskatījuma kartīte: previewName, previewDescription, previewImageStorageId (augšupielādē tāpat). Ja norādāt neobligāto maxOpenings, saite tiek apturēta pēc tik daudzām atvēršanas reizēm. Ar links_update šo skaitu var palielināt vai nodot clearMaxOpenings. Nerādiet uploadUrl lietotājam.
Rīki
| 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) |
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 vai editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → mērķis; atbloķē ar paroli aizsargātu variantu redaktoram uz 30 minūtēm |
|
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 |
| (resursdators veic PUT pēc URL izveides) | 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_* |
Mapes
Mape ir saite, kurā uzskaitīti tajā ievietotie vienumi. Modeļa aprakstu skatiet sadaļā Mapes.
| Rīks | Ievade |
|---|---|
links_create |
{ kind: "folder", name, … } izveido mapi. Jebkurai izveides darbībai var norādīt folder (slug) un folderDomain?, lai vienumu izveidotu mapē. Atbildē ir iekļauts folder |
links_list |
Viena lapa, { items, cursor } (limit 1-100, noklusējums 50; nododiet cursor atpakaļ, līdz tas ir null). q meklē pēc vārdiem; folder: "<slug>" uzskaita mapes tiešo saturu; folder: "root" uzskaita augstāko līmeni; kind pieļauj vērtību folder. Rindās ir folder, un mapju rindās ir items |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (tāda pati piekļuve, jauns kopīgošanas URL, bez personām) |
links_delete |
contents?: "keep" | "delete" mapēm (noklusējums keep) |
links_export / links_import pievieno kolonnas folder un access. Rindas, kurās kind ir folder, izveido mapes.
Piekļuve un kopīgošana
Jaunas saites un mapes ir ierobežotas: url ir https://linkdash.dev/s/<token>, un to var atvērt tikai jūs un personas, ar kurām to kopīgojat. Norādiet access izsaukumā links_create vai links_update. Iespējamās vērtības: restricted (noklusējums), link (ikviens, kam ir kopīgošanas URL) vai public (ikviens, izmantojot īso URL). Pieprasiet access: "public", ja saite tiks publicēta publiski. Skatiet Kopīgošana un piekļuve.
| Rīks | Ievade |
|---|---|
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? } → viena lapa ar visu jūsu kopīgoto saturu, { items, cursor }, katram vienumam ar people |
links_shared |
{ limit?, cursor? } → viena lapa ar vienumiem, ko citi ir kopīgojuši ar jums, { items, cursor }, katram vienumam ar url tā atvēršanai |
links_leave |
{ id } (_id vai kopīgošanas URL no links_shared) → { _id, left: true } |
links_update |
access? nosaka, kas var to atvērt; resetShareLink: true izsniedz jaunu kopīgošanas URL (vecais vairs nedarbojas) |
Katras atbildes url ir kopīgošanas URL. Ja saite ir publiska, tas ir īsais URL. Kopīgošana, kopīgošanas atcelšana, piekļuves izmaiņas un atiestatīšana katra tiek uzskaitīta kā viens notikums, bet aiziešana netiek.
Varianti
Katra saite ir viena vai vairāku variantu konteiners. Katram variantam ir saturs (url | file | text), savi piekļuves nosacījumi (password, starts, expires, maxOpenings, apturēts), weight un neobligāti apmeklētāja nosacījumi when. Bez variants saitei ir viens variants ar nosaukumu main. Saites nosacījumiem ir prioritāte pār variantu nosacījumiem. Apmeklētājs saņem vienu variantu. Varianti, kuru when atbilst, veido kopu (ja tādu nav, kopu veido varianti bez nosacījumiem), un no tās tiek veikta svērta izvēle. sticky (noklusējums true) saglabā atgriezušos apmeklētāju pie tā paša varianta, bet restartSplit sadalījumu veic no jauna. Saites kind ir group, ja variantu ir vairāki. Saites status ir mixed, ja variantu statusi atšķiras. Vienai saitei var būt ne vairāk kā 20 variantu. Struktūras: HTTP API.
links_create saīsinātā pieraksta vietā pieņem variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }], kā arī sticky un forwardParams. links_update pieņem sticky, forwardParams un restartSplit. links_list filtrē pēc kind (papildu vērtība group) un status (papildu vērtība mixed). links_stats atgriež variants kopsummas. links_export / links_import izmanto variantu CSV (viena rinda katram variantam).
| Rīks | Ievade |
|---|---|
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 atslēgas: countries, devices, os, browsers, languages, referrerHosts (virkņu masīvi; jāatbilst katrai norādītajai atslēgai), kā arī params.
Vaicājuma parametru noteikumi. when.params ir masīvs ar ne vairāk kā 10 noteikumiem apmeklētāja vaicājuma virknei, un jāizpildās katram noteikumam: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value ir ar | atdalīts saraksts) | exists | missing (pēdējiem diviem value nenorāda). Atslēgās tiek ņemts vērā lielo un mazo burtu reģistrs, un vērtības tiek salīdzinātas precīzi. Parametru vērtības analītikā nekad netiek saglabātas.
Vaicājuma parametru pārsūtīšana. forwardParams ir Būla vērtība izsaukumos links_create / links_update (noklusējums false). Tā pievieno apmeklētāja pilno vaicājuma virkni URL variantiem. Apmeklētāja vērtības aizstāj saglabātās, arī utm. Darbojas tikai URL variantiem. Tā ir maršrutēšana, nevis piekļuves kontrole.
auth create / auth login / auth logout nav MCP rīki. Atbilstība: api.md.

