---
title: MCP
description: >-
  https://api.linkdash.dev/mcp のリモート MCP です。Claude、ChatGPT、Cursor、Codex から OAuth
  でサインインするか、API キーを使用します。
sidebar:
  label: MCP
  order: 5
---
リモート MCP は `https://api.linkdash.dev/mcp` で提供されています。クライアントにこの URL を追加し、Linkdash アカウントでサインインしてください。ブラウザを操作する人がいない環境で動作するエージェントでは、代わりに [API キー](#automation-and-headless-agents) を使用してください。プレーンな Markdown 版: [mcp.md](https://linkdash.dev/mcp.md)。

## 接続

クライアントには URL `https://api.linkdash.dev/mcp` だけを指定します。Linkdash のサインイン画面が開き、続いて同意画面が開きます。同意画面には、アプリ名と認証後に戻るサイトが表示されます。許可すると、クライアントはあなたのアカウント用のトークンを取得します。

- **claude.ai と Claude Desktop:** [コネクタディレクトリの Linkdash](https://claude.ai/directory/linkdash) を開き（または Customize → Connectors で Linkdash を検索し）、**Connect** をクリックします。
- **ChatGPT:** ChatGPT プラグインディレクトリへの掲載は近日予定です。それまでは、[Plugins](https://chatgpt.com/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](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) からワンクリックでインストールし、Cursor に求められたらサインインします。または、`"url"` を指定し、`headers` を指定せずに `mcp.json` にサーバーを追加します。
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp` を実行してから、`codex mcp login linkdash` を実行します。

アプリには API キーと同じアクセス権が付与されます。接続済みのアプリは [ダッシュボード → API キー](https://linkdash.dev/dashboard/keys) に一覧表示され、**接続を解除** で即座に取り消せます。

## 自動化とヘッドレスエージェント

サインインには、ブラウザを操作する人が必要です。CI ジョブ、スケジュール実行されるエージェント、サーバー、MCP を直接呼び出すコードでは、代わりに [API キー](https://linkdash.dev/dashboard/keys) を送信してください: `Authorization: Bearer ldash_...`。これは [HTTP API](/ja/api) と同じキーです。

**Cursor**（`~/.cursor/mcp.json` または `.cursor/mcp.json`）:

```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 してから、リンクを作成します:

```bash
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_*` |

## フォルダー

フォルダーとは、中に入れたアイテムを一覧表示するリンクです。仕組みについては [フォルダー](/ja/folders) を参照してください。

| ツール | 入力 |
| --- | --- |
| `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"` を指定してください。詳しくは [共有とアクセス](/ja/sharing) を参照してください。

| ツール | 入力 |
| --- | --- |
| `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](/ja/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](https://linkdash.dev/api.md)。
