跳到内容
LinkdashLinkdash
简体中文
Esc
↑↓导航↵打开⌘J预览
本页内容

MCP

远程 MCP 地址为 https://api.linkdash.dev/mcp。可在 Claude、ChatGPT、Cursor 和 Codex 中通过 OAuth 登录,也可以使用 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:**ChatGPT 插件目录中的 Linkdash 条目即将上线。在此之前,请在 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"

本地开发:使用 Convex 的 .site URL 加上 /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 → 使用该 storageId 调用 links_create。可选的链接预览卡片字段: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
(生成 URL 后由宿主环境 PUT) 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>,只有你和你分享给的人才能打开。可在 links_create 或 links_update 中传入 access:restricted(默认)、link(任何拥有分享 URL 的人)或 public(任何人,通过短链接访问)。如果链接要公开发布,请使用 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 }(来自 links_shared 的 _id 或分享 URL)→ { _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。

这个页面有帮助吗?