コンテンツにスキップ
LinkdashLinkdash
日本語
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

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。

このページは役に立ちましたか?