MCP
Απομακρυσμένος MCP server στο https://api.linkdash.dev/mcp. Συνδεθείτε με OAuth από Claude, ChatGPT, Cursor και Codex ή χρησιμοποιήστε ένα API key.
Απομακρυσμένος MCP server στο https://api.linkdash.dev/mcp. Προσθέστε το URL στον client σας και συνδεθείτε με τον λογαριασμό σας στο Linkdash. Για agents που εκτελούνται χωρίς κάποιον μπροστά σε browser, χρησιμοποιήστε αντί αυτού ένα API key. Απλό markdown: mcp.md.
Σύνδεση
Δώστε στον client μόνο το URL https://api.linkdash.dev/mcp. Ο client ανοίγει τη σελίδα σύνδεσης του Linkdash και μετά μια οθόνη συναίνεσης. Η οθόνη αυτή δείχνει το όνομα της εφαρμογής και τον ιστότοπο στον οποίο θα επιστρέψετε. Εγκρίνετε την πρόσβαση και ο client θα λάβει ένα token για τον λογαριασμό σας.
- claude.ai και Claude Desktop: ανοίξτε το Linkdash στον κατάλογο connectors (ή μεταβείτε στο Customize → Connectors και αναζητήστε το Linkdash) και κάντε κλικ στο Connect.
- ChatGPT: σύντομα θα υπάρχει καταχώριση στον κατάλογο plugins του 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μέσα σε ένα session). - Cursor: το Add to Cursor το εγκαθιστά με ένα κλικ. Μετά συνδεθείτε όταν σας το ζητήσει το Cursor. Εναλλακτικά, προσθέστε τον server στο
mcp.jsonμε"url"και χωρίςheaders. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcpκαι μετάcodex mcp login linkdash.
Η εφαρμογή αποκτά την ίδια πρόσβαση με ένα API key. Οι συνδεδεμένες εφαρμογές εμφανίζονται στο Πίνακας ελέγχου → Κλειδιά API. Εκεί το Αποσύνδεση ανακαλεί αμέσως την πρόσβασή τους.
Αυτοματοποίηση και headless agents
Η σύνδεση με OAuth απαιτεί κάποιον μπροστά σε browser. Για CI jobs, προγραμματισμένους agents, servers και κώδικα που καλεί απευθείας το MCP, στείλτε αντί αυτού ένα API key: Authorization: Bearer ldash_.... Είναι τα ίδια keys με αυτά του 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.
Αρχεία
Μην στέλνετε bytes μέσω του MCP JSON. Δημιουργήστε ένα URL ({uploadUrl,storageId}), κάντε PUT το αρχείο από τον host και μετά δημιουργήστε το link:
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 που εμφανίζει τα στοιχεία που τοποθετείτε σε αυτόν. Για το μοντέλο των φακέλων, δείτε την ενότητα Φάκελοι.
| Εργαλείο | Είσοδος |
|---|---|
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 πρόκειται να δημοσιευτεί. Δείτε την ενότητα Κοινή χρήση και πρόσβαση.
| Εργαλείο | Είσοδος |
|---|---|
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.
Το 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.

