MCP
Etä-MCP osoitteessa https://api.linkdash.dev/mcp. Kirjaudu OAuthilla Claudesta, ChatGPT:stä, Cursorista ja Codexista tai käytä API-avainta.
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. Pelkkä markdown: 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 (tai valitse Customize → Connectors ja hae Linkdash) ja napsauta Connect.
- ChatGPT: Linkdash tulee pian ChatGPT plugin-hakemistoon. Siihen asti avaa 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, sittenclaude mcp login linkdash(tai/mcpistunnossa). - Cursor: Add to Cursor asentaa palvelimen yhdellä napsautuksella. Kirjaudu sitten, kun Cursor pyytää. Voit myös lisätä palvelimen tiedostoon
mcp.jsonkentällä"url"ilmanheaders-kenttää. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, sittencodex mcp login linkdash.
Sovellus saa samat käyttöoikeudet kuin API-avain. Yhdistetyt sovellukset näkyvät kohdassa Hallintapaneeli → API-avaimet. 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 suoraan, lähetä sen sijaan API-avain: Authorization: Bearer ldash_.... Avaimet ovat samat kuin HTTP API.
Cursor (~/.cursor/mcp.json tai .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 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 JSONissa. Luo ensin latausosoite ({uploadUrl,storageId}), lähetä tiedosto isännältä PUT-pyynnöllä ja luo sitten linkki:
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. 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) |
GET /shares |
links_shares (ilman 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 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.
| 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). Pyydä access: "public", jos linkki julkaistaan avoimesti. Katso Jakaminen ja käyttöoikeudet.
| 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 (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.
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 (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.

