---
title: MCP
description: >-
  Oddaljeni MCP na https://api.linkdash.dev/mcp. Prijavite se z OAuth iz Claude,
  ChatGPT, Cursor in Codex ali uporabite ključ API.
sidebar:
  label: MCP
  order: 5
---
Oddaljeni MCP na `https://api.linkdash.dev/mcp`. URL dodajte v svojega odjemalca in se prijavite s svojim računom Linkdash. Za agente, ki delujejo, ne da bi za brskalnikom sedela oseba, namesto tega uporabite [ključ API](#automation-and-headless-agents). Navaden markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Povezovanje

Odjemalcu podajte samo URL `https://api.linkdash.dev/mcp`. Odpre se prijava v Linkdash, nato pa zaslon za soglasje, ki navede aplikacijo in spletno mesto, na katerega se vrne. Dovolite dostop in odjemalec prejme žeton za vaš račun.

- **claude.ai in Claude Desktop:** odprite [Linkdash v imeniku konektorjev](https://claude.ai/directory/linkdash) (ali Customize → Connectors in poiščite Linkdash) ter kliknite **Connect**.
- **ChatGPT:** vnos v imeniku vtičnikov ChatGPT bo kmalu na voljo. Do takrat v [Plugins](https://chatgpt.com/plugins) izberite **+** → **Add custom MCP server**, vnesite zgornji URL in izberite OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, nato `claude mcp login linkdash` (ali `/mcp` v seji).
- **Cursor:** [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) ga namesti z enim klikom, nato se prijavite, ko vas Cursor pozove. Strežnik lahko dodate tudi v `mcp.json` z `"url"` in brez `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, nato `codex mcp login linkdash`.

Aplikacija dobi enak dostop kot ključ API. Povezane aplikacije so navedene pod [Nadzorna plošča → Ključi API](https://linkdash.dev/dashboard/keys), kjer jih z **Odklopi** takoj prekličete.

## Avtomatizacija in agenti brez vmesnika

Prijava zahteva osebo za brskalnikom. Za opravila CI, načrtovane agente, strežnike in kodo, ki MCP kliče neposredno, namesto tega pošljite [ključ API](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`, to so isti ključi kot pri [HTTP API](/sl/api).

**Cursor** (`~/.cursor/mcp.json` ali `.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 potrebuje `"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: URL Convex `.site` + `/mcp`.

## Datoteke

Bajtov ne pošiljajte prek MCP JSON. Ustvarite URL (`{uploadUrl,storageId}`), datoteko z gostitelja naložite s PUT, nato ustvarite povezavo:

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

Orodja MCP: `files_upload_url` vrne `{uploadUrl,storageId}` → gostitelj izvede PUT na `uploadUrl` → `links_create` s tem `storageId`. Neobvezna kartica predogleda: `previewName`, `previewDescription`, `previewImageStorageId` (enak postopek nalaganja). Neobvezni `maxOpenings` povezavo zaustavi po določenem številu odpiranj; `links_update` ga lahko poviša ali poda `clearMaxOpenings`. `uploadUrl` uporabniku ne izpisujte.

## Orodja

| 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` (brez id) | `GET /shares` | `links_shares` (brez `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 ali editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → cilj; urejevalcu za 30 minut odklene z geslom zaščiteno različico |
| `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` |
| (gostitelj izvede PUT po ustvarjenem URL-ju) | `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 povezava, ki navaja elemente, ki jih vanjo postavite. Model je opisan v razdelku [Mape](/sl/folders).

| Orodje | Vhod |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` ustvari mapo; vsako ustvarjanje sprejme `folder` (slug) in `folderDomain?` za ustvarjanje znotraj mape. Odziv vključuje `folder` |
| `links_list` | Ena stran, `{ items, cursor }` (`limit` 1-100, privzeto 50; `cursor` podajajte nazaj, dokler ni `null`). `q` išče ujemanje besed; `folder: "<slug>"` navede, kar je neposredno v mapi; `folder: "root"` navede najvišjo raven; `kind` doda `folder`. Vrstice vsebujejo `folder`, vrstice map pa `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (enak dostop, nov URL za deljenje, brez oseb) |
| `links_delete` | `contents?: "keep" \| "delete"` za mape (privzeto `keep`) |

`links_export` / `links_import` dodata stolpca `folder` in `access`, vrstice s `kind` `folder` pa ustvarijo mape.

## Dostop in deljenje

Nove povezave in mape so omejene: `url` je `https://linkdash.dev/s/<token>`, ki ga lahko odprete le vi in osebe, s katerimi ga delite. Pri `links_create` ali `links_update` podajte `access`: `restricted` (privzeto), `link` (kdorkoli z URL-jem za deljenje) ali `public` (kdorkoli, na kratkem URL-ju). Zahtevajte `access: "public"`, kadar bo povezava objavljena javno. Glejte [Deljenje in dostop](/sl/sharing).

| Orodje | Vhod |
| --- | --- |
| `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? }` → ena stran vsega, kar ste delili, `{ items, cursor }`, vsak element s `people` |
| `links_shared` | `{ limit?, cursor? }` → ena stran elementov, ki so jih drugi delili z vami, `{ items, cursor }`, z `url` za odpiranje vsakega |
| `links_leave` | `{ id }` (`_id` ali URL za deljenje iz `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` spremeni, kdo jo lahko odpre; `resetShareLink: true` izda nov URL za deljenje (stari preneha delovati) |

Vsak `url` v odzivu je URL za deljenje, razen če je povezava javna – takrat je to kratki URL. Deljenje, preklic deljenja, spremembe dostopa in ponastavitve štejejo vsak kot en dogodek; zapustitev ne.

## Različice

Vsaka povezava je vsebnik ene ali več **različic**: vsebine (`url` | `file` | `text`) z lastnimi omejitvami dostopa (`password`, `starts`, `expires`, `maxOpenings`, zaustavitev), utežjo `weight` in neobveznimi pogoji za obiskovalce `when`. Brez `variants` ima povezava eno različico z imenom `main`. Omejitve dostopa povezave imajo prednost pred omejitvami različic. Obiskovalec dobi eno različico: različice, katerih `when` se ujema, tvorijo nabor (sicer ga tvorijo brezpogojne), nato sledi utežena izbira; `sticky` (privzeto `true`) obdrži obiskovalca, ki se vrne, na isti različici, `restartSplit` pa razdelitev premeša na novo. `kind` povezave je `group`, kadar ima več različic; `status` povezave je `mixed`, kadar se različice razlikujejo. Največ 20 različic na povezavo. Oblike: [HTTP API](/sl/api#različice).

`links_create` namesto skrajšane oblike sprejme `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]`, poleg tega pa še `sticky` in `forwardParams`. `links_update` sprejme `sticky`, `forwardParams` in `restartSplit`. `links_list` filtrira po `kind` (doda `group`) in `status` (doda `mixed`). `links_stats` vrne skupne vrednosti `variants`. `links_export` / `links_import` uporabljata CSV različic (ena vrstica na različico).

| Orodje | Vhod |
| --- | --- |
| `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či `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (polja nizov; ujemati se mora vsak nastavljeni ključ), poleg tega še `params`.

**Pravila za parametre poizvedbe.** `when.params` je polje z največ 10 pravili za niz poizvedbe obiskovalca, pri čemer morajo veljati vsa pravila: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` je seznam, ločen z `|`) | `exists` | `missing` (pri zadnjih dveh brez `value`). Ključi razlikujejo med velikimi in malimi črkami, vrednosti se primerjajo natančno. Vrednosti parametrov se v analitiki nikoli ne shranjujejo.

**Posredovanje parametrov poizvedbe.** `forwardParams` (logična vrednost pri `links_create` / `links_update`, privzeto `false`) različicam URL pripne celoten niz poizvedbe obiskovalca; vrednosti obiskovalca preglasijo shranjene, vključno z `utm`. Samo za različice URL. Gre za usmerjanje, ne za nadzor dostopa.

`auth create` / `auth login` / `auth logout` niso orodja MCP. Preslikava: [api.md](https://linkdash.dev/api.md).
