MCP
Távoli MCP a https://api.linkdash.dev/mcp címen. Jelentkezz be OAuth-tal a Claude-ból, a ChatGPT-ből, a Cursorból és a Codexből, vagy használj API-kulcsot.
Távoli MCP a https://api.linkdash.dev/mcp címen. Add hozzá az URL-t a kliensedhez, és jelentkezz be a Linkdash-fiókoddal. Ha az agent úgy fut, hogy senki sem ül a böngésző előtt, használj inkább API-kulcsot. Sima markdown: mcp.md.
Csatlakozás
A kliensnek csak a https://api.linkdash.dev/mcp URL-t add meg. Megnyílik egy Linkdash-bejelentkezés, aztán egy hozzájárulási képernyő, amely megmutatja az alkalmazás nevét és azt az oldalt, ahová visszatér. Ha engedélyezed, a kliens kap egy tokent a fiókodhoz.
- claude.ai és Claude Desktop: nyisd meg a Linkdash-t a connector-könyvtárban (vagy a Customize → Connectors alatt keress rá a Linkdash-re), és kattints a Connect gombra.
- ChatGPT: hamarosan megjelenik a ChatGPT plugin-könyvtárában is. Addig a Plugins oldalon válaszd a + → Add custom MCP server lehetőséget, add meg a fenti URL-t, és válaszd az OAuth-ot.
- Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp, aztánclaude mcp login linkdash(vagy/mcpegy sessionön belül). - Cursor: az Add to Cursor egy kattintással telepíti, utána jelentkezz be, amikor a Cursor kéri. Vagy add hozzá a szervert az
mcp.jsonfájlhoz"url"mezővel,headersnélkül. - Codex:
codex mcp add linkdash --url https://api.linkdash.dev/mcp, aztáncodex mcp login linkdash.
Az alkalmazás ugyanazt a hozzáférést kapja, mint egy API-kulcs. A csatlakoztatott alkalmazásokat a Irányítópult → API-kulcsok alatt találod, ahol a Leválasztás azonnal visszavonja őket.
Automatizálás és headless agentek
A bejelentkezéshez kell valaki a böngésző előtt. CI-jobokhoz, ütemezett agentekhez, szerverekhez és olyan kódhoz, amely közvetlenül hívja az MCP-t, inkább API-kulcsot küldj: Authorization: Bearer ldash_..., ugyanazokat a kulcsokat, mint a HTTP API esetén.
Cursor (~/.cursor/mcp.json vagy .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 esetén kell a "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"
Lokálisan: a Convex .site URL + /mcp.
Fájlok
Ne küldj bájtokat az MCP JSON-on keresztül. Kérj egy URL-t ({uploadUrl,storageId}), PUT-tal töltsd fel a fájlt a hostról, aztán hozd létre a linket:
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-toolok: a files_upload_url visszaadja a {uploadUrl,storageId} értéket → a host PUT-tal feltölt az uploadUrl címre → links_create ezzel a storageId értékkel. Opcionális előnézeti kártya: previewName, previewDescription, previewImageStorageId (ugyanígy feltöltve). Az opcionális maxOpenings ennyi megnyitás után szünetelteti a linket; a links_update megemelheti, vagy átadhatod a clearMaxOpenings értéket. Az uploadUrl címet ne írd ki a felhasználónak.
Toolok
| 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 nélkül) |
GET /shares |
links_shares (id nélkül) |
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 vagy editor) |
|
links_unlock |
{ id, variant?, password?, variantPassword? } → a cél; egy jelszóval védett variánst old fel egy editor számára 30 percre |
|
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 |
| (host PUT az URL kérése után) | 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_* |
Mappák
A mappa egy olyan link, amely felsorolja a beletett elemeket. A modellről a Mappák oldalon olvashatsz.
| Tool | Bemenet |
|---|---|
links_create |
A { kind: "folder", name, … } mappát hoz létre; bármelyik létrehozás elfogadja a folder (slug) és a folderDomain? mezőt, ha egy mappán belül akarsz létrehozni. A válasz tartalmazza a folder mezőt |
links_list |
Egy oldal, { items, cursor } (limit 1-100, alapértelmezés 50; add vissza a cursor értéket, amíg null nem lesz). A q szavakra illeszt; a folder: "<slug>" azt listázza, ami közvetlenül benne van; a folder: "root" a legfelső szintet listázza; a kind kiegészül a folder értékkel. A sorok tartalmazzák a folder mezőt, a mappasorok pedig az items mezőt |
links_move |
{ id, domain?, folder: string | null, folderDomain? } → { id, folder } |
links_copy |
{ id, domain? } → { id, url, access, kind, folder } (ugyanaz a hozzáférés, új megosztási URL, emberek nélkül) |
links_delete |
contents?: "keep" | "delete" mappák esetén (alapértelmezés: keep) |
A links_export / links_import kiegészül a folder és az access oszloppal, a folder kind értékű sorok pedig mappákat hoznak létre.
Hozzáférés és megosztás
Az új linkek és mappák korlátozottak: az url értéke https://linkdash.dev/s/<token>, amelyet csak te és azok nyithatnak meg, akikkel megosztod. Add meg az access mezőt a links_create vagy a links_update hívásnál: restricted (alapértelmezés), link (bárki, akinél megvan a megosztási URL) vagy public (bárki, a rövid URL-en). Kérj access: "public" beállítást, ha a linket nyilvánosan teszed közzé. Lásd: Megosztás és hozzáférés.
| Tool | Bemenet |
|---|---|
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? } → egy oldal mindabból, amit megosztottál, { items, cursor }, mindegyik people mezővel |
links_shared |
{ limit?, cursor? } → egy oldal azokból az elemekből, amelyeket mások osztottak meg veled, { items, cursor }, mindegyikhez az url, amellyel megnyithatod |
links_leave |
{ id } (a links_shared által adott _id vagy megosztási URL) → { _id, left: true } |
links_update |
Az access? azt módosítja, ki nyithatja meg; a resetShareLink: true új megosztási URL-t ad ki (a régi megszűnik működni) |
Minden válaszban az url a megosztási URL, kivéve, ha a link nyilvános, ilyenkor a rövid URL. A megosztás, a megosztás visszavonása, a hozzáférés módosítása és a reset egyenként egy eseménynek számít; a kilépés nem.
Variánsok
Minden link egy vagy több variáns tárolója: tartalom (url | file | text), plusz saját kapu (password, starts, expires, maxOpenings, szüneteltetve), egy weight, és opcionális látogatói feltételek (when). variants nélkül a linknek egyetlen, main nevű variánsa van. A link kapuja erősebb a variánsok kapuinál. A látogató egy variánst kap: azok a variánsok alkotják a készletet, amelyeknek a when feltétele illeszkedik (különben a feltétel nélküliek), majd súlyozott választás következik; a sticky (alapértelmezés: true) a visszatérő látogatót ugyanazon a variánson tartja, a restartSplit pedig újrakeveri az elosztást. Több variáns esetén a link kind értéke group; ha a variánsok eltérnek, a link status értéke mixed. Linkenként legfeljebb 20 variáns lehet. Formátumok: HTTP API.
A links_create a rövidített forma helyett variants: [{ name, url | text | storageId (+ fileName, fileType, fileSize), password?, starts?, expires?, maxOpenings?, utm?, weight?, when? }] értéket fogad, plusz sticky és forwardParams mezőt. A links_update a sticky, forwardParams és restartSplit mezőt fogadja. A links_list szűr kind (kiegészül a group értékkel) és status (kiegészül a mixed értékkel) szerint. A links_stats visszaadja a variants összesítéseket. A links_export / links_import a variáns-CSV-t használja (variánsonként egy sor).
| Tool | Bemenet |
|---|---|
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? } |
A when kulcsai: countries, devices, os, browsers, languages, referrerHosts (stringtömbök; minden megadott kulcsnak illeszkednie kell), plusz params.
Query paraméter szabályok. A when.params legfeljebb 10 szabályból álló tömb a látogató query stringjére, és minden szabálynak teljesülnie kell: { "params": [{ "key": "src", "op": "equals", "value": "newsletter" }] }. op: equals | notEquals | includes | startsWith | endsWith | in (a value egy | jellel elválasztott lista) | exists | missing (az utolsó kettőnél nincs value). A kulcsok kis- és nagybetű-érzékenyek, az értékeket pontos egyezéssel hasonlítja össze. A paraméterértékeket soha nem tárolja az analitika.
Query paraméterek továbbítása. A forwardParams (boolean a links_create / links_update hívásnál, alapértelmezés: false) a látogató teljes query stringjét hozzáfűzi az URL-variánsokhoz; a látogató értékei felülírják a tároltakat, az utm értékeit is beleértve. Csak URL-variánsokra vonatkozik. Ez útválasztás, nem hozzáférés-szabályozás.
Az auth create / auth login / auth logout nem MCP-toolok. Megfeleltetés: api.md.

