Skip to content
LinkdashLinkdash
Latviešu
Esc
↑↓navigate↵open⌘Jpreview
On this page

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 tam claude mcp login linkdash (vai /mcp sesijā).
  • Cursor: Pievienot Cursor to instalē ar vienu klikšķi. Pēc tam pierakstieties, kad Cursor to pieprasa. Vai arī pievienojiet serveri failam mcp.json ar "url" un bez headers.
  • Codex: codex mcp add linkdash --url https://api.linkdash.dev/mcp, pēc tam codex 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.

Was this page helpful?