---
title: MCP
description: >-
  Απομακρυσμένος MCP server στο https://api.linkdash.dev/mcp. Συνδεθείτε με
  OAuth από Claude, ChatGPT, Cursor και Codex ή χρησιμοποιήστε ένα API key.
sidebar:
  label: MCP
  order: 5
---
Απομακρυσμένος MCP server στο `https://api.linkdash.dev/mcp`. Προσθέστε το URL στον client σας και συνδεθείτε με τον λογαριασμό σας στο Linkdash. Για agents που εκτελούνται χωρίς κάποιον μπροστά σε browser, χρησιμοποιήστε αντί αυτού ένα [API key](#automation-and-headless-agents). Απλό markdown: [mcp.md](https://linkdash.dev/mcp.md).

## Σύνδεση

Δώστε στον client μόνο το URL `https://api.linkdash.dev/mcp`. Ο client ανοίγει τη σελίδα σύνδεσης του Linkdash και μετά μια οθόνη συναίνεσης. Η οθόνη αυτή δείχνει το όνομα της εφαρμογής και τον ιστότοπο στον οποίο θα επιστρέψετε. Εγκρίνετε την πρόσβαση και ο client θα λάβει ένα token για τον λογαριασμό σας.

- **claude.ai και Claude Desktop:** ανοίξτε το [Linkdash στον κατάλογο connectors](https://claude.ai/directory/linkdash) (ή μεταβείτε στο Customize → Connectors και αναζητήστε το Linkdash) και κάντε κλικ στο **Connect**.
- **ChatGPT:** σύντομα θα υπάρχει καταχώριση στον κατάλογο plugins του 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` μέσα σε ένα session).
- **Cursor:** το [Add to Cursor](https://cursor.com/install-mcp?name=linkdash&config=eyJ1cmwiOiJodHRwczovL2FwaS5saW5rZGFzaC5kZXYvbWNwIn0%3D) το εγκαθιστά με ένα κλικ. Μετά συνδεθείτε όταν σας το ζητήσει το Cursor. Εναλλακτικά, προσθέστε τον server στο `mcp.json` με `"url"` και χωρίς `headers`.
- **Codex:** `codex mcp add linkdash --url https://api.linkdash.dev/mcp` και μετά `codex mcp login linkdash`.

Η εφαρμογή αποκτά την ίδια πρόσβαση με ένα API key. Οι συνδεδεμένες εφαρμογές εμφανίζονται στο [Πίνακας ελέγχου → Κλειδιά API](https://linkdash.dev/dashboard/keys). Εκεί το **Αποσύνδεση** ανακαλεί αμέσως την πρόσβασή τους.

## Αυτοματοποίηση και headless agents

Η σύνδεση με OAuth απαιτεί κάποιον μπροστά σε browser. Για CI jobs, προγραμματισμένους agents, servers και κώδικα που καλεί απευθείας το MCP, στείλτε αντί αυτού ένα [API key](https://linkdash.dev/dashboard/keys): `Authorization: Bearer ldash_...`. Είναι τα ίδια keys με αυτά του [HTTP API](/el/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`.

## Αρχεία

Μην στέλνετε bytes μέσω του MCP JSON. Δημιουργήστε ένα URL (`{uploadUrl,storageId}`), κάντε PUT το αρχείο από τον host και μετά δημιουργήστε το link:

```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}` → ο host κάνει PUT στο `uploadUrl` → `links_create` με αυτό το `storageId`. Για προαιρετική κάρτα unfurl: `previewName`, `previewDescription`, `previewImageStorageId` (με το ίδιο upload). Με το προαιρετικό `maxOpenings`, το link τίθεται σε παύση μετά από τον συγκεκριμένο αριθμό ανοιγμάτων. Το `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 λεπτά μια παραλλαγή με κωδικό πρόσβασης για έναν editor |
| `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` |
| (PUT από τον host μετά τη δημιουργία του URL) | `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_*` |

## Φάκελοι

Ένας φάκελος είναι ένα link που εμφανίζει τα στοιχεία που τοποθετείτε σε αυτόν. Για το μοντέλο των φακέλων, δείτε την ενότητα [Φάκελοι](/el/folders).

| Εργαλείο | Είσοδος |
| --- | --- |
| `links_create` | Το `{ kind: "folder", name, … }` δημιουργεί φάκελο. Κάθε create δέχεται `folder` (slug) και `folderDomain?` για δημιουργία μέσα σε φάκελο. Η απόκριση περιλαμβάνει το `folder` |
| `links_list` | Μία σελίδα, `{ items, cursor }` (`limit` 1-100, προεπιλογή 50· περνάτε ξανά το `cursor` μέχρι να γίνει `null`). Το `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 }` (ίδια πρόσβαση, νέο share URL, χωρίς άτομα με κοινή χρήση) |
| `links_delete` | `contents?: "keep" \| "delete"` για φακέλους (προεπιλογή `keep`) |

Τα `links_export` / `links_import` προσθέτουν τις στήλες `folder` και `access`. Οι γραμμές με `kind` `folder` δημιουργούν φακέλους.

## Πρόσβαση και κοινή χρήση

Τα νέα links και οι νέοι φάκελοι έχουν περιορισμένη πρόσβαση. Το `url` είναι `https://linkdash.dev/s/<token>` και μπορείτε να το ανοίξετε μόνο εσείς και τα άτομα με τα οποία το μοιράζεστε. Περάστε `access` στο `links_create` ή στο `links_update`: `restricted` (προεπιλογή), `link` (οποιοσδήποτε έχει το share URL) ή `public` (οποιοσδήποτε, μέσω του short URL). Ζητήστε `access: "public"` όταν το link πρόκειται να δημοσιευτεί. Δείτε την ενότητα [Κοινή χρήση και πρόσβαση](/el/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? }` → μία σελίδα με όλα όσα έχετε μοιραστεί, `{ items, cursor }`, το καθένα με `people` |
| `links_shared` | `{ limit?, cursor? }` → μία σελίδα με τα στοιχεία που έχουν μοιραστεί άλλοι μαζί σας, `{ items, cursor }`, με το `url` για να ανοίξετε το καθένα |
| `links_leave` | `{ id }` (το `_id` ή το share URL από το `links_shared`) → `{ _id, left: true }` |
| `links_update` | Το `access?` αλλάζει ποιος μπορεί να το ανοίξει. Το `resetShareLink: true` εκδίδει νέο share URL (το παλιό σταματά να λειτουργεί) |

Σε κάθε απόκριση, το `url` είναι το share URL, εκτός αν το link είναι δημόσιο, οπότε είναι το short URL. Η κοινή χρήση, η κατάργηση κοινής χρήσης, οι αλλαγές πρόσβασης και οι επαναφορές μετρούν η καθεμία ως ένα event. Η αποχώρηση δεν μετρά.

## Παραλλαγές

Κάθε link είναι ένας container που περιέχει μία ή περισσότερες **παραλλαγές (variants)**. Κάθε παραλλαγή έχει περιεχόμενο (`url` | `file` | `text`) και το δικό της gate (`password`, `starts`, `expires`, `maxOpenings`, παύση). Έχει επίσης ένα `weight` και, προαιρετικά, συνθήκες επισκέπτη `when`. Αν δεν υπάρχει `variants`, το link έχει μία παραλλαγή με όνομα `main`. Το gate του link υπερισχύει των gates των παραλλαγών. Κάθε επισκέπτης λαμβάνει μία παραλλαγή. Πρώτα σχηματίζεται ένα pool από τις παραλλαγές των οποίων το `when` ταιριάζει (αλλιώς από τις παραλλαγές χωρίς συνθήκες). Στη συνέχεια γίνεται σταθμισμένη επιλογή από το pool. Το `sticky` (προεπιλογή `true`) κρατά τον επισκέπτη που επιστρέφει στην ίδια παραλλαγή, ενώ το `restartSplit` κάνει νέα κατανομή. Το `kind` του link είναι `group` όταν έχει πολλές παραλλαγές. Το `status` του link είναι `mixed` όταν οι παραλλαγές διαφέρουν. Κάθε link μπορεί να έχει έως 20 παραλλαγές. Για τις δομές δεδομένων, δείτε το [HTTP API](/el/api#variants).

Το `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 παραλλαγών (μία γραμμή ανά παραλλαγή).

| Εργαλείο | Είσοδος |
| --- | --- |
| `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` (πίνακες από strings· πρέπει να ταιριάζουν όλα τα κλειδιά που έχουν οριστεί), καθώς και `params`.

**Κανόνες για query parameters.** Το `when.params` είναι ένας πίνακας με έως 10 κανόνες για το query string του επισκέπτη, και πρέπει να ισχύουν όλοι: `{ "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }`. Τιμές του `op`: `equals` | `notEquals` | `includes` | `startsWith` | `endsWith` | `in` (το `value` είναι λίστα με διαχωριστικό `|`) | `exists` | `missing` (τα δύο τελευταία δεν δέχονται `value`). Τα κλειδιά κάνουν διάκριση πεζών-κεφαλαίων και οι τιμές συγκρίνονται ακριβώς. Οι τιμές των parameters δεν αποθηκεύονται ποτέ στα analytics.

**Προώθηση query parameters.** Το `forwardParams` (boolean στο `links_create` / `links_update`, προεπιλογή `false`) προσθέτει ολόκληρο το query string του επισκέπτη στις παραλλαγές URL. Οι τιμές του επισκέπτη αντικαθιστούν τις αποθηκευμένες, και αυτό ισχύει και για τα `utm`. Ισχύει μόνο για παραλλαγές URL. Χρησιμεύει για δρομολόγηση, όχι για έλεγχο πρόσβασης.

Τα `auth create` / `auth login` / `auth logout` δεν είναι εργαλεία MCP. Αντιστοίχιση: [api.md](https://linkdash.dev/api.md).
