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: кнопка Add to 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.
Файлы
Не передавайте байты файла через JSON MCP. Получите 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. Необязательная карточка превью: 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 правил для строки запроса посетителя; должно выполняться каждое правило: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (value — список, разделённый |) | exists | missing (для двух последних value не указывается). Ключи чувствительны к регистру, значения сравниваются точно. Значения параметров никогда не сохраняются в аналитике.
Передача параметров запроса. forwardParams (логическое значение в links_create / links_update, по умолчанию false) добавляет всю строку запроса посетителя к URL-вариантам; значения посетителя переопределяют сохранённые, включая utm. Только для URL-вариантов. Это маршрутизация, а не управление доступом.
auth create / auth login / auth logout не являются инструментами MCP. Соответствие: api.md.

