---
title: MCP
description: >-
  Etä-MCP osoitteessa https://api.linkdash.dev/mcp. Kirjaudu OAuthilla
  Claudesta, ChatGPT:stä, Cursorista ja Codexista tai käytä API-avainta.
sidebar:
  label: MCP
  order: 5
---
Etä-MCP osoitteessa `https://api.linkdash.dev/mcp`. Lisää URL asiakasohjelmaasi ja kirjaudu Linkdash-tililläsi. Jos agentti toimii ilman, että kukaan on selaimen ääressä, käytä sen sijaan [API-avainta](#automation-and-headless-agents). Pelkkä markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Yhdistäminen

Anna asiakasohjelmalle pelkkä URL `https://api.linkdash.dev/mcp`. Se avaa ensin Linkdash-kirjautumisen ja sitten suostumusnäkymän. Näkymässä lukee sovelluksen nimi ja sivusto, jolle se palaa. Kun sallit sen, asiakasohjelma saa tunnisteen (token) tiliisi.

- **claude.ai ja Claude Desktop:** avaa [Linkdash liitinhakemistossa](https://claude.ai/directory/linkdash) (tai valitse Customize → Connectors ja hae Linkdash) ja napsauta **Connect**.
- **ChatGPT:** Linkdash tulee pian ChatGPT:n plugin-hakemistoon. Siihen asti avaa [Plugins](https://chatgpt.com/plugins), valitse **+** → **Add custom MCP server**, syötä yllä oleva URL ja valitse OAuth.
- **Claude Code:** `claude mcp add --transport http linkdash https://api.linkdash.dev/mcp`, sitten `claude mcp login linkdash` (tai `/mcp` istunnossa).
- **Cursor:** [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) asentaa palvelimen yhdellä napsautuksella. Kirjaudu sitten, kun Cursor pyytää. Voit myös lisätä palvelimen tiedostoon `mcp.json` kentällä `"url"` ilman `headers`-kenttää.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp`, sitten `codex mcp login linkdash`.

Sovellus saa samat käyttöoikeudet kuin API-avain. Yhdistetyt sovellukset näkyvät kohdassa [Hallintapaneeli → API-avaimet](https://linkdash.dev/dashboard/keys). Siellä **Katkaise yhteys** peruu niiden oikeudet heti.

## Automaatio ja headless-agentit

Kirjautuminen vaatii, että joku on selaimen ääressä. CI-ajoissa, ajastetuissa agenteissa, palvelimilla ja koodissa, joka kutsuu MCP:tä suoraan, lähetä sen sijaan [API-avain](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Avaimet ovat samat kuin [HTTP API:ssa](/fi/api).

**Cursor** (`~/.cursor/mcp.json` tai `.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 vaatii `"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"`

Paikallisesti: Convexin `.site`-URL + `/mcp`.

## Tiedostot

Älä lähetä tiedoston tavuja MCP:n JSONissa. Luo ensin latausosoite (`{uploadUrl,storageId}`), lähetä tiedosto isännältä PUT-pyynnöllä ja luo sitten linkki:

```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-työkalut: `files_upload_url` palauttaa `{uploadUrl,storageId}` → isäntä tekee PUT-pyynnön osoitteeseen `uploadUrl` → `links_create` saa saman `storageId`:n. Valinnainen esikatselukortti (unfurl): `previewName`, `previewDescription` ja `previewImageStorageId` (kuva ladataan samalla tavalla). Valinnainen `maxOpenings` keskeyttää linkin, kun avauksia on kertynyt annettu määrä. `links_update` voi nostaa rajaa tai poistaa sen `clearMaxOpenings`-kentällä. Älä näytä `uploadUrl`-osoitetta käyttäjälle.

## Työkalut

| 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` (ilman id:tä) | `GET /shares` | `links_shares` (ilman `id`:tä) |
| `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 tai editor) |
| `links_unlock` | `{ id, variant?, password?, variantPassword? }` → kohde; avaa salasanalla suojatun variantin editorille 30 minuutiksi |
| `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` |
| (isännän PUT latausosoitteen luonnin jälkeen) | `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_*` |

## Kansiot

Kansio on linkki, joka listaa siihen lisäämäsi kohteet. Lisätietoa mallista: [Kansiot](/fi/folders).

| Työkalu | Syöte |
| --- | --- |
| `links_create` | `{ kind: "folder", name, … }` luo kansion. Mikä tahansa luontikutsu ottaa vastaan `folder` (slug) ja `folderDomain?`, jolloin kohde luodaan kyseisen kansion sisään. Vastauksessa on `folder` |
| `links_list` | Yksi sivu, `{ items, cursor }` (`limit` 1-100, oletus 50; välitä `cursor` takaisin, kunnes se on `null`). `q` hakee sanoilla. `folder: "<slug>"` listaa kohteet, jotka ovat suoraan kansiossa, ja `folder: "root"` listaa ylimmän tason. `kind` saa lisäarvon `folder`. Jokaisella rivillä on `folder`, ja kansioriveillä on myös `items` |
| `links_move` | `{ id, domain?, folder: string \| null, folderDomain? }` → `{ id, folder }` |
| `links_copy` | `{ id, domain? }` → `{ id, url, access, kind, folder }` (samat käyttöoikeudet, uusi jako-URL, ei jaettuja henkilöitä) |
| `links_delete` | `contents?: "keep" \| "delete"` kansioille (oletus `keep`) |

`links_export` / `links_import` lisäävät sarakkeet `folder` ja `access`. Rivit, joiden `kind` on `folder`, luovat kansioita.

## Käyttöoikeudet ja jakaminen

Uudet linkit ja kansiot ovat rajattuja: `url` on `https://linkdash.dev/s/<token>`, ja sen voivat avata vain sinä ja ne, joille jaat sen. Anna `access` kutsussa `links_create` tai `links_update`: `restricted` (oletus), `link` (kuka tahansa, jolla on jako-URL) tai `public` (kuka tahansa, lyhyessä URL:ssa). Pyydä `access: "public"`, jos linkki julkaistaan avoimesti. Katso [Jakaminen ja käyttöoikeudet](/fi/sharing).

| Työkalu | Syöte |
| --- | --- |
| `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? }` → yksi sivu kaikesta, mitä olet jakanut, `{ items, cursor }`, ja jokaisella kohteella on `people` |
| `links_shared` | `{ limit?, cursor? }` → yksi sivu kohteista, jotka muut ovat jakaneet sinulle, `{ items, cursor }`, ja jokaisella on `url`, jolla sen voi avata |
| `links_leave` | `{ id }` (`_id` tai jako-URL `links_shared`-vastauksesta) → `{ _id, left: true }` |
| `links_update` | `access?` muuttaa, kuka linkin voi avata. `resetShareLink: true` luo uuden jako-URL:n (vanha lakkaa toimimasta) |

Jokaisen vastauksen `url` on jako-URL. Julkisella linkillä se on lyhyt URL. Jakaminen, jaon poistaminen, käyttöoikeuksien muutokset ja nollaukset lasketaan kukin yhdeksi tapahtumaksi. Jaosta poistuminen ei ole tapahtuma.

## Variantit

Jokainen linkki sisältää yhden tai useamman **variantin**. Variantissa on sisältö (`url` | `file` | `text`), oma portti (`password`, `starts`, `expires`, `maxOpenings`, keskeytystila), `weight` ja valinnaiset kävijäehdot `when`. Jos `variants` puuttuu, linkillä on yksi variantti nimeltä `main`. Linkin portti menee varianttien porttien edelle. Kävijä saa yhden variantin näin: ensin valintajoukon muodostavat variantit, joiden `when` täsmää (tai jos mikään ei täsmää, ehdottomat variantit), ja niistä tehdään painotettu valinta. `sticky` (oletus `true`) pitää palaavan kävijän samassa variantissa, ja `restartSplit` arpoo jaon uudelleen. Linkin `kind` on `group`, kun variantteja on useita, ja linkin `status` on `mixed`, kun varianttien tilat eroavat. Linkillä voi olla enintään 20 varianttia. Rakenteet: [HTTP API](/fi/api#variantit).

`links_create` ottaa lyhyen muodon sijaan vastaan `variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }]` sekä `sticky` ja `forwardParams`. `links_update` ottaa vastaan `sticky`, `forwardParams` ja `restartSplit`. `links_list` suodattaa `kind`-kentällä (lisäarvo `group`) ja `status`-kentällä (lisäarvo `mixed`). `links_stats` palauttaa `variants`-kokonaismäärät. `links_export` / `links_import` käyttävät variantti-CSV:tä (yksi rivi per variantti).

| Työkalu | Syöte |
| --- | --- |
| `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`-avaimet: `countries`, `devices`, `os`, `browsers`, `languages`, `referrerHosts` (merkkijonotaulukoita; jokaisen asetetun avaimen on täsmättävä) sekä `params`.

**Kyselyparametrisäännöt.** `when.params` on enintään 10 säännön taulukko, joka kohdistuu kävijän kyselymerkkijonoon. Jokaisen säännön on toteuduttava: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (`value` on `|`-merkillä eroteltu lista) | `exists` | `missing` (kahdessa viimeisessä ei ole `value`-kenttää). Avaimet ovat kirjainkoosta riippuvia, ja arvojen on täsmättävä tarkalleen. Parametrien arvoja ei koskaan tallenneta analytiikkaan.

**Kyselyparametrien välitys.** `forwardParams` (boolean kutsuissa `links_create` / `links_update`, oletus `false`) liittää kävijän koko kyselymerkkijonon URL-variantteihin. Kävijän arvot korvaavat tallennetut arvot, myös `utm`-arvot. Toimii vain URL-varianteissa. Kyse on reitityksestä, ei käyttöoikeuksien hallinnasta.

`auth create` / `auth login` / `auth logout` eivät ole MCP-työkaluja. Vastaavuudet: [api.md](https://linkdash.dev/api.md).
