---
title: MCP
description: >-
  Vzdialený MCP server na https://api.linkdash.dev/mcp. Prihláste sa cez OAuth z
  Claude, ChatGPT, Cursor a Codex alebo použite API kľúč.
sidebar:
  label: MCP
  order: 5
---
Vzdialený MCP server na `https://api.linkdash.dev/mcp`. Pridajte URL do svojho klienta a prihláste sa svojím účtom Linkdash. Pre agentov, ktorí bežia bez človeka pri prehliadači, použite namiesto toho [API kľúč](#automation-and-headless-agents). Čistý markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Pripojenie

Klientovi zadajte iba URL `https://api.linkdash.dev/mcp`. Klient otvorí prihlásenie do Linkdash. Potom zobrazí obrazovku so súhlasom, na ktorej je uvedený názov aplikácie a stránka, na ktorú sa vráti. Ak to povolíte, klient získa token pre váš účet.

- **claude.ai a Claude Desktop:** otvorte [Linkdash v adresári konektorov](https://claude.ai/directory/linkdash) (alebo Customize → Connectors a vyhľadajte Linkdash) a kliknite na **Connect**.
- **ChatGPT:** Linkdash čoskoro pribudne v adresári pluginov ChatGPT. Dovtedy v [Plugins](https://chatgpt.com/plugins) zvoľte **+** → **Add custom MCP server**, zadajte URL uvedenú vyššie a zvoľte OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, potom `claude mcp login linkdash` (alebo `/mcp` v relácii).
- **Cursor:** [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) ho nainštaluje jedným kliknutím. Potom sa prihláste, keď vás Cursor vyzve. Prípadne pridajte server do `mcp.json` s `"url"` a bez `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, potom `codex mcp login linkdash`.

Aplikácia získa rovnaký prístup ako API kľúč. Pripojené aplikácie nájdete v [Ovládací panel → API kľúče](https://linkdash.dev/dashboard/keys). Tlačidlo **Odpojiť** im tam prístup okamžite odoberie.

## Automatizácia a agenti bez rozhrania

Prihlásenie vyžaduje človeka pri prehliadači. Pre úlohy CI, plánovaných agentov, servery a kód, ktorý volá MCP priamo, posielajte namiesto toho [API kľúč](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Sú to rovnaké kľúče ako pre [HTTP API](/sk/api).

**Cursor** (`~/.cursor/mcp.json` alebo `.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 vyžaduje `"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álne: Convex `.site` URL + `/mcp`.

## Súbory

Neposielajte bajty cez MCP JSON. Vygenerujte URL (`{uploadUrl,storageId}`), nahrajte súbor z hostiteľa metódou PUT a potom vytvorte odkaz:

```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}'
```

Nástroje MCP: `files_upload_url` vráti `{uploadUrl,storageId}` → hostiteľ odošle súbor metódou PUT na `uploadUrl` → `links_create` s týmto `storageId`. Voliteľná náhľadová karta: `previewName`, `previewDescription`, `previewImageStorageId` (rovnaký postup nahrávania). Voliteľný parameter `maxOpenings` pozastaví odkaz po zadanom počte otvorení. Pomocou `links_update` ho môžete zvýšiť alebo odovzdať `clearMaxOpenings`. Nezobrazujte `uploadUrl` používateľovi.

## Nástroje

| 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 alebo editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → cieľ; odomkne variant chránený heslom pre editora na 30 minút |
| `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` |
| (PUT z hostiteľa po vygenerovaní URL) | `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_*` |

## Priečinky

Priečinok je odkaz, ktorý zobrazuje položky, ktoré doň vložíte. Ako priečinky fungujú, sa dozviete v časti [Priečinky](/sk/folders).

| Nástroj | Vstup |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` vytvorí priečinok. Každé vytvorenie prijíma `folder` (slug) a `folderDomain?` na vytvorenie položky v priečinku. Odpoveď obsahuje `folder` |
| `links_list` | Jedna stránka, `{ items, cursor }` (`limit` 1-100, predvolene 50; `cursor` odovzdávajte späť, kým nebude `null`). `q` vyhľadáva podľa slov; `folder: "<slug>"` zobrazí položky priamo v priečinku; `folder: "root"` zobrazí najvyššiu úroveň; `kind` pridáva hodnotu `folder`. Riadky obsahujú `folder` a riadky priečinkov obsahujú `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (rovnaký prístup, nová URL na zdieľanie, bez zdieľaných osôb) |
| `links_delete` | `contents?: "keep" \| "delete"` pre priečinky (predvolene `keep`) |

`links_export` / `links_import` pridávajú stĺpce `folder` a `access` a riadky s `kind` `folder` vytvárajú priečinky.

## Prístup a zdieľanie

Nové odkazy a priečinky majú obmedzený prístup: `url` je `https://linkdash.dev/s/<token>` a otvoriť ju môžete iba vy a ľudia, s ktorými ju zdieľate. V `links_create` alebo `links_update` odovzdajte `access`: `restricted` (predvolené), `link` (ktokoľvek s URL na zdieľanie) alebo `public` (ktokoľvek cez krátku URL). Ak bude odkaz zverejnený, nastavte `access: "public"`. Pozrite si [Zdieľanie a prístup](/sk/sharing).

| Nástroj | Vstup |
| --- | --- |
| `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? }` → jedna stránka všetkého, čo ste zdieľali, `{ items, cursor }`, každá položka s `people` |
| `links_shared` | `{ limit?, cursor? }` → jedna stránka položiek, ktoré s vami zdieľali iní ľudia, `{ items, cursor }`, s `url` na otvorenie každej z nich |
| `links_leave` | `{ id }` (`_id` alebo URL na zdieľanie z `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` mení, kto ho môže otvoriť; `resetShareLink: true` vydá novú URL na zdieľanie (stará prestane fungovať) |

Každá `url` v odpovedi je URL na zdieľanie. Ak je odkaz verejný, je to krátka URL. Zdieľanie, zrušenie zdieľania, zmena prístupu a reset sa počítajú ako jedna udalosť; opustenie zdieľania sa nepočíta.

## Varianty

Každý odkaz obsahuje jeden alebo viac **variantov**. Variant tvorí obsah (`url` | `file` | `text`), vlastné obmedzenia prístupu (`password`, `starts`, `expires`, `maxOpenings`, pozastavenie), `weight` a voliteľné podmienky pre návštevníka `when`. Bez `variants` má odkaz jeden variant s názvom `main`. Obmedzenia prístupu odkazu majú prednosť pred obmedzeniami variantov. Návštevník dostane jeden variant. Kandidátmi sú varianty, ktorých `when` vyhovuje (inak varianty bez podmienok). Z nich sa variant vyberie náhodne podľa váhy. `sticky` (predvolene `true`) ponechá vracajúcemu sa návštevníkovi rovnaký variant a `restartSplit` rozdelenie premieša nanovo. `kind` odkazu je `group`, ak má viacero variantov; `status` odkazu je `mixed`, keď sa stavy variantov líšia. Odkaz môže mať najviac 20 variantov. Štruktúry: [HTTP API](/sk/api#varianty).

`links_create` prijíma namiesto skráteného zápisu `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]`, ďalej `sticky` a `forwardParams`. `links_update` prijíma `sticky`, `forwardParams` a `restartSplit`. `links_list` filtruje podľa `kind` (pribudne `group`) a `status` (pribudne `mixed`). `links_stats` vracia súhrny `variants`. `links_export` / `links_import` používajú CSV s variantmi (jeden riadok na variant).

| Nástroj | Vstup |
| --- | --- |
| `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? }` |

Kľúče `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (polia reťazcov; každý nastavený kľúč musí vyhovovať), plus `params`.

**Pravidlá pre parametre dotazu.** `when.params` je pole s najviac 10 pravidlami pre query string návštevníka. Musia platiť všetky pravidlá: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` je zoznam oddelený znakom `|`) | `exists` | `missing` (posledné dva nemajú `value`). Kľúče rozlišujú veľké a malé písmená a hodnoty sa porovnávajú presne. Hodnoty parametrov sa nikdy neukladajú do analytiky.

**Preposielanie parametrov dotazu.** `forwardParams` (boolean v `links_create` / `links_update`, predvolene `false`) pripojí celý query string návštevníka k URL variantom. Hodnoty návštevníka prepíšu uložené hodnoty vrátane `utm`. Platí iba pre URL varianty. Ide o smerovanie, nie o riadenie prístupu.

`auth create` / `auth login` / `auth logout` nie sú nástroje MCP. Mapovanie: [api.md](https://linkdash.dev/api.md).
