Preskoči na vsebino
Vse objave

mcpclaude-codeagents

Kako dodati skrajševalnik URL-jev v Claude Code prek MCP

Povežite Claude Code z Linkdash prek MCP, da ustvarja kratke povezave, deli promet in datoteke ter bere statistiko klikov, ne da bi zapustil terminal.

Igor Kirnosov5 min branja

Claude Code kliče strežnik MCP Linkdash in ustvari kratko povezavo lida.sh/pricing

Claude Code lahko ustvarja in upravlja kratke povezave, ko ga prek MCP povežete s skrajševalnikom URL-jev. Z enim ukazom dodajte strežnik MCP Linkdash, se enkrat prijavite v brskalniku in Claude lahko skrajšuje URL-je, deli promet med strani, deli datoteke s potekom in bere statistiko klikov, vse iz iste seje v terminalu, v kateri piše vašo kodo.

Ta vodnik opisuje nastavitev, deljenje nastavitve z ekipo, izbiro orodij, ki jih Claude lahko zažene brez vprašanja, delovne tokove, v katerih se splača, in uporabo v CI. Namesto tega uporabljate Cursor ali Codex? Dokumentacija MCP navaja njune ukaze za nastavitev.

Kaj lahko Claude Code naredi z njim

Strežnik MCP Linkdash ponuja iste operacije kot CLI in HTTP API, in sicer kot orodja, ki jih Claude odkrije sam:

Orodja Kaj lahko Claude naredi
links_create, links_update, links_delete Ustvari, spremeni, zaustavi in odstrani povezave
variants_add, variants_update, variants_remove Razdeli promet ali usmerja po državi, napravi ali OS
links_list, links_get, links_stats Poišče povezave in bere obiske, države in napotitelje
files_upload_url Naloži datoteko in jo deli kot povezavo
links_export, links_import Izvozi in uvozi povezave kot CSV
domains_*, webhooks_* Upravlja lastne domene in webhooke

1. korak: dodajte strežnik

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

S tem dodate Linkdash za trenutni projekt. Dodajte --scope user, da bo na voljo v vseh projektih na vašem računalniku.

2. korak: prijavite se

claude mcp login linkdash

Brskalnik odpre prijavo v Linkdash. Če računa še nimate, ga lahko tam ustvarite v paketu Free. Po prijavi vas zaslon za soglasje vpraša, ali lahko Claude Code uporablja vaš račun. Kliknite Dovoli in Claude Code shrani žeton za dostop ter ga sam obnavlja.

Prijavite se lahko tudi znotraj seje: zaženite /mcp, izberite linkdash in izberite avtentikacijo. Povezavo preverite z:

claude mcp list

linkdash bi moral biti prikazan kot ✔ Connected. Nato ga preizkusite:

Skrajšaj https://example.com/pricing kot lida.sh/pricing.

Claude pokliče links_create in odgovori z novo kratko povezavo.

3. korak: delite nastavitev z ekipo

Če želite vsem v repozitoriju dati isti strežnik, v korensko mapo projekta dodajte datoteko .mcp.json:

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

V datoteki ni nič skrivnega, zato jo lahko varno shranite v repozitorij. Ko član ekipe prvič odpre projekt, ga Claude Code prosi, naj odobri strežnik, vsak pa se prijavi s svojim računom Linkdash, zato vsaka povezava pristane v računu tistega, ki jo je zahteval.

4. korak: določite, kaj se zažene brez vprašanja

Claude Code privzeto vpraša, preden pokliče orodje MCP. Branje statistike je neškodljivo, zato ga je vredno dovoliti; brisanje povezav pa je vredno povsem blokirati. Pravila dovoljenj dodajte v .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"
    ]
  }
}

Orodja MCP se imenujejo mcp__<server>__<tool>, zato ta pravila predpostavljajo, da ste strežnik v 1. koraku poimenovali linkdash. Ustvarjanje in posodabljanje povezav še vedno vsakič vpraša, zato imate nadzor nad vsem, kar spremeni, kam vodi povezava.

Delovni tokovi, ki se v terminalu splačajo

Skrajšajte vse povezave v izdaji

Ustvari kratke povezave za vse URL-je v CHANGELOG.md pod 2.4.0, jim dodaj oznako release-2.4 in zamenjaj URL-je v datoteki.

Claude prebere datoteko, za vsak URL enkrat pokliče links_create z oznako in uredi dnevnik sprememb. Oznaka drži povezave izdaje skupaj na nadzorni plošči in pri poznejših vprašanjih o statistiki.

Razdelite stran, ki ste jo pravkar zgradili

Ustvari lida.sh/pricing, ki obiskovalce razdeli 50/50 med /pricing in /pricing-v2, z utm_content, nastavljenim na ime vsake različice.

Claude ustvari eno povezavo z dvema različicama, vsako označeno tako, da vaše analitično orodje loči skupini. Vodnik o A/B-testu povezave opisuje, kako dolgo izvajati test in kako brati rezultat.

Delite build, ki poteče

Deli dist/app-1.4.2.dmg kot povezavo, ki poteče čez 3 dni in se ustavi po 5 odprtjih.

Ker ima Claude Code lupino, zna delati z datotekami: pokliče files_upload_url, datoteko s curl naloži na vrnjeni URL, nato pa pokliče links_create z naloženo datoteko, expires: "3d" in maxOpenings: 5. Datoteka nikoli ne gre skozi sam pogovor.

Preverite, kako se odrežejo povezave

Katere povezave z oznako release-2.4 so imele v zadnjih 7 dneh največ obiskov in od kod so obiski prišli?

Claude izpiše označene povezave, nato za vsako pokliče links_stats z last: "7d". Vsak rezultat vsebuje obiske, države in napotitelje. S pravili dovoljenj iz 4. koraka se ta branja izvedejo brez poziva.

Claude Code v CI

Prijava potrebuje osebo za brskalnikom, zato zagoni brez grafičnega vmesnika, kot je claude -p v opravilu CI, namesto tega uporabljajo ključ API. Ustvarite ga v razdelku Ključi API (ključi se začnejo z ldash_), ga shranite kot skrivnost CI z imenom LINKDASH_API_KEY in ga posredujte kot glavo:

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

Claude Code ${LINKDASH_API_KEY} izpolni iz okolja, zato sam ključ nikoli ne pristane v repozitoriju. Orodja in pravila dovoljenj delujejo enako v obeh primerih.

MCP ali CLI?

Claude Code lahko prek svoje lupine zažene tudi CLI linkdash, oba pa dostopata do istega računa:

  • MCP ne potrebuje namestitve. Claude vidi tipizirana orodja in njihove parametre, zato je lažja izbira, ko želite, da Claude preprosto upravlja povezave.
  • CLI (npm i -g linkdash-cli) izpisuje JSON, kar ustreza skriptam, ki jih Claude napiše za vas. Če želite Clauda naučiti CLI, namestite skill Linkdash za agente z npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Odpravljanje težav

  • linkdash prikazuje ! Needs authentication. Zaženite claude mcp login linkdash in se znova prijavite. To se zgodi tudi, ko Claude Code odklopite na nadzorni plošči.
  • Strežnik iz .mcp.json ostane na čakanju. V projektu zaženite claude in ga odobrite. claude mcp reset-project-choices počisti prejšnje izbire.
  • Orodja v CI odpovejo z napako 401. LINKDASH_API_KEY v tem okolju manjka ali je napačen ali pa je bil ključ izbrisan.

Pogosta vprašanja

Ali Claude vidi moje geslo ali ključ?

Ne. Prijavite se na linkdash.dev v brskalniku, Claude Code pa prejme žeton, ki ga hrani v svoji konfiguraciji. Niti vaše geslo niti žeton se ne pojavita v pogovoru.

Kako odklopim Claude Code?

Na nadzorni plošči Linkdash odprite Ključi API in v razdelku Povezane aplikacije kliknite Odklopi poleg Claude Code. Njegov dostop se takoj ustavi. Ukaz claude mcp logout linkdash prav tako odstrani shranjeni žeton z vašega računalnika.

Ali lahko Claude izbriše moje povezave?

Samo če mu to dovolite. Pravila deny iz 4. koraka blokirajo links_delete in variants_remove, tudi če Claude poskusi.

Ali je brezplačno?

Da, v paketu Free, ki vključuje 5.000 dogodkov na mesec. Višje omejitve najdete v cenah.

Lahko povežem tudi Cursor, Codex ali ChatGPT?

Da. Isti strežnik deluje z vsemi, večina pa potrebuje samo URL in prijavo. Dokumentacija MCP navaja korake za vsakega.