MCP
Отдалечен MCP сървър на https://api.linkdash.dev/mcp. Влезте с OAuth от Claude, ChatGPT, Cursor и Codex или използвайте API ключ.
Отдалечен MCP сървър на https://api.linkdash.dev/mcp. Добавете URL адреса в клиента си и влезте с акаунта си в Linkdash. Някои агенти работят без човек пред браузъра. За тях използвайте API ключ. Обикновен markdown: mcp.md.
Свързване
Подайте на клиента само URL адреса https://api.linkdash.dev/mcp. Клиентът отваря вход в Linkdash, а след това екран за съгласие. На този екран са посочени приложението и сайтът, към който то ще се върне. Разрешете достъпа и клиентът ще получи токен за вашия акаунт.
- claude.ai и Claude Desktop: отворете Linkdash в директорията с конектори (или Customize → Connectors и потърсете Linkdash) и щракнете Connect.
- ChatGPT: скоро Linkdash ще бъде добавен в директорията с плъгини на ChatGPT. Дотогава отворете 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 го инсталира с едно щракване. След това влезте, когато Cursor поиска. Можете и да добавите сървъра в
mcp.jsonс"url"и безheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, след товаcodex mcp login linkdash.
Приложението получава същия достъп като API ключ. Свързаните приложения са изброени в Табло → API ключове. Там Прекъсване отнема достъпа им веднага.
Автоматизация и агенти без интерфейс
За влизането е нужен човек пред браузъра. За CI задачи, планирани агенти, сървъри и код, който извиква MCP директно, изпращайте API ключ: Authorization: Bearer ldash_.... Това са същите ключове като за HTTP API.
Cursor (~/.cursor/mcp.json или .cursor/mcp.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. След това създайте линка:
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_* |
Папки
Папката е линк, който изброява елементите, поставени в нея. Моделът е описан в Папки.
| Инструмент | Вход |
|---|---|
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", когато линкът ще се публикува публично. Вижте Споделяне и достъп.
| Инструмент | Вход |
|---|---|
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.
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.

