Към съдържанието
LinkdashLinkdash
Български
Esc
↑↓навигация↵отвори⌘Jпреглед
На тази страница

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.

Беше ли полезна тази страница?