Přeskočit na obsah
Všechny články

mcpclaude-codeagents

Jak přidat zkracovač URL do Claude Code přes MCP

Připojte Claude Code k Linkdash přes MCP, aby vytvářel krátké odkazy, dělil provoz, sdílel soubory a četl statistiky kliknutí přímo v terminálu.

Igor Kirnosov5 min čtení

Claude Code volá MCP server Linkdash a vytváří krátký odkaz lida.sh/pricing

Claude Code umí vytvářet a spravovat krátké odkazy, jakmile ho přes MCP připojíte ke zkracovači URL. Přidejte MCP server Linkdash jedním příkazem, jednou se přihlaste v prohlížeči a Claude může zkracovat URL, dělit provoz mezi stránky, sdílet soubory s omezenou platností a číst statistiky kliknutí — vše ve stejné relaci terminálu, ve které píše váš kód.

Tento návod pokrývá nastavení, sdílení s týmem, výběr nástrojů, které smí Claude spouštět bez ptaní, postupy, kde se to vyplatí, a běh v CI. Používáte místo toho Cursor nebo Codex? Jejich příkazy k nastavení najdete v dokumentaci MCP.

Co s tím Claude Code dokáže

MCP server Linkdash nabízí stejné operace jako CLI a HTTP API, a to jako nástroje, které si Claude najde sám:

Nástroje Co Claude dokáže
links_create, links_update, links_delete Vytvářet, měnit, pozastavovat a odebírat odkazy
variants_add, variants_update, variants_remove Dělit provoz nebo směrovat podle země, zařízení či OS
links_list, links_get, links_stats Hledat odkazy a číst návštěvy, země a referrery
files_upload_url Nahrát soubor a sdílet ho jako odkaz
links_export, links_import Přesouvat odkazy dovnitř a ven jako CSV
domains_*, webhooks_* Spravovat vlastní domény a webhooky

Krok 1: Přidejte server

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

Tím přidáte Linkdash pro aktuální projekt. Přidejte --scope user, aby byl dostupný ve všech projektech na vašem počítači.

Krok 2: Přihlaste se

claude mcp login linkdash

V prohlížeči se otevře přihlášení do Linkdash. Pokud ještě nemáte účet, můžete si tam vytvořit účet v tarifu Free. Po přihlášení se zobrazí obrazovka souhlasu s dotazem, zda může Claude Code používat váš účet. Klikněte na Povolit a Claude Code si uloží přístupový token a sám ho obnovuje.

Přihlásit se můžete i přímo v relaci: spusťte /mcp, vyberte linkdash a zvolte ověření. Připojení zkontrolujete takto:

claude mcp list

linkdash by se měl zobrazit jako ✔ Connected. Pak to vyzkoušejte:

Zkrať https://example.com/pricing jako lida.sh/pricing.

Claude zavolá links_create a odpoví novým krátkým odkazem.

Krok 3: Sdílejte nastavení s týmem

Aby měl každý v repozitáři stejný server, přidejte do kořene projektu soubor .mcp.json:

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

V souboru není nic tajného, takže ho můžete bez obav commitnout. Když kolega projekt poprvé otevře, Claude Code ho požádá o schválení serveru a každý se přihlásí vlastním účtem Linkdash, takže každý odkaz skončí v účtu toho, kdo si o něj řekl.

Krok 4: Rozhodněte, co poběží bez ptaní

Ve výchozím stavu se Claude Code před voláním nástroje MCP ptá. Čtení statistik je neškodné, takže se vyplatí ho povolit; mazání odkazů se naopak vyplatí rovnou zakázat. Přidejte pravidla oprávnění 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 se jmenují mcp__<server>__<tool>, takže tato pravidla předpokládají, že jste v kroku 1 pojmenovali server linkdash. Vytváření a úpravy odkazů se budou ptát pokaždé, takže máte přehled o všem, co mění, kam odkaz vede.

Postupy, které se v terminálu vyplatí

Zkraťte všechny odkazy ve vydání

Vytvoř krátké odkazy pro všechny URL v CHANGELOG.md pod 2.4.0, dej jim štítek release-2.4 a nahraď URL v souboru.

Claude přečte soubor, pro každou URL zavolá jednou links_create se štítkem a upraví changelog. Díky štítku zůstanou odkazy z vydání pohromadě v dashboardu i v pozdějších dotazech na statistiky.

Rozdělte provoz na stránce, kterou jste právě postavili

Vytvoř lida.sh/pricing, který rozdělí návštěvníky 50/50 mezi /pricing a /pricing-v2, s utm_content nastaveným na název každé varianty.

Claude vytvoří jeden odkaz se dvěma variantami, každou označenou tak, aby váš analytický nástroj skupiny rozlišil. Návod na A/B test odkazu popisuje, jak dlouho test nechat běžet a jak číst výsledek.

Nasdílejte build s omezenou platností

Nasdílej dist/app-1.4.2.dmg jako odkaz, který vyprší za 3 dny a přestane fungovat po 5 otevřeních.

Protože Claude Code má shell, zvládne i soubory: zavolá files_upload_url, nahraje soubor na vrácenou URL pomocí curl a pak zavolá links_create s nahraným souborem, expires: "3d" a maxOpenings: 5. Soubor samotnou konverzací nikdy neprochází.

Zjistěte, jak si odkazy vedou

Které odkazy se štítkem release-2.4 měly za posledních 7 dní nejvíc návštěv a odkud návštěvy přišly?

Claude vypíše odkazy se štítkem a pro každý zavolá links_stats s last: "7d". Každý výsledek obsahuje návštěvy, země a referrery. S pravidly oprávnění z kroku 4 proběhnou tato čtení bez dotazu.

Claude Code v CI

Přihlášení vyžaduje člověka u prohlížeče, takže běhy bez prohlížeče, například claude -p v CI jobu, používají místo toho API klíč. Vytvořte ho v sekci API klíče (klíče začínají na ldash_), uložte ho jako CI secret s názvem LINKDASH_API_KEY a předejte ho v hlavičce:

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

Claude Code doplní ${LINKDASH_API_KEY} z prostředí, takže samotný klíč se nikdy necommitne. Nástroje i pravidla oprávnění fungují v obou případech stejně.

MCP, nebo CLI?

Claude Code může přes svůj shell spouštět i CLI linkdash a obojí pracuje se stejným účtem:

  • MCP nevyžaduje instalaci. Claude vidí typované nástroje a jejich parametry, a proto je to jednodušší volba, když chcete, aby Claude prostě spravoval odkazy.
  • CLI (npm i -g linkdash-cli) vypisuje JSON, což se hodí pro skripty, které pro vás Claude píše. Aby Claude CLI znal, nainstalujte skill Linkdash pro agenty příkazem npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Řešení problémů

  • linkdash ukazuje ! Needs authentication. Spusťte claude mcp login linkdash a znovu se přihlaste. Stává se to i poté, co Claude Code v dashboardu odpojíte.
  • Server z .mcp.json zůstává ve stavu čekání. Spusťte claude v projektu a server schvalte. claude mcp reset-project-choices vymaže dřívější volby.
  • Nástroje v CI selhávají s chybou 401. V daném prostředí chybí LINKDASH_API_KEY nebo je chybný, případně byl klíč smazán.

Časté dotazy

Vidí Claude moje heslo nebo klíč?

Ne. Přihlásíte se na linkdash.dev v prohlížeči a Claude Code dostane token, který si uloží ve vlastní konfiguraci. Heslo ani token se v konverzaci nemusí nikdy objevit.

Jak Claude Code odpojím?

V dashboardu Linkdash otevřete API klíče a v sekci Připojené aplikace klikněte u Claude Code na Odpojit. Jeho přístup okamžitě skončí. Příkaz claude mcp logout linkdash navíc odstraní uložený token z vašeho počítače.

Může Claude smazat moje odkazy?

Jen pokud mu to dovolíte. Pravidla deny z kroku 4 zablokují links_delete a variants_remove, i když se o to Claude pokusí.

Je to zdarma?

Ano, v tarifu Free, který zahrnuje 5 000 událostí měsíčně. Vyšší limity najdete v ceníku.

Můžu připojit i Cursor, Codex nebo ChatGPT?

Ano. Stejný server funguje se všemi a většině stačí URL a přihlášení. Postup pro každý z nich najdete v dokumentaci MCP.