---
title: MCP
description: >-
  Udaljeni MCP na https://api.linkdash.dev/mcp. Prijavite se putem OAuth-a iz
  Claudea, ChatGPT-a, Cursora i Codexa ili upotrijebite API ključ.
sidebar:
  label: MCP
  order: 5
---
Udaljeni MCP na `https://api.linkdash.dev/mcp`. Dodajte URL u svoj klijent i prijavite se svojim Linkdash računom. Za agente koji rade bez osobe za preglednikom umjesto toga upotrijebite [API ključ](#automation-and-headless-agents). Čisti markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Povezivanje

Klijentu navedite samo URL `https://api.linkdash.dev/mcp`. Klijent otvara prijavu u Linkdash, a zatim zaslon za privolu na kojem su navedeni aplikacija i web-mjesto na koje se vraća. Dopustite pristup i klijent dobiva token za vaš račun.

- **claude.ai i Claude Desktop:** otvorite [Linkdash u direktoriju konektora](https://claude.ai/directory/linkdash) (ili Customize → Connectors i potražite Linkdash) i kliknite **Connect**.
- **ChatGPT:** unos u direktoriju dodataka ChatGPT-a uskoro stiže. Do tada u [Plugins](https://chatgpt.com/plugins) odaberite **+** → **Add custom MCP server**, unesite gornji URL i odaberite OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, zatim `claude mcp login linkdash` (ili `/mcp` unutar sesije).
- **Cursor:** [Dodaj u Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) ga instalira jednim klikom, a zatim se prijavite kada to Cursor zatraži. Ili dodajte poslužitelj u `mcp.json` s `"url"` i bez `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, zatim `codex mcp login linkdash`.

Aplikacija dobiva isti pristup kao API ključ. Povezane aplikacije navedene su pod [Nadzorna ploča → API ključevi](https://linkdash.dev/dashboard/keys), gdje ih **Odspoji** odmah opoziva.

## Automatizacija i agenti bez sučelja

Za prijavu je potrebna osoba za preglednikom. Za CI poslove, zakazane agente, poslužitelje i kôd koji izravno poziva MCP umjesto toga pošaljite [API ključ](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`, iste ključeve kao za [HTTP API](/hr/api).

**Cursor** (`~/.cursor/mcp.json` ili `.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 zahtijeva `"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"`

Lokalno: Convex `.site` URL + `/mcp`.

## Datoteke

Ne šaljite bajtove kroz MCP JSON. Generirajte URL (`{uploadUrl,storageId}`), datoteku pošaljite PUT zahtjevom s hosta, a zatim stvorite poveznicu:

```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 alati: `files_upload_url` vraća `{uploadUrl,storageId}` → host šalje PUT na `uploadUrl` → `links_create` s tim `storageId`. Neobavezna kartica pregleda: `previewName`, `previewDescription`, `previewImageStorageId` (isti postupak prijenosa). Neobavezni `maxOpenings` pauzira poveznicu nakon toliko otvaranja; `links_update` može povećati tu vrijednost ili proslijediti `clearMaxOpenings`. Ne ispisujte `uploadUrl` korisniku.

## Alati

| 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-a) | `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 ili editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → cilj; otključava varijantu zaštićenu lozinkom za urednika na 30 minuta |
| `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 šalje PUT nakon generiranja URL-a) | `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_*` |

## Mape

Mapa je poveznica koja navodi stavke koje u nju stavite. Za model pogledajte [Mape](/hr/folders).

| Alat | Ulaz |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` stvara mapu; svako stvaranje prima `folder` (slug) i `folderDomain?` za stvaranje unutar mape. Odgovor uključuje `folder` |
| `links_list` | Jedna stranica, `{ items, cursor }` (`limit` 1-100, zadano 50; vraćajte `cursor` dok ne postane `null`). `q` traži podudaranje riječi; `folder: "<slug>"` navodi ono što se nalazi izravno unutra; `folder: "root"` navodi najvišu razinu; `kind` dodaje `folder`. Retci sadrže `folder`, a retci mapa sadrže `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (isti pristup, novi URL za dijeljenje, bez osoba) |
| `links_delete` | `contents?: "keep" \| "delete"` za mape (zadano `keep`) |

`links_export` / `links_import` dodaju stupce `folder` i `access`, a retci s `kind` `folder` stvaraju mape.

## Pristup i dijeljenje

Nove poveznice i mape su ograničene: `url` je `https://linkdash.dev/s/<token>`, a mogu ga otvoriti samo vi i osobe s kojima ga dijelite. Proslijedite `access` u `links_create` ili `links_update`: `restricted` (zadano), `link` (svatko s URL-om za dijeljenje) ili `public` (svatko, na kratkom URL-u). Zatražite `access: "public"` kada će poveznica biti javno objavljena. Pogledajte [Dijeljenje i pristup](/hr/sharing).

| Alat | Ulaz |
| --- | --- |
| `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 stranica svega što ste podijelili, `{ items, cursor }`, svaka stavka s `people` |
| `links_shared` | `{ limit?, cursor? }` → jedna stranica stavki koje su drugi podijelili s vama, `{ items, cursor }`, s `url` za otvaranje svake stavke |
| `links_leave` | `{ id }` (`_id` ili URL za dijeljenje iz `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` mijenja tko je može otvoriti; `resetShareLink: true` izdaje novi URL za dijeljenje (stari prestaje raditi) |

Svaki `url` u odgovoru je URL za dijeljenje, osim ako je poveznica javna, kada je to kratki URL. Dijeljenje, prestanak dijeljenja, promjene pristupa i resetiranja broje se kao po jedan događaj; napuštanje se ne broji.

## Varijante

Svaka poveznica je spremnik jedne ili više **varijanti**: sadržaj (`url` | `file` | `text`) plus vlastita zaštita (`password`, `starts`, `expires`, `maxOpenings`, pauzirano), `weight` i neobavezni uvjeti za posjetitelje `when`. Bez `variants` poveznica ima jednu varijantu nazvanu `main`. Zaštita poveznice ima prednost pred zaštitama varijanti. Posjetitelj dobiva jednu varijantu: varijante čiji se `when` podudara čine skup (inače one bezuvjetne), a zatim slijedi ponderirani odabir; `sticky` (zadano `true`) zadržava posjetitelja koji se vraća na istoj varijanti, a `restartSplit` ponovno miješa raspodjelu. `kind` poveznice je `group` kada ima više varijanti; `status` poveznice je `mixed` kada se varijante razlikuju. Najviše 20 varijanti po poveznici. Oblici: [HTTP API](/hr/api#varijante).

`links_create` umjesto skraćenog oblika prima `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]`, plus `sticky` i `forwardParams`. `links_update` prima `sticky`, `forwardParams` i `restartSplit`. `links_list` filtrira po `kind` (dodaje `group`) i `status` (dodaje `mixed`). `links_stats` vraća ukupne vrijednosti za `variants`. `links_export` / `links_import` koriste CSV varijanti (jedan redak po varijanti).

| Alat | Ulaz |
| --- | --- |
| `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? }` |

Ključevi za `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (nizovi stringova; svaki postavljeni ključ mora se podudarati), plus `params`.

**Pravila za parametre upita.** `when.params` je niz od najviše 10 pravila nad nizom upita (query string) posjetitelja; svako pravilo mora biti zadovoljeno: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` je popis odvojen znakom `|`) | `exists` | `missing` (bez `value` za posljednja dva). Ključevi razlikuju velika i mala slova, a vrijednosti se uspoređuju točno. Vrijednosti parametara nikada se ne pohranjuju u analitici.

**Prosljeđivanje parametara upita.** `forwardParams` (boolean u `links_create` / `links_update`, zadano `false`) dodaje cijeli niz upita posjetitelja URL varijantama; vrijednosti posjetitelja nadjačavaju pohranjene, uključujući `utm`. Samo za URL varijante. Služi za usmjeravanje, a ne za kontrolu pristupa.

`auth create` / `auth login` / `auth logout` nisu MCP alati. Mapiranje: [api.md](https://linkdash.dev/api.md).
