MCP
https://api.linkdash.dev/mcp のリモート 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 プラグインディレクトリへの掲載は近日予定です。それまでは、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 に求められたらサインインします。または、
"url"を指定し、headersを指定せずにmcp.jsonにサーバーを追加します。 - 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} を返す → ホストが uploadUrl に PUT する → その 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(スラッグ)と folderDomain? を指定すると、そのフォルダー内に作成できます。レスポンスには folder が含まれます |
links_list |
1 ページ分の { items, cursor } を返します(limit は 1〜100、デフォルトは 50。cursor が null になるまで、返された cursor を渡し続けます)。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(短縮 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? } を渡すと、あなたが共有したすべてのアイテムを 1 ページ分 { items, cursor } で返します(各アイテムに people が含まれます) |
links_shared |
{ limit?, cursor? } → 他のユーザーがあなたと共有したアイテムを 1 ページ分 { items, cursor } で返します(各アイテムを開くための url が含まれます) |
links_leave |
{ id }(links_shared から取得した _id または共有 URL)→ { _id, left: true } |
links_update |
access? で開けるユーザーを変更します。resetShareLink: true で新しい共有 URL を発行します(古い URL は使えなくなります) |
レスポンスの url は共有 URL です。ただし、リンクが公開されている場合は短縮 URL になります。共有、共有解除、アクセス変更、リセットはそれぞれ 1 件のイベントとして記録されますが、共有からの退出は記録されません。
バリアント
すべてのリンクは、1 つ以上の バリアント を格納するコンテナです。バリアントは、コンテンツ(url | file | text)、バリアント独自のゲート(password、starts、expires、maxOpenings、一時停止)、weight、およびオプションの訪問者条件 when で構成されます。variants を指定しない場合、リンクには main という名前のバリアントが 1 つだけ作成されます。リンクのゲートは、バリアントのゲートより優先されます。訪問者には 1 つのバリアントが割り当てられます。when が一致するバリアントが候補になり(一致するものがなければ条件なしのバリアントが候補になります)、その中から重み付きで 1 つ選ばれます。sticky(デフォルトは true)を有効にすると、再訪問者には同じバリアントが割り当てられます。restartSplit を使うと割り当てがやり直されます。複数のバリアントを持つリンクの kind は group になり、バリアント間で状態が異なる場合、リンクの status は mixed になります。バリアントは 1 リンクあたり最大 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(バリアントごとに 1 行)を使用します。
| ツール | 入力 |
|---|---|
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 を指定できます(最後の 2 つでは value は指定しません)。キーは大文字と小文字が区別され、値は完全一致で比較されます。パラメーターの値がアナリティクスに保存されることはありません。
クエリパラメーターの転送。 forwardParams(links_create / links_update で指定するブール値、デフォルトは false)を有効にすると、訪問者のクエリ文字列全体が URL バリアントの URL に付加されます。保存されている値と重複する場合は、utm を含めて訪問者の値が優先されます。対象は URL バリアントのみです。この機能はルーティング用であり、アクセス制御には使えません。
auth create / auth login / auth logout は MCP ツールではありません。対応表: api.md。

