Preskočiť na obsah
Všetky články

mcpclaude-codeagents

Ako pridať skracovač URL do Claude Code cez MCP

Pripojte Claude Code k Linkdash cez MCP: vytvorí krátke odkazy, rozdelí návštevnosť, zdieľa súbory a číta štatistiky kliknutí priamo v termináli.

Igor Kirnosov5 min čítania

Claude Code volá MCP server Linkdash a vytvára krátky odkaz lida.sh/pricing

Claude Code dokáže vytvárať a spravovať krátke odkazy, keď ho cez MCP pripojíte k skracovaču URL. Pridajte MCP server Linkdash jedným príkazom, raz sa prihláste v prehliadači a Claude bude skracovať URL, rozdeľovať návštevnosť medzi stránky, zdieľať súbory s obmedzenou platnosťou a čítať štatistiky kliknutí, a to všetko v tej istej relácii terminálu, v ktorej píše váš kód.

Tento návod popisuje nastavenie, jeho zdieľanie s tímom, výber nástrojov, ktoré môže Claude spúšťať bez pýtania, postupy, pri ktorých sa to oplatí, a beh v CI. Používate namiesto toho Cursor alebo Codex? Príkazy na nastavenie nájdete v dokumentácii k MCP.

Čo s tým Claude Code dokáže

MCP server Linkdash sprístupňuje rovnaké operácie ako CLI a HTTP API, a to ako nástroje, ktoré si Claude nájde sám:

Nástroje Čo Claude dokáže
links_create, links_update, links_delete Vytvárať, meniť, pozastavovať a odstraňovať odkazy
variants_add, variants_update, variants_remove Rozdeľovať návštevnosť alebo smerovať podľa krajiny, zariadenia či OS
links_list, links_get, links_stats Vyhľadávať odkazy a čítať návštevy, krajiny a referrery
files_upload_url Nahrať súbor a zdieľať ho ako odkaz
links_export, links_import Importovať a exportovať odkazy ako CSV
domains_*, webhooks_* Spravovať vlastné domény a webhooky

Krok 1: Pridajte server

claude mcp add --transport http linkdash \
  https://api.linkdash.dev/mcp

Týmto pridáte Linkdash pre aktuálny projekt. Ak pridáte --scope user, bude dostupný vo všetkých projektoch na vašom počítači.

Krok 2: Prihláste sa

claude mcp login linkdash

V prehliadači sa otvorí prihlásenie do Linkdash. Ak ešte nemáte účet, môžete si ho tam vytvoriť v pláne Free. Po prihlásení sa zobrazí obrazovka so súhlasom, či môže Claude Code používať váš účet. Kliknite na Povoliť a Claude Code si uloží prístupový token a sám ho obnovuje.

Prihlásiť sa môžete aj priamo v relácii: spustite /mcp, vyberte linkdash a zvoľte overenie. Pripojenie skontrolujete takto:

claude mcp list

linkdash by sa mal zobraziť ako ✔ Connected. Potom to vyskúšajte:

Skráť https://example.com/pricing ako lida.sh/pricing.

Claude zavolá links_create a odpovie novým krátkym odkazom.

Krok 3: Zdieľajte nastavenie s tímom

Ak chcete, aby mal každý v repozitári rovnaký server, pridajte do koreňa projektu súbor .mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp"
    }
  }
}

V súbore nie je nič tajné, takže ho môžete pokojne commitnúť. Keď kolega projekt prvýkrát otvorí, Claude Code ho požiada o schválenie servera a každý sa prihlási vlastným účtom Linkdash, takže každý odkaz skončí v účte toho, kto oň požiadal.

Krok 4: Rozhodnite, čo pobeží bez pýtania

Claude Code sa predvolene pýta skôr, než zavolá nástroj MCP. Čítanie štatistík je neškodné, takže sa oplatí ho povoliť; odstraňovanie odkazov sa oplatí rovno zablokovať. Pridajte pravidlá oprávnení do .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__linkdash__links_list",
      "mcp__linkdash__links_get",
      "mcp__linkdash__links_stats"
    ],
    "deny": [
      "mcp__linkdash__links_delete",
      "mcp__linkdash__variants_remove"
    ]
  }
}

Nástroje MCP sa volajú mcp__<server>__<tool>, takže tieto pravidlá predpokladajú, že ste server v kroku 1 nazvali linkdash. Vytváranie a úprava odkazov sa budú pýtať zakaždým, takže máte prehľad o všetkom, čo mení, kam odkaz vedie.

Postupy, ktoré sa v termináli oplatia

Skráťte všetky odkazy vo vydaní

Vytvor krátke odkazy pre všetky URL v CHANGELOG.md pod 2.4.0, označ ich štítkom release-2.4 a nahraď URL v súbore.

Claude prečíta súbor, pre každú URL zavolá links_create so štítkom a upraví changelog. Vďaka štítku zostanú odkazy z vydania pohromade v ovládacom paneli aj pri neskorších otázkach na štatistiky.

Rozdeľte návštevnosť stránky, ktorú ste práve vytvorili

Vytvor lida.sh/pricing, ktorý rozdelí návštevníkov 50/50 medzi /pricing a /pricing-v2, s utm_content nastaveným na názov každého variantu.

Claude vytvorí jeden odkaz s dvoma variantmi, každý označený tak, aby váš analytický nástroj vedel skupiny rozlíšiť. Návod na A/B testovanie odkazu vysvetľuje, ako dlho test nechať bežať a ako čítať výsledok.

Zdieľajte build s obmedzenou platnosťou

Zdieľaj dist/app-1.4.2.dmg ako odkaz, ktorého platnosť vyprší o 3 dni a ktorý prestane fungovať po 5 otvoreniach.

Keďže Claude Code má shell, zvládne aj súbory: zavolá files_upload_url, nahrá súbor na vrátenú URL pomocou curl a potom zavolá links_create s nahraným súborom, expires: "3d" a maxOpenings: 5. Samotný súbor nikdy neprechádza konverzáciou.

Pozrite sa, ako sa odkazom darí

Ktoré odkazy so štítkom release-2.4 mali za posledných 7 dní najviac návštev a odkiaľ prišli?

Claude vypíše odkazy so štítkom a pre každý zavolá links_stats s last: "7d". Každý výsledok obsahuje návštevy, krajiny a referrery. S pravidlami oprávnení z kroku 4 bežia tieto čítania bez výzvy.

Claude Code v CI

Prihlásenie vyžaduje človeka pri prehliadači, takže behy bez rozhrania, napríklad claude -p v úlohe CI, používajú namiesto toho API kľúč. Vytvorte si ho v časti API kľúče (kľúče začínajú na ldash_), uložte ho ako tajomstvo CI s názvom LINKDASH_API_KEY a odovzdajte ho v hlavičke:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${LINKDASH_API_KEY}"
      }
    }
  }
}

Claude Code doplní ${LINKDASH_API_KEY} z prostredia, takže samotný kľúč sa nikdy necommitne. Nástroje aj pravidlá oprávnení fungujú v oboch prípadoch rovnako.

MCP alebo CLI?

Claude Code môže cez svoj shell spúšťať aj CLI linkdash a obe cesty vedú k tomu istému účtu:

  • MCP nevyžaduje inštaláciu. Claude vidí typované nástroje a ich parametre, takže je to jednoduchšia voľba, keď chcete, aby Claude len spravoval odkazy.
  • CLI (npm i -g linkdash-cli) vypisuje JSON, čo sa hodí pre skripty, ktoré pre vás Claude napíše. Ak chcete Clauda naučiť CLI, nainštalujte skill Linkdash pre agentov príkazom npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Riešenie problémov

  • linkdash zobrazuje ! Needs authentication. Spustite claude mcp login linkdash a prihláste sa znova. Stane sa to aj potom, ako Claude Code odpojíte v ovládacom paneli.
  • Server z .mcp.json zostáva v stave čakania. Spustite claude v projekte a server schváľte. claude mcp reset-project-choices vymaže predchádzajúce voľby.
  • Nástroje v CI zlyhávajú s chybou 401. V danom prostredí chýba LINKDASH_API_KEY alebo je nesprávny, prípadne bol kľúč odstránený.

Časté otázky

Vidí Claude moje heslo alebo kľúč?

Nie. Prihlasujete sa na linkdash.dev v prehliadači a Claude Code dostane token, ktorý si uchováva vo vlastnej konfigurácii. Vaše heslo ani token sa v konverzácii nemusia objaviť.

Ako Claude Code odpojím?

V ovládacom paneli Linkdash otvorte API kľúče a v časti Pripojené aplikácie kliknite pri Claude Code na Odpojiť. Jeho prístup okamžite skončí. Príkaz claude mcp logout linkdash zároveň odstráni uložený token z vášho počítača.

Môže Claude odstrániť moje odkazy?

Iba ak mu to dovolíte. Pravidlá deny z kroku 4 blokujú links_delete a variants_remove, aj keby sa o to Claude pokúsil.

Je to zadarmo?

Áno, v pláne Free, ktorý zahŕňa 5 000 udalostí mesačne. Vyššie limity nájdete v cenníku.

Môžem pripojiť aj Cursor, Codex alebo ChatGPT?

Áno. Ten istý server funguje so všetkými a väčšina potrebuje iba URL a prihlásenie. Postup pre každý nájdete v dokumentácii k MCP.