---
title: MCP
description: >-
  Kaug-MCP aadressil https://api.linkdash.dev/mcp. Logi Claude'ist, ChatGPT-st,
  Cursorist ja Codexist sisse OAuthiga või kasuta API-võtit.
sidebar:
  label: MCP
  order: 5
---
Kaug-MCP asub aadressil `https://api.linkdash.dev/mcp`. Lisa URL oma klienti ja logi sisse oma Linkdashi kontoga. Kui agent töötab ilma, et keegi brauseri taga oleks, kasuta selle asemel [API-võtit](#automation-and-headless-agents). Lihtne markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Ühendamine

Anna kliendile ainult URL `https://api.linkdash.dev/mcp`. Klient avab Linkdashi sisselogimise ja siis nõusolekuekraani. Sellel on näha rakenduse nimi ja sait, kuhu sind tagasi suunatakse. Kui lubad, saab klient sinu konto jaoks tokeni.

- **claude.ai ja Claude Desktop:** ava [Linkdash konnektorite kataloogis](https://claude.ai/directory/linkdash) (või vali Customize → Connectors ja otsi Linkdashi) ning klõpsa **Connect**.
- **ChatGPT:** Linkdash tuleb peagi ka ChatGPT pluginate kataloogi. Seni ava [Plugins](https://chatgpt.com/plugins), vali **+** → **Add custom MCP server**, sisesta ülaltoodud URL ja vali OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, seejärel `claude mcp login linkdash` (või sessioonis `/mcp`).
- **Cursor:** [Lisa Cursorisse](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) paigaldab serveri ühe klõpsuga. Kui Cursor küsib, logi sisse. Teine võimalus on lisada server faili `mcp.json`, kus on `"url"`, aga `headers` puudub.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, seejärel `codex mcp login linkdash`.

Rakendus saab samasuguse ligipääsu nagu API-võti. Ühendatud rakendused on loetletud lehel [Töölaud → API-võtmed](https://linkdash.dev/dashboard/keys). Seal saad nupuga **Ühenda lahti** nende ligipääsu kohe tühistada.

## Automatiseerimine ja peata agendid

Sisselogimiseks peab keegi brauseri taga olema. CI-tööde, ajastatud agentide, serverite ja otse MCP-d kutsuva koodi jaoks saada selle asemel [API-võti](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Need on samad võtmed, mida kasutab [HTTP API](/et/api).

**Cursor** (`~/.cursor/mcp.json` või `.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-is on vaja `"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"`

Lokaalselt: Convexi `.site` URL + `/mcp`.

## Failid

Ära saada faili baite MCP JSON-iga. Loo üleslaadimise URL (`{uploadUrl,storageId}`), saada fail hostist PUT-päringuga ja seejärel loo link:

```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 tööriistad: `files_upload_url` tagastab `{uploadUrl,storageId}` → host saadab faili PUT-päringuga aadressile `uploadUrl` → `links_create` saab selle `storageId`. Valikuline eelvaatekaart: `previewName`, `previewDescription`, `previewImageStorageId` (pilt laaditakse üles samal viisil). Valikulise `maxOpenings` puhul peatatakse link pärast nii mitut avamist. `links_update` saab piirangut suurendada või selle `clearMaxOpenings` abil eemaldada. Ära näita `uploadUrl`-i kasutajale.

## Tööriistad

| 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` (ilma id-ta) | `GET /shares` | `links_shares` (ilma `id`-ta) |
| `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 või editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → sihtkoht; avab parooliga kaitstud variandi muutjale 30 minutiks |
| `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 teeb PUT-päringu pärast URL-i loomist) | `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_*` |

## Kaustad

Kaust on link, mis näitab nimekirja sinna pandud üksustest. Mudeli kohta loe lähemalt lehelt [Kaustad](/et/folders).

| Tööriist | Sisend |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` loob kausta. Iga loomiskutse võtab vastu ka `folder` (slug) ja `folderDomain?`, kui tahad üksuse luua kausta sisse. Vastuses on `folder` |
| `links_list` | Tagastab ühe lehekülje kujul `{ items, cursor }` (`limit` 1-100, vaikimisi 50). Saada `cursor` tagasi, kuni see on `null`. `q` otsib sõnade järgi. `folder: "<slug>"` näitab, mis on otse selle kausta sees, ja `folder: "root"` näitab ülemist taset. `kind` lubab ka väärtust `folder`. Igal real on `folder` ja kaustaridadel ka `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (sama ligipääs, uus jagamis-URL, ilma jagatud inimesteta) |
| `links_delete` | Kaustade puhul `contents?: "keep" \| "delete"` (vaikimisi `keep`) |

`links_export` / `links_import` lisavad veerud `folder` ja `access`. Read, kus `kind` on `folder`, loovad kaustu.

## Ligipääs ja jagamine

Uued lingid ja kaustad on vaikimisi piiratud: `url` on `https://linkdash.dev/s/<token>` ja seda saad avada ainult sina ja inimesed, kellega oled selle jaganud. Ligipääsu muutmiseks anna `links_create` või `links_update` kutses `access`: `restricted` (vaikimisi), `link` (igaüks, kellel on jagamis-URL) või `public` (igaüks, lühi-URL-i kaudu). Kui link postitatakse avalikult, küsi `access: "public"`. Loe lähemalt lehelt [Jagamine ja ligipääs](/et/sharing).

| Tööriist | Sisend |
| --- | --- |
| `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? }` tagastab ühe lehekülje kõigest, mida oled jaganud, kujul `{ items, cursor }`, ja igal üksusel on `people` |
| `links_shared` | `{ limit?, cursor? }` tagastab ühe lehekülje üksustest, mida teised on sinuga jaganud, kujul `{ items, cursor }`. Igal üksusel on `url`, millega seda avada |
| `links_leave` | `{ id }` (`_id` või jagamis-URL `links_shared` vastusest) → `{ _id, left: true }` |
| `links_update` | `access?` muudab, kes saab üksust avada. `resetShareLink: true` loob uue jagamis-URL-i ja vana lakkab töötamast |

Vastuses olev `url` on alati jagamis-URL, välja arvatud avaliku lingi puhul: siis on see lühi-URL. Jagamine, jagamise lõpetamine, ligipääsu muutmine ja lingi lähtestamine loetakse igaüks üheks sündmuseks. Lahkumist sündmuseks ei loeta.

## Variandid

Iga link sisaldab ühte või mitut **varianti**. Variandil on sisu (`url` | `file` | `text`), oma värav (`password`, `starts`, `expires`, `maxOpenings`, peatatud olek), `weight` ja valikulised külastaja tingimused `when`. Kui `variants` puudub, on lingil üks variant nimega `main`. Kui lingi ja variandi väravad lähevad vastuollu, kehtib lingi värav. Külastaja saab ühe variandi. Kõigepealt kogutakse kokku variandid, mille `when` sobib (kui ükski ei sobi, siis tingimusteta variandid), ja nende seast valitakse üks kaalude järgi. `sticky` (vaikimisi `true`) hoiab tagasi tulnud külastaja samal variandil ja `restartSplit` jagab külastajad uuesti. Kui variante on mitu, on lingi `kind` väärtusega `group`. Kui variantide olekud erinevad, on lingi `status` väärtusega `mixed`. Ühel lingil saab olla kuni 20 varianti. Andmekujud leiad siit: [HTTP API](/et/api#variandid).

Lühivormi asemel võtab `links_create` vastu `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` ning lisaks `sticky` ja `forwardParams`. `links_update` võtab vastu `sticky`, `forwardParams` ja `restartSplit`. `links_list` filtreerib `kind` (lubab ka `group`) ja `status` (lubab ka `mixed`) järgi. `links_stats` tagastab `variants` kogusummad. `links_export` / `links_import` kasutavad variantide CSV-d, kus iga variant on eraldi real.

`when` võtmed on `countries`, `devices`, `os`, `browsers`, `languages` ja `referrerHosts` (sõnede massiivid; iga määratud võti peab sobima) ning lisaks `params`.

**Päringuparameetrite reeglid.** `when.params` on kuni 10 reeglist koosnev massiiv, mis kontrollib külastaja päringustringi. Kõik reeglid peavad kehtima: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` on `|`-ga eraldatud loend) | `exists` | `missing` (kahe viimasega `value` ei anta). Võtmetes on suur- ja väiketähed erinevad ning väärtusi võrreldakse täpselt. Parameetrite väärtusi analüütikasse ei salvestata.

**Päringuparameetrite edasisaatmine.** `forwardParams` on tõeväärtus, mille saad anda `links_create` / `links_update` kutses (vaikimisi `false`). See lisab URL-variantidele külastaja kogu päringustringi. Külastaja väärtused kirjutavad salvestatud väärtused üle, ka `utm`. See töötab ainult URL-variantidega. Parameetrid mõjutavad ainult suunamist, mitte ligipääsu.

`auth create` / `auth login` / `auth logout` ei ole MCP tööriistad. Vastavustabel: [api.md](https://linkdash.dev/api.md).
