Siirry sisältöön
LinkdashLinkdash
Suomi
Esc
↑↓siirry↵avaa⌘Jesikatselu
Tällä sivulla

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, sitten claude mcp login linkdash (tai /mcp istunnossa).
  • Cursor: Add to Cursor 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. 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.

Oliko tästä sivusta apua?