---
title: MCP
description: >-
  Távoli MCP a https://api.linkdash.dev/mcp címen. Jelentkezz be OAuth-tal a
  Claude-ból, a ChatGPT-ből, a Cursorból és a Codexből, vagy használj
  API-kulcsot.
sidebar:
  label: MCP
  order: 5
---
Távoli MCP a `https://api.linkdash.dev/mcp` címen. Add hozzá az URL-t a kliensedhez, és jelentkezz be a Linkdash-fiókoddal. Ha az agent úgy fut, hogy senki sem ül a böngésző előtt, használj inkább [API-kulcsot](#automation-and-headless-agents). Sima markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Csatlakozás

A kliensnek csak a `https://api.linkdash.dev/mcp` URL-t add meg. Megnyílik egy Linkdash-bejelentkezés, aztán egy hozzájárulási képernyő, amely megmutatja az alkalmazás nevét és azt az oldalt, ahová visszatér. Ha engedélyezed, a kliens kap egy tokent a fiókodhoz.

- **claude.ai és Claude Desktop:** nyisd meg a [Linkdash-t a connector-könyvtárban](https://claude.ai/directory/linkdash) (vagy a Customize → Connectors alatt keress rá a Linkdash-re), és kattints a **Connect** gombra.
- **ChatGPT:** hamarosan megjelenik a ChatGPT plugin-könyvtárában is. Addig a [Plugins](https://chatgpt.com/plugins) oldalon válaszd a **+** → **Add custom MCP server** lehetőséget, add meg a fenti URL-t, és válaszd az OAuth-ot.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, aztán `claude mcp login linkdash` (vagy `/mcp` egy sessionön belül).
- **Cursor:** az [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) egy kattintással telepíti, utána jelentkezz be, amikor a Cursor kéri. Vagy add hozzá a szervert az `mcp.json` fájlhoz `"url"` mezővel, `headers` nélkül.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, aztán `codex mcp login linkdash`.

Az alkalmazás ugyanazt a hozzáférést kapja, mint egy API-kulcs. A csatlakoztatott alkalmazásokat a [Irányítópult → API-kulcsok](https://linkdash.dev/dashboard/keys) alatt találod, ahol a **Leválasztás** azonnal visszavonja őket.

## Automatizálás és headless agentek

A bejelentkezéshez kell valaki a böngésző előtt. CI-jobokhoz, ütemezett agentekhez, szerverekhez és olyan kódhoz, amely közvetlenül hívja az MCP-t, inkább [API-kulcsot](https://linkdash.dev/dashboard/keys) küldj: `Authorization: Bearer ldash_...`, ugyanazokat a kulcsokat, mint a [HTTP API](/hu/api) esetén.

**Cursor** (`~/.cursor/mcp.json` vagy `.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 esetén kell a `"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álisan: a Convex `.site` URL + `/mcp`.

## Fájlok

Ne küldj bájtokat az MCP JSON-on keresztül. Kérj egy URL-t (`{uploadUrl,storageId}`), PUT-tal töltsd fel a fájlt a hostról, aztán hozd létre a linket:

```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-toolok: a `files_upload_url` visszaadja a `{uploadUrl,storageId}` értéket → a host PUT-tal feltölt az `uploadUrl` címre → `links_create` ezzel a `storageId` értékkel. Opcionális előnézeti kártya: `previewName`, `previewDescription`, `previewImageStorageId` (ugyanígy feltöltve). Az opcionális `maxOpenings` ennyi megnyitás után szünetelteti a linket; a `links_update` megemelheti, vagy átadhatod a `clearMaxOpenings` értéket. Az `uploadUrl` címet ne írd ki a felhasználónak.

## Toolok

| 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` (id nélkül) | `GET /shares` | `links_shares` (`id` nélkül) |
| `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 vagy editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → a cél; egy jelszóval védett variánst old fel egy editor számára 30 percre |
| `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 az URL kérése után) | `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_*` |

## Mappák

A mappa egy olyan link, amely felsorolja a beletett elemeket. A modellről a [Mappák](/hu/folders) oldalon olvashatsz.

| Tool | Bemenet |
| --- | --- |
| `links_create` | A `{ kind: "folder", name, … }` mappát hoz létre; bármelyik létrehozás elfogadja a `folder` (slug) és a `folderDomain?` mezőt, ha egy mappán belül akarsz létrehozni. A válasz tartalmazza a `folder` mezőt |
| `links_list` | Egy oldal, `{ items, cursor }` (`limit` 1-100, alapértelmezés 50; add vissza a `cursor` értéket, amíg `null` nem lesz). A `q` szavakra illeszt; a `folder: "<slug>"` azt listázza, ami közvetlenül benne van; a `folder: "root"` a legfelső szintet listázza; a `kind` kiegészül a `folder` értékkel. A sorok tartalmazzák a `folder` mezőt, a mappasorok pedig az `items` mezőt |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (ugyanaz a hozzáférés, új megosztási URL, emberek nélkül) |
| `links_delete` | `contents?: "keep" \| "delete"` mappák esetén (alapértelmezés: `keep`) |

A `links_export` / `links_import` kiegészül a `folder` és az `access` oszloppal, a `folder` `kind` értékű sorok pedig mappákat hoznak létre.

## Hozzáférés és megosztás

Az új linkek és mappák korlátozottak: az `url` értéke `https://linkdash.dev/s/<token>`, amelyet csak te és azok nyithatnak meg, akikkel megosztod. Add meg az `access` mezőt a `links_create` vagy a `links_update` hívásnál: `restricted` (alapértelmezés), `link` (bárki, akinél megvan a megosztási URL) vagy `public` (bárki, a rövid URL-en). Kérj `access: "public"` beállítást, ha a linket nyilvánosan teszed közzé. Lásd: [Megosztás és hozzáférés](/hu/sharing).

| Tool | Bemenet |
| --- | --- |
| `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? }` → egy oldal mindabból, amit megosztottál, `{ items, cursor }`, mindegyik `people` mezővel |
| `links_shared` | `{ limit?, cursor? }` → egy oldal azokból az elemekből, amelyeket mások osztottak meg veled, `{ items, cursor }`, mindegyikhez az `url`, amellyel megnyithatod |
| `links_leave` | `{ id }` (a `links_shared` által adott `_id` vagy megosztási URL) → `{ _id, left: true }` |
| `links_update` | Az `access?` azt módosítja, ki nyithatja meg; a `resetShareLink: true` új megosztási URL-t ad ki (a régi megszűnik működni) |

Minden válaszban az `url` a megosztási URL, kivéve, ha a link nyilvános, ilyenkor a rövid URL. A megosztás, a megosztás visszavonása, a hozzáférés módosítása és a reset egyenként egy eseménynek számít; a kilépés nem.

## Variánsok

Minden link egy vagy több **variáns** tárolója: tartalom (`url` | `file` | `text`), plusz saját kapu (`password`, `starts`, `expires`, `maxOpenings`, szüneteltetve), egy `weight`, és opcionális látogatói feltételek (`when`). `variants` nélkül a linknek egyetlen, `main` nevű variánsa van. A link kapuja erősebb a variánsok kapuinál. A látogató egy variánst kap: azok a variánsok alkotják a készletet, amelyeknek a `when` feltétele illeszkedik (különben a feltétel nélküliek), majd súlyozott választás következik; a `sticky` (alapértelmezés: `true`) a visszatérő látogatót ugyanazon a variánson tartja, a `restartSplit` pedig újrakeveri az elosztást. Több variáns esetén a link `kind` értéke `group`; ha a variánsok eltérnek, a link `status` értéke `mixed`. Linkenként legfeljebb 20 variáns lehet. Formátumok: [HTTP API](/hu/api#változatok).

A `links_create` a rövidített forma helyett `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` értéket fogad, plusz `sticky` és `forwardParams` mezőt. A `links_update` a `sticky`, `forwardParams` és `restartSplit` mezőt fogadja. A `links_list` szűr `kind` (kiegészül a `group` értékkel) és `status` (kiegészül a `mixed` értékkel) szerint. A `links_stats` visszaadja a `variants` összesítéseket. A `links_export` / `links_import` a variáns-CSV-t használja (variánsonként egy sor).

| Tool | Bemenet |
| --- | --- |
| `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? }` |

A `when` kulcsai: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (stringtömbök; minden megadott kulcsnak illeszkednie kell), plusz `params`.

**Query paraméter szabályok.** A `when.params` legfeljebb 10 szabályból álló tömb a látogató query stringjére, és minden szabálynak teljesülnie kell: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (a `value` egy `|` jellel elválasztott lista) | `exists` | `missing` (az utolsó kettőnél nincs `value`). A kulcsok kis- és nagybetű-érzékenyek, az értékeket pontos egyezéssel hasonlítja össze. A paraméterértékeket soha nem tárolja az analitika.

**Query paraméterek továbbítása.** A `forwardParams` (boolean a `links_create` / `links_update` hívásnál, alapértelmezés: `false`) a látogató teljes query stringjét hozzáfűzi az URL-variánsokhoz; a látogató értékei felülírják a tároltakat, az `utm` értékeit is beleértve. Csak URL-variánsokra vonatkozik. Ez útválasztás, nem hozzáférés-szabályozás.

Az `auth create` / `auth login` / `auth logout` nem MCP-toolok. Megfeleltetés: [api.md](https://linkdash.dev/api.md).
