Siirry sisältöön
Kaikki kirjoitukset

mcpclaude-codeagents

Linkinlyhentäjä Claude Codeen MCP:n avulla

Yhdistä Claude Code Linkdashiin MCP:n kautta, niin se luo lyhytlinkkejä, jakaa liikennettä ja tiedostoja ja lukee klikkaustilastot poistumatta päätteestä.

Igor Kirnosov4 min lukuaika

Claude Code kutsuu Linkdashin MCP-palvelinta ja luo lyhytlinkin lida.sh/pricing

Claude Code osaa luoda ja hallita lyhytlinkkejä, kun yhdistät sen linkinlyhentäjään MCP:n kautta. Lisää Linkdashin MCP-palvelin yhdellä komennolla, kirjaudu kerran selaimessa, ja Claude voi lyhentää URL-osoitteita, jakaa liikennettä sivujen kesken, jakaa vanhenevia tiedostoja ja lukea klikkaustilastoja, kaikki samassa pääteistunnossa, jossa se kirjoittaa koodiasi.

Tämä opas käy läpi käyttöönoton, sen jakamisen tiimillesi, sen valitsemisen, mitä työkaluja Claude saa käyttää kysymättä, työnkulut, joissa siitä on eniten hyötyä, sekä käytön CI:ssä. Käytätkö sen sijaan Cursoria tai Codexia? MCP-dokumentaatiosta löydät niiden asennuskomennot.

Mitä Claude Code voi sillä tehdä

Linkdashin MCP-palvelin tarjoaa samat toiminnot kuin CLI ja HTTP API työkaluina, jotka Claude löytää itse:

Työkalut Mitä Claude voi tehdä
links_create, links_update, links_delete Luoda, muuttaa, keskeyttää ja poistaa linkkejä
variants_add, variants_update, variants_remove Jakaa liikennettä tai reitittää maan, laitteen tai käyttöjärjestelmän mukaan
links_list, links_get, links_stats Etsiä linkkejä ja lukea käynnit, maat ja viittaajat
files_upload_url Ladata tiedoston ja jakaa sen linkkinä
links_export, links_import Siirtää linkkejä sisään ja ulos CSV-muodossa
domains_*, webhooks_* Hallita omia verkkotunnuksia ja webhookeja

Vaihe 1: Lisää palvelin

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

Tämä lisää Linkdashin nykyiseen projektiin. Lisää --scope user, niin se on käytettävissä koneesi kaikissa projekteissa.

Vaihe 2: Kirjaudu sisään

claude mcp login linkdash

Selaimeesi avautuu Linkdashin kirjautumissivu. Jos sinulla ei vielä ole tiliä, voit luoda sen siellä Free-paketilla. Kirjautumisen jälkeen suostumusnäkymä kysyy, saako Claude Code käyttää tiliäsi. Klikkaa Salli, niin Claude Code tallentaa käyttöoikeustokenin ja uusii sen itse.

Voit myös kirjautua istunnon sisältä: suorita /mcp, valitse linkdash ja valitse todennus. Tarkista yhteys komennolla:

claude mcp list

linkdash-palvelimen tilana pitäisi näkyä ✔ Connected. Kokeile sitten:

Lyhennä https://example.com/pricing osoitteeksi lida.sh/pricing.

Claude kutsuu links_create-työkalua ja vastaa uudella lyhytlinkillä.

Vaihe 3: Jaa asetukset tiimillesi

Jos haluat kaikille repositorion käyttäjille saman palvelimen, lisää projektin juureen tiedosto .mcp.json:

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

Tiedostossa ei ole mitään salaista, joten sen voi turvallisesti commitoida. Kun tiimiläinen avaa projektin ensimmäisen kerran, Claude Code pyytää häntä hyväksymään palvelimen, ja jokainen kirjautuu omalla Linkdash-tilillään, joten jokainen linkki päätyy sen henkilön tilille, joka sitä pyysi.

Vaihe 4: Päätä, mitä saa ajaa kysymättä

Oletuksena Claude Code kysyy ennen kuin kutsuu MCP-työkalua. Tilastojen lukeminen on harmitonta, joten se kannattaa sallia; linkkien poistaminen kannattaa estää kokonaan. Lisää käyttöoikeussäännöt tiedostoon .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-työkalujen nimet ovat muotoa mcp__<server>__<tool>, joten nämä säännöt olettavat, että nimesit palvelimen linkdash vaiheessa 1. Linkkien luominen ja päivittäminen kysyy edelleen joka kerta, joten pysyt kartalla kaikesta, mikä muuttaa linkin kohdetta.

Työnkulut, joissa pääte maksaa itsensä takaisin

Lyhennä julkaisun kaikki linkit

Luo lyhytlinkit kaikille CHANGELOG.md:n URL-osoitteille kohdassa 2.4.0, tagaa ne release-2.4 ja korvaa URL-osoitteet tiedostossa.

Claude lukee tiedoston, kutsuu links_create-työkalua kerran URL-osoitetta kohden tagin kanssa ja muokkaa muutoslokia. Tagi pitää julkaisun linkit yhdessä hallintapaneelissa ja myöhemmissä tilastokysymyksissä.

Jaa juuri rakentamasi sivu kahtia

Luo lida.sh/pricing, joka jakaa kävijät 50/50 sivujen /pricing ja /pricing-v2 kesken, ja aseta utm_content kunkin variantin nimeksi.

Claude luo yhden linkin kahdella variantilla, kumpikin tagattuna niin, että analytiikkatyökalusi erottaa ryhmät toisistaan. Opas linkin A/B-testaamiseen kertoo, kuinka kauan testiä kannattaa ajaa ja miten tulosta luetaan.

Jaa vanheneva build

Jaa dist/app-1.4.2.dmg linkkinä, joka vanhenee 3 päivässä ja lakkaa toimimasta 5 avauskerran jälkeen.

Koska Claude Codella on komentotulkki, se osaa käsitellä tiedostoja: se kutsuu files_upload_url-työkalua, lataa tiedoston palautettuun URL-osoitteeseen curl-komennolla ja kutsuu sitten links_create-työkalua ladatulla tiedostolla sekä arvoilla expires: "3d" ja maxOpenings: 5. Tiedosto ei koskaan kulje itse keskustelun kautta.

Tarkista, miten linkit menestyvät

Mitkä release-2.4-tagatut linkit saivat eniten käyntejä viimeisen 7 päivän aikana, ja mistä käynnit tulivat?

Claude listaa tagatut linkit ja kutsuu sitten links_stats-työkalua kullekin arvolla last: "7d". Jokainen tulos sisältää käynnit, maat ja viittaajat. Vaiheen 4 käyttöoikeussäännöillä nämä lukutoiminnot ajetaan ilman kehotetta.

Claude Coden ajaminen CI:ssä

Kirjautuminen vaatii ihmisen selaimen ääreen, joten käyttöliittymättömät ajot, kuten claude -p CI-työssä, käyttävät sen sijaan API-avainta. Luo avain kohdassa API-avaimet (avaimet alkavat ldash_), tallenna se CI-salaisuudeksi nimellä LINKDASH_API_KEY ja välitä se otsakkeena:

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

Claude Code täyttää ${LINKDASH_API_KEY}-arvon ympäristöstä, joten itse avainta ei koskaan commitoida. Työkalut ja käyttöoikeussäännöt toimivat samoin kummallakin tavalla.

MCP vai CLI?

Claude Code voi myös ajaa linkdash-CLI:tä komentotulkissaan, ja molemmat käyttävät samaa tiliä:

  • MCP ei vaadi asennusta. Claude näkee tyypitetyt työkalut ja niiden parametrit, mikä tekee siitä helpomman valinnan, kun haluat vain Clauden hallitsevan linkkejä.
  • CLI (npm i -g linkdash-cli) tulostaa JSONia, mikä sopii skripteihin, joita Claude kirjoittaa puolestasi. Opeta Claudelle CLI asentamalla Linkdashin agenttiskill komennolla npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Vianmääritys

  • linkdash näyttää tilan ! Needs authentication. Suorita claude mcp login linkdash ja kirjaudu uudelleen. Näin käy myös, kun katkaiset Claude Coden yhteyden hallintapaneelissa.
  • .mcp.json-tiedoston palvelin jää odottamaan. Käynnistä claude projektissa ja hyväksy palvelin. claude mcp reset-project-choices tyhjentää aiemmat valinnat.
  • Työkalut epäonnistuvat CI:ssä virheellä 401. LINKDASH_API_KEY puuttuu tai on väärä siinä ympäristössä, tai avain on poistettu.

UKK

Näkeekö Claude salasanani tai avaimen?

Ei. Kirjaudut sivustolla linkdash.dev selaimessasi, ja Claude Code saa tokenin, jonka se säilyttää omissa asetuksissaan. Salasanasi tai tokenin ei tarvitse näkyä keskustelussa.

Miten katkaisen Claude Coden yhteyden?

Avaa Linkdashin hallintapaneelissa API-avaimet ja klikkaa Katkaise yhteys Claude Coden vieressä kohdassa Yhdistetyt sovellukset. Sen pääsy päättyy heti. Komento claude mcp logout linkdash poistaa myös tallennetun tokenin koneeltasi.

Voiko Claude poistaa linkkini?

Vain jos annat sen tehdä niin. Vaiheen 4 estosäännöt estävät links_delete- ja variants_remove-työkalut, vaikka Claude yrittäisi.

Onko se ilmainen?

Kyllä, Free-paketissa, johon sisältyy 5 000 tapahtumaa kuukaudessa. Korkeammat rajat löydät hinnoittelusta.

Voinko yhdistää myös Cursorin, Codexin tai ChatGPT:n?

Kyllä. Sama palvelin toimii niiden kaikkien kanssa, ja useimmat tarvitsevat vain URL-osoitteen ja kirjautumisen. MCP-dokumentaatio listaa vaiheet kullekin.