---
title: MCP
description: >-
  Отдалечен MCP сървър на https://api.linkdash.dev/mcp. Влезте с OAuth от
  Claude, ChatGPT, Cursor и Codex или използвайте API ключ.
sidebar:
  label: MCP
  order: 5
---
Отдалечен MCP сървър на `https://api.linkdash.dev/mcp`. Добавете URL адреса в клиента си и влезте с акаунта си в Linkdash. Някои агенти работят без човек пред браузъра. За тях използвайте [API ключ](#automation-and-headless-agents). Обикновен markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Свързване

Подайте на клиента само URL адреса `https://api.linkdash.dev/mcp`. Клиентът отваря вход в Linkdash, а след това екран за съгласие. На този екран са посочени приложението и сайтът, към който то ще се върне. Разрешете достъпа и клиентът ще получи токен за вашия акаунт.

- **claude.ai и Claude Desktop:** отворете [Linkdash в директорията с конектори](https://claude.ai/directory/linkdash) (или Customize → Connectors и потърсете Linkdash) и щракнете **Connect**.
- **ChatGPT:** скоро Linkdash ще бъде добавен в директорията с плъгини на ChatGPT. Дотогава отворете [Plugins](https://chatgpt.com/plugins), изберете **+** → **Add custom MCP server**, въведете горния URL адрес и изберете OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, след това `claude mcp login linkdash` (или `/mcp` в сесия).
- **Cursor:** [Добавяне в Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) го инсталира с едно щракване. След това влезте, когато Cursor поиска. Можете и да добавите сървъра в `mcp.json` с `"url"` и без `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, след това `codex mcp login linkdash`.

Приложението получава същия достъп като API ключ. Свързаните приложения са изброени в [Табло → API ключове](https://linkdash.dev/dashboard/keys). Там **Прекъсване** отнема достъпа им веднага.

## Автоматизация и агенти без интерфейс

За влизането е нужен човек пред браузъра. За CI задачи, планирани агенти, сървъри и код, който извиква MCP директно, изпращайте [API ключ](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Това са същите ключове като за [HTTP API](/bg/api).

**Cursor** (`~/.cursor/mcp.json` или `.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 е нужно `"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"`

Локално: URL адресът `.site` на Convex + `/mcp`.

## Файлове

Не изпращайте байтове през MCP JSON. Генерирайте URL адрес (`{uploadUrl,storageId}`) и качете файла от хоста с PUT. След това създайте линка:

```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 инструменти: `files_upload_url` връща `{uploadUrl,storageId}` → хостът прави PUT към `uploadUrl` → `links_create` с този `storageId`. Незадължителна карта за преглед (unfurl): `previewName`, `previewDescription`, `previewImageStorageId` (със същото качване). Незадължителният `maxOpenings` спира линка на пауза след посочения брой отваряния. `links_update` може да увеличи лимита или да подаде `clearMaxOpenings`. Не показвайте `uploadUrl` на потребителя.

## Инструменти

| 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) | `GET /shares` | `links_shares` (без `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 или editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → целта; отключва защитен с парола вариант за редактор за 30 минути |
| `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 от хоста след генериране на 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_*` |

## Папки

Папката е линк, който изброява елементите, поставени в нея. Моделът е описан в [Папки](/bg/folders).

| Инструмент | Вход |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` създава папка. Всяко създаване приема `folder` (slug) и `folderDomain?`, за да създаде елемента в папка. Отговорът включва `folder` |
| `links_list` | Една страница, `{ items, cursor }` (`limit` 1-100, по подразбиране 50; подавайте обратно `cursor`, докато стойността му не стане `null`). `q` търси по думи; `folder: "<slug>"` изброява елементите директно в папката; `folder: "root"` изброява най-горното ниво; `kind` приема и стойност `folder`. Редовете съдържат `folder`, а редовете за папки съдържат и `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (същият достъп, нов URL адрес за споделяне, без хора) |
| `links_delete` | `contents?: "keep" \| "delete"` за папки (по подразбиране `keep`) |

`links_export` / `links_import` добавят колони `folder` и `access`, а редовете с `kind` `folder` създават папки.

## Достъп и споделяне

Новите линкове и папки са с ограничен достъп. Тяхното `url` е `https://linkdash.dev/s/<token>` и само вие и хората, с които споделяте, могат да го отварят. Подайте `access` в `links_create` или `links_update`: `restricted` (по подразбиране), `link` (всеки с URL адреса за споделяне) или `public` (всеки, на краткия URL адрес). Задайте `access: "public"`, когато линкът ще се публикува публично. Вижте [Споделяне и достъп](/bg/sharing).

| Инструмент | Вход |
| --- | --- |
| `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? }` → една страница с всичко, което сте споделили, `{ items, cursor }`, всеки елемент с `people` |
| `links_shared` | `{ limit?, cursor? }` → една страница с елементи, които други хора са споделили с вас, `{ items, cursor }`, с `url` за отваряне на всеки |
| `links_leave` | `{ id }` (`_id` или URL адресът за споделяне от `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` променя кой може да отваря линка; `resetShareLink: true` издава нов URL адрес за споделяне (старият спира да работи) |

Полето `url` във всеки отговор е URL адресът за споделяне. Ако линкът е публичен, то е краткият URL адрес. Споделянето, премахването на споделяне, промените в достъпа и нулиранията се отчитат като по едно събитие. Напускането не се отчита.

## Варианти

Всеки линк е контейнер с един или повече **варианти**. Всеки вариант има:

- съдържание (`url` | `file` | `text`);
- собствени ограничения за достъп (`password`, `starts`, `expires`, `maxOpenings`, пауза);
- тегло `weight`;
- незадължителни условия за посетителя `when`.

Без `variants` линкът има един вариант с име `main`. Ограниченията на линка имат предимство пред тези на вариантите.

Всеки посетител получава един вариант. Пулът се формира от вариантите, чието `when` съвпада. Ако няма такива, пулът се формира от безусловните варианти. След това се прави претеглен избор. `sticky` (по подразбиране `true`) задържа завърналия се посетител на същия вариант, а `restartSplit` преразпределя посетителите наново.

Когато линкът има няколко варианта, неговият `kind` е `group`. Когато вариантите се различават, `status` на линка е `mixed`. Един линк може да има най-много 20 варианта. Структурите са описани в [HTTP API](/bg/api#варианти).

`links_create` приема `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` вместо съкратения запис, както и `sticky` и `forwardParams`. `links_update` приема `sticky`, `forwardParams` и `restartSplit`. `links_list` филтрира по `kind` (добавя `group`) и по `status` (добавя `mixed`). `links_stats` връща обобщени стойности за `variants`. `links_export` / `links_import` използват CSV формата за варианти (по един ред на вариант).

| Инструмент | Вход |
| --- | --- |
| `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? }` |

Ключове на `when`: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (масиви от низове; всеки зададен ключ трябва да съвпада), както и `params`.

**Правила за параметрите на заявката.** `when.params` е масив от до 10 правила за query низа на посетителя. Всички правила трябва да са изпълнени: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` е списък, разделен с `|`) | `exists` | `missing` (последните два не приемат `value`). Ключовете са чувствителни към регистъра, а стойностите се сравняват точно. Стойностите на параметрите никога не се съхраняват в анализите.

**Препращане на параметрите на заявката.** `forwardParams` е булева стойност в `links_create` / `links_update` (по подразбиране `false`). Тя добавя целия query низ на посетителя към URL вариантите. Стойностите на посетителя заместват съхранените, включително `utm`. Работи само за URL варианти. Служи за маршрутизиране, а не за контрол на достъпа.

`auth create` / `auth login` / `auth logout` не са MCP инструменти. Съответствие: [api.md](https://linkdash.dev/api.md).
