---
title: MCP
description: >-
  Nuotolinis MCP adresu https://api.linkdash.dev/mcp. Prisijunkite per OAuth iš
  Claude, ChatGPT, Cursor ir Codex arba naudokite API raktą.
sidebar:
  label: MCP
  order: 5
---
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ą](#automation-and-headless-agents). Paprastas Markdown: [mcp.md](https://linkdash.dev/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](https://claude.ai/directory/linkdash) (arba Customize → Connectors ir ieškokite Linkdash) ir spustelėkite **Connect**.
- **ChatGPT:** įrašas ChatGPT papildinių kataloge netrukus pasirodys. Iki tol skiltyje [Plugins](https://chatgpt.com/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](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) į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](https://linkdash.dev/dashboard/keys). 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ą](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Tai tie patys raktai kaip ir [HTTP API](/lt/api).

**Cursor** (`~/.cursor/mcp.json` arba `.cursor/mcp.json`):

```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ą:

```bash
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](/lt/folders).

| Į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](/lt/sharing).

| Į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](/lt/api#variantai).

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](https://linkdash.dev/api.md).
