---
title: MCP
description: >-
  Attālais MCP adresē https://api.linkdash.dev/mcp. Pierakstieties ar OAuth no
  Claude, ChatGPT, Cursor un Codex vai izmantojiet API atslēgu.
sidebar:
  label: MCP
  order: 5
---
Attālais MCP adresē `https://api.linkdash.dev/mcp`. Pievienojiet URL savam klientam un pierakstieties ar savu Linkdash kontu. Ja aģents darbojas bez cilvēka pie pārlūkprogrammas, izmantojiet [API atslēgu](#automation-and-headless-agents). Vienkāršs markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Pievienošana

Norādiet klientam tikai URL `https://api.linkdash.dev/mcp`. Tas atvērs Linkdash pierakstīšanās lapu un pēc tam piekrišanas ekrānu. Šajā ekrānā ir norādīta lietotne un vietne, uz kuru tā atgriezīsies. Atļaujiet piekļuvi, un klients saņems jūsu konta marķieri.

- **claude.ai un Claude Desktop:** atveriet [Linkdash savienotāju katalogā](https://claude.ai/directory/linkdash) (vai Customize → Connectors un meklējiet Linkdash) un noklikšķiniet uz **Connect**.
- **ChatGPT:** ieraksts ChatGPT spraudņu katalogā būs pieejams drīzumā. Līdz tam sadaļā [Plugins](https://chatgpt.com/plugins) izvēlieties **+** → **Add custom MCP server**, ievadiet iepriekš norādīto URL un izvēlieties OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, pēc tam `claude mcp login linkdash` (vai `/mcp` sesijā).
- **Cursor:** [Pievienot Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) to instalē ar vienu klikšķi. Pēc tam pierakstieties, kad Cursor to pieprasa. Vai arī pievienojiet serveri failam `mcp.json` ar `"url"` un bez `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, pēc tam `codex mcp login linkdash`.

Lietotne iegūst tādu pašu piekļuvi kā API atslēga. Pievienotās lietotnes ir redzamas sadaļā [Vadības panelis → API atslēgas](https://linkdash.dev/dashboard/keys). Tur ar **Atvienot** to piekļuvi var nekavējoties atsaukt.

## Automatizācija un aģenti bez saskarnes

Pierakstīšanās prasa cilvēku pie pārlūkprogrammas. CI uzdevumiem, ieplānotiem aģentiem, serveriem un kodam, kas tieši izsauc MCP, sūtiet [API atslēgu](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Tās ir tās pašas atslēgas, ko izmanto [HTTP API](/lv/api).

**Cursor** (`~/.cursor/mcp.json` vai `.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 konfigurācijā nepieciešams `"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"`

Lokāli: Convex `.site` URL + `/mcp`.

## Faili

Nesūtiet baitus caur MCP JSON. Izveidojiet URL (`{uploadUrl,storageId}`), augšupielādējiet failu no resursdatora ar PUT un pēc tam izveidojiet saiti:

```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 rīki: `files_upload_url` atgriež `{uploadUrl,storageId}` → resursdators veic PUT uz `uploadUrl` → `links_create` ar šo `storageId`. Neobligāta priekšskatījuma kartīte: `previewName`, `previewDescription`, `previewImageStorageId` (augšupielādē tāpat). Ja norādāt neobligāto `maxOpenings`, saite tiek apturēta pēc tik daudzām atvēršanas reizēm. Ar `links_update` šo skaitu var palielināt vai nodot `clearMaxOpenings`. Nerādiet `uploadUrl` lietotājam.

## Rīki

| 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` (bez id) | `GET /shares` | `links_shares` (bez `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 vai editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → mērķis; atbloķē ar paroli aizsargātu variantu redaktoram uz 30 minūtēm |
| `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` |
| (resursdators veic PUT pēc URL izveides) | `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_*` |

## Mapes

Mape ir saite, kurā uzskaitīti tajā ievietotie vienumi. Modeļa aprakstu skatiet sadaļā [Mapes](/lv/folders).

| Rīks | Ievade |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` izveido mapi. Jebkurai izveides darbībai var norādīt `folder` (slug) un `folderDomain?`, lai vienumu izveidotu mapē. Atbildē ir iekļauts `folder` |
| `links_list` | Viena lapa, `{ items, cursor }` (`limit` 1-100, noklusējums 50; nododiet `cursor` atpakaļ, līdz tas ir `null`). `q` meklē pēc vārdiem; `folder: "<slug>"` uzskaita mapes tiešo saturu; `folder: "root"` uzskaita augstāko līmeni; `kind` pieļauj vērtību `folder`. Rindās ir `folder`, un mapju rindās ir `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (tāda pati piekļuve, jauns kopīgošanas URL, bez personām) |
| `links_delete` | `contents?: "keep" \| "delete"` mapēm (noklusējums `keep`) |

`links_export` / `links_import` pievieno kolonnas `folder` un `access`. Rindas, kurās `kind` ir `folder`, izveido mapes.

## Piekļuve un kopīgošana

Jaunas saites un mapes ir ierobežotas: `url` ir `https://linkdash.dev/s/<token>`, un to var atvērt tikai jūs un personas, ar kurām to kopīgojat. Norādiet `access` izsaukumā `links_create` vai `links_update`. Iespējamās vērtības: `restricted` (noklusējums), `link` (ikviens, kam ir kopīgošanas URL) vai `public` (ikviens, izmantojot īso URL). Pieprasiet `access: "public"`, ja saite tiks publicēta publiski. Skatiet [Kopīgošana un piekļuve](/lv/sharing).

| Rīks | Ievade |
| --- | --- |
| `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? }` → viena lapa ar visu jūsu kopīgoto saturu, `{ items, cursor }`, katram vienumam ar `people` |
| `links_shared` | `{ limit?, cursor? }` → viena lapa ar vienumiem, ko citi ir kopīgojuši ar jums, `{ items, cursor }`, katram vienumam ar `url` tā atvēršanai |
| `links_leave` | `{ id }` (`_id` vai kopīgošanas URL no `links_shared`) → `{ _id, left: true }` |
| `links_update` | `access?` nosaka, kas var to atvērt; `resetShareLink: true` izsniedz jaunu kopīgošanas URL (vecais vairs nedarbojas) |

Katras atbildes `url` ir kopīgošanas URL. Ja saite ir publiska, tas ir īsais URL. Kopīgošana, kopīgošanas atcelšana, piekļuves izmaiņas un atiestatīšana katra tiek uzskaitīta kā viens notikums, bet aiziešana netiek.

## Varianti

Katra saite ir viena vai vairāku **variantu** konteiners. Katram variantam ir saturs (`url` | `file` | `text`), savi piekļuves nosacījumi (`password`, `starts`, `expires`, `maxOpenings`, apturēts), `weight` un neobligāti apmeklētāja nosacījumi `when`. Bez `variants` saitei ir viens variants ar nosaukumu `main`. Saites nosacījumiem ir prioritāte pār variantu nosacījumiem. Apmeklētājs saņem vienu variantu. Varianti, kuru `when` atbilst, veido kopu (ja tādu nav, kopu veido varianti bez nosacījumiem), un no tās tiek veikta svērta izvēle. `sticky` (noklusējums `true`) saglabā atgriezušos apmeklētāju pie tā paša varianta, bet `restartSplit` sadalījumu veic no jauna. Saites `kind` ir `group`, ja variantu ir vairāki. Saites `status` ir `mixed`, ja variantu statusi atšķiras. Vienai saitei var būt ne vairāk kā 20 variantu. Struktūras: [HTTP API](/lv/api#varianti).

`links_create` saīsinātā pieraksta vietā pieņem `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]`, kā arī `sticky` un `forwardParams`. `links_update` pieņem `sticky`, `forwardParams` un `restartSplit`. `links_list` filtrē pēc `kind` (papildu vērtība `group`) un `status` (papildu vērtība `mixed`). `links_stats` atgriež `variants` kopsummas. `links_export` / `links_import` izmanto variantu CSV (viena rinda katram variantam).

| Rīks | Ievade |
| --- | --- |
| `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` atslēgas: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (virkņu masīvi; jāatbilst katrai norādītajai atslēgai), kā arī `params`.

**Vaicājuma parametru noteikumi.** `when.params` ir masīvs ar ne vairāk kā 10 noteikumiem apmeklētāja vaicājuma virknei, un jāizpildās katram noteikumam: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` ir ar `|` atdalīts saraksts) | `exists` | `missing` (pēdējiem diviem `value` nenorāda). Atslēgās tiek ņemts vērā lielo un mazo burtu reģistrs, un vērtības tiek salīdzinātas precīzi. Parametru vērtības analītikā nekad netiek saglabātas.

**Vaicājuma parametru pārsūtīšana.** `forwardParams` ir Būla vērtība izsaukumos `links_create` / `links_update` (noklusējums `false`). Tā pievieno apmeklētāja pilno vaicājuma virkni URL variantiem. Apmeklētāja vērtības aizstāj saglabātās, arī `utm`. Darbojas tikai URL variantiem. Tā ir maršrutēšana, nevis piekļuves kontrole.

`auth create` / `auth login` / `auth logout` nav MCP rīki. Atbilstība: [api.md](https://linkdash.dev/api.md).
