Preskoči na sadržaj
Sve objave

mcpclaude-codeagents

Kako dodati skraćivač URL-ova u Claude Code putem MCP-a

Povežite Claude Code s Linkdashom putem MCP-a da izrađuje kratke poveznice, dijeli promet i datoteke te čita statistiku klikova bez izlaska iz terminala.

Igor Kirnosov5 min čitanja

Claude Code poziva MCP poslužitelj Linkdasha i izrađuje kratku poveznicu lida.sh/pricing

Claude Code može izrađivati kratke poveznice i upravljati njima čim ga putem MCP-a povežete sa skraćivačem URL-ova. Dodajte MCP poslužitelj Linkdasha jednom naredbom, jednom se prijavite u pregledniku i Claude može skraćivati URL-ove, dijeliti promet između stranica, dijeliti datoteke s rokom isteka i čitati statistiku klikova, sve iz iste sesije u terminalu u kojoj piše vaš kod.

Ovaj vodič pokriva postavljanje, dijeljenje postavki s timom, odabir alata koje Claude smije pokretati bez pitanja, tijekove rada u kojima se to isplati i pokretanje u CI-ju. Koristite Cursor ili Codex? Dokumentacija o MCP-u navodi njihove naredbe za postavljanje.

Što Claude Code može s njim

MCP poslužitelj Linkdasha nudi iste operacije kao CLI i HTTP API, kao alate koje Claude sam otkriva:

Alati Što Claude može
links_create, links_update, links_delete Izrađivati, mijenjati, pauzirati i uklanjati poveznice
variants_add, variants_update, variants_remove Dijeliti promet ili usmjeravati po državi, uređaju ili OS-u
links_list, links_get, links_stats Pronalaziti poveznice i čitati posjete, države i izvore
files_upload_url Prenijeti datoteku i podijeliti je kao poveznicu
links_export, links_import Uvoziti i izvoziti poveznice kao CSV
domains_*, webhooks_* Upravljati vlastitim domenama i webhookovima

Korak 1: dodajte poslužitelj

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

Time se Linkdash dodaje za trenutačni projekt. Dodajte --scope user da bi bio dostupan u svakom projektu na vašem računalu.

Korak 2: prijavite se

claude mcp login linkdash

Preglednik otvara prijavu na Linkdash. Ako još nemate račun, ondje ga možete izraditi u paketu Free. Nakon prijave zaslon za privolu pita smije li Claude Code koristiti vaš račun. Kliknite Dopusti i Claude Code pohranjuje pristupni token te ga sam obnavlja.

Prijaviti se možete i unutar sesije: pokrenite /mcp, odaberite linkdash i odaberite autentifikaciju. Vezu provjerite naredbom:

claude mcp list

linkdash bi trebao biti prikazan kao ✔ Connected. Zatim ga isprobajte:

Skrati https://example.com/pricing kao lida.sh/pricing.

Claude poziva links_create i odgovara novom kratkom poveznicom.

Korak 3: podijelite postavke s timom

Da bi svi u repozitoriju imali isti poslužitelj, dodajte datoteku .mcp.json u korijen projekta:

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

U datoteci nema ničeg tajnog, pa je možete sigurno commitati. Kad kolega prvi put otvori projekt, Claude Code traži od njega da odobri poslužitelj, a svaka se osoba prijavljuje vlastitim računom na Linkdashu, pa svaka poveznica završava na računu onoga tko ju je zatražio.

Korak 4: odlučite što se pokreće bez pitanja

Prema zadanim postavkama Claude Code pita prije poziva MCP alata. Čitanje statistike je bezopasno, pa ga se isplati dopustiti; brisanje poveznica isplati se potpuno blokirati. Dodajte pravila dozvola u .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"
    ]
  }
}

MCP alati imaju nazive oblika mcp__<server>__<tool>, pa ova pravila pretpostavljaju da ste poslužitelj u koraku 1 nazvali linkdash. Izrada i ažuriranje poveznica i dalje svaki put traže potvrdu, pa ste upućeni u sve što mijenja kamo poveznica vodi.

Tijekovi rada koji se isplate u terminalu

Skratite sve poveznice u izdanju

Izradi kratke poveznice za svaki URL u CHANGELOG.md pod 2.4.0, označi ih s release-2.4 i zamijeni URL-ove u datoteci.

Claude čita datoteku, poziva links_create jednom po URL-u s oznakom i uređuje changelog. Oznaka drži poveznice izdanja na okupu na nadzornoj ploči i u kasnijim pitanjima o statistici.

Podijelite promet na stranici koju ste upravo izradili

Izradi lida.sh/pricing koji posjetitelje dijeli 50/50 između /pricing i /pricing-v2, s utm_content postavljenim na naziv svake varijante.

Claude izrađuje jednu poveznicu s dvije varijante, svaku označenu kako bi vaš alat za analitiku mogao razlikovati skupine. Vodič za A/B testiranje poveznice objašnjava koliko dugo provoditi test i kako čitati rezultat.

Podijelite build koji istječe

Podijeli dist/app-1.4.2.dmg kao poveznicu koja istječe za 3 dana i prestaje raditi nakon 5 otvaranja.

Budući da Claude Code ima ljusku, može raditi s datotekama: poziva files_upload_url, prenosi datoteku na vraćeni URL pomoću curl, a zatim poziva links_create s prenesenom datotekom, expires: "3d" i maxOpenings: 5. Datoteka nikad ne prolazi kroz sam razgovor.

Provjerite kako napreduju poveznice

Koje su poveznice s oznakom release-2.4 dobile najviše posjeta u zadnjih 7 dana i odakle su posjeti došli?

Claude ispisuje označene poveznice, a zatim za svaku poziva links_stats s last: "7d". Svaki rezultat sadrži posjete, države i izvore. S pravilima dozvola iz koraka 4 ta se čitanja pokreću bez upita.

Pokretanje Claude Codea u CI-ju

Za prijavu je potrebna osoba za preglednikom, pa pokretanja bez sučelja, poput claude -p u CI poslu, umjesto toga koriste API ključ. Izradite ga u odjeljku API ključevi (ključevi počinju s ldash_), pohranite ga kao CI tajnu s nazivom LINKDASH_API_KEY i proslijedite ga kao zaglavlje:

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

Claude Code popunjava ${LINKDASH_API_KEY} iz okruženja, pa se sam ključ nikad ne commita. Alati i pravila dozvola rade jednako u oba slučaja.

MCP ili CLI?

Claude Code može pokretati i CLI linkdash kroz svoju ljusku, a oba pristupaju istom računu:

  • MCP ne zahtijeva instalaciju. Claude vidi tipizirane alate i njihove parametre, pa je to lakši izbor kad samo želite da Claude upravlja poveznicama.
  • CLI (npm i -g linkdash-cli) ispisuje JSON, što odgovara skriptama koje Claude piše za vas. Da biste Claudea naučili CLI, instalirajte Linkdashov skill za agente naredbom npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Rješavanje problema

  • linkdash prikazuje ! Needs authentication. Pokrenite claude mcp login linkdash i ponovno se prijavite. To se događa i nakon što Claude Code odspojite na nadzornoj ploči.
  • Poslužitelj iz .mcp.json ostaje na čekanju. Pokrenite claude u projektu i odobrite ga. claude mcp reset-project-choices briše ranije odabire.
  • Alati u CI-ju ne uspijevaju s pogreškom 401. LINKDASH_API_KEY nedostaje ili je pogrešan u tom okruženju ili je ključ izbrisan.

Česta pitanja

Vidi li Claude moju lozinku ili ključ?

Ne. Prijavljujete se na linkdash.dev u svojem pregledniku, a Claude Code dobiva token koji čuva u vlastitoj konfiguraciji. Ni vaša lozinka ni token ne moraju se pojaviti u razgovoru.

Kako odspojiti Claude Code?

Na nadzornoj ploči Linkdasha otvorite API ključevi i kliknite Odspoji pokraj Claude Codea u odjeljku Povezane aplikacije. Njegov pristup odmah prestaje. Naredba claude mcp logout linkdash također uklanja pohranjeni token s vašeg računala.

Može li Claude izbrisati moje poveznice?

Samo ako mu to dopustite. Pravila zabrane iz koraka 4 blokiraju links_delete i variants_remove čak i ako Claude pokuša.

Je li besplatno?

Da, u paketu Free, koji uključuje 5.000 događaja mjesečno. Za veća ograničenja pogledajte cijene.

Mogu li povezati i Cursor, Codex ili ChatGPT?

Da. Isti poslužitelj radi sa svima njima, a većini trebaju samo URL i prijava. Dokumentacija o MCP-u navodi korake za svaki.