Liigu sisu juurde
Kõik postitused

mcpclaude-codeagents

Kuidas lisada Claude Code’ile MCP kaudu URL-i lühendaja

Ühenda Claude Code MCP kaudu Linkdashiga, et see saaks luua lühilinke, jaotada liiklust, jagada faile ja lugeda klikistatistikat terminalist lahkumata.

Igor Kirnosov5 min lugemist

Claude Code kutsub Linkdashi MCP-serverit, et luua lühilink lida.sh/pricing

Claude Code saab lühilinke luua ja hallata, kui ühendad selle MCP kaudu URL-i lühendajaga. Lisa Linkdashi MCP-server ühe käsuga, logi brauseris üks kord sisse ja Claude saab lühendada URL-e, jaotada liiklust lehtede vahel, jagada aeguvaid faile ja lugeda klikistatistikat — kõike samas terminaliseansis, kus see sinu koodi kirjutab.

See juhend käsitleb seadistamist, selle jagamist meeskonnaga, valikut, milliseid tööriistu Claude võib küsimata käivitada, töövooge, kus see end ära tasub, ja kasutamist CI-s. Kasutad hoopis Cursorit või Codexit? MCP dokumentatsioon loetleb nende seadistuskäsud.

Mida Claude Code sellega teha saab

Linkdashi MCP-server pakub samu toiminguid nagu CLI ja HTTP API, tööriistadena, mille Claude ise üles leiab:

Tööriistad Mida Claude teha saab
links_create, links_update, links_delete Linke luua, muuta, peatada ja eemaldada
variants_add, variants_update, variants_remove Liiklust jaotada või suunata riigi, seadme või OS-i järgi
links_list, links_get, links_stats Linke leida ning külastusi, riike ja viitajaid lugeda
files_upload_url Faili üles laadida ja lingina jagada
links_export, links_import Linke CSV-na sisse ja välja viia
domains_*, webhooks_* Oma domeene ja webhooke hallata

1. samm: lisa server

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

See lisab Linkdashi praegusele projektile. Lisa --scope user, et see oleks saadaval igas sinu masina projektis.

2. samm: logi sisse

claude mcp login linkdash

Brauseris avaneb Linkdashi sisselogimine. Kui sul veel kontot pole, saad selle seal Free paketiga luua. Pärast sisselogimist küsib nõusolekuaken, kas Claude Code võib sinu kontot kasutada. Klõpsa Luba ning Claude Code salvestab juurdepääsutokeni ja uuendab seda ise.

Sisse saad logida ka seansi seest: käivita /mcp, vali linkdash ja vali autentimine. Kontrolli ühendust käsuga:

claude mcp list

linkdash peaks olema olekus ✔ Connected. Siis proovi:

Lühenda https://example.com/pricing kujule lida.sh/pricing.

Claude kutsub links_create ja vastab uue lühilingiga.

3. samm: jaga seadistust meeskonnaga

Et kõigil repositooriumi kasutajatel oleks sama server, lisa projekti juurkausta fail .mcp.json:

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

Failis pole midagi salajast, nii et selle võib julgelt commit’ida. Kui meeskonnaliige projekti esimest korda avab, palub Claude Code tal serveri kinnitada ja igaüks logib sisse oma Linkdashi kontoga, nii et iga link satub selle inimese kontole, kes seda küsis.

4. samm: otsusta, mis käivitub küsimata

Vaikimisi küsib Claude Code enne MCP-tööriista kutsumist luba. Statistika lugemine on ohutu, seega tasub see lubada; linkide kustutamine tasub täielikult keelata. Lisa õiguste reeglid faili .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-tööriistade nimed on kujul mcp__<server>__<tool>, nii et need reeglid eeldavad, et nimetasid 1. sammus serveri linkdash. Linkide loomine ja uuendamine küsib endiselt iga kord luba, nii et oled kursis kõigega, mis muudab seda, kuhu link viib.

Töövood, mis terminalis end ära tasuvad

Lühenda väljalaske kõik lingid

Loo lühilingid kõigile CHANGELOG.md URL-idele jaotises 2.4.0, lisa neile silt release-2.4 ja asenda failis URL-id.

Claude loeb faili, kutsub iga URL-i jaoks üks kord links_create koos sildiga ja muudab muudatuste logi. Silt hoiab väljalaske lingid töölaual ja hilisemates statistikaküsimustes koos.

Jaota äsja ehitatud leht

Loo lida.sh/pricing, mis jaotab külastajad 50/50 lehtede /pricing ja /pricing-v2 vahel, utm_content väärtuseks iga variandi nimi.

Claude loob ühe lingi kahe variandiga, millest kumbki on sildistatud, et sinu analüütikatööriist suudaks rühmi eristada. Juhend lingi A/B-testimiseks räägib, kui kaua testi käitada ja kuidas tulemust lugeda.

Jaga aeguvat buildi

Jaga dist/app-1.4.2.dmg lingina, mis aegub 3 päeva pärast ja lakkab töötamast pärast 5 avamist.

Kuna Claude Code’il on shell, saab see failidega hakkama: see kutsub files_upload_url, laadib faili curl-iga tagastatud URL-ile üles ja kutsub seejärel links_create üleslaaditud failiga, expires: "3d" ja maxOpenings: 5. Fail ise ei käi kunagi vestlusest läbi.

Vaata, kuidas lingid toimivad

Millised sildiga release-2.4 lingid said viimase 7 päeva jooksul kõige rohkem külastusi ja kust külastused tulid?

Claude loetleb sildistatud lingid ja kutsub seejärel igaühe jaoks links_stats väärtusega last: "7d". Iga tulemus sisaldab külastusi, riike ja viitajaid. 4. sammu õiguste reeglitega käivituvad need lugemised ilma küsimata.

Claude Code’i käitamine CI-s

Sisselogimine vajab brauseri taga inimest, nii et graafilise liideseta käivitused, näiteks claude -p CI-töös, kasutavad selle asemel API-võtit. Loo võti lehel API-võtmed (võtmed algavad ldash_), salvesta see CI saladusena nimega LINKDASH_API_KEY ja anna see päisena edasi:

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

Claude Code täidab ${LINKDASH_API_KEY} keskkonnast, nii et võtit ennast ei commit’ita kunagi. Tööriistad ja õiguste reeglid töötavad mõlemal juhul samamoodi.

MCP või CLI?

Claude Code saab oma shelli kaudu käivitada ka linkdash CLI ja mõlemad jõuavad sama kontoni:

  • MCP ei vaja paigaldamist. Claude näeb tüübitud tööriistu ja nende parameetreid, mis teeb sellest lihtsama valiku, kui tahad lihtsalt, et Claude linke haldaks.
  • CLI (npm i -g linkdash-cli) väljastab JSON-i, mis sobib skriptidele, mida Claude sinu jaoks kirjutab. Et Claude CLI-d tundma õpiks, paigalda Linkdashi agendi skill käsuga npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Tõrkeotsing

  • linkdash näitab olekut ! Needs authentication. Käivita claude mcp login linkdash ja logi uuesti sisse. See juhtub ka pärast seda, kui ühendad Claude Code’i töölaual lahti.
  • Server failist .mcp.json jääb ootele. Käivita projektis claude ja kinnita server. claude mcp reset-project-choices tühjendab varasemad valikud.
  • Tööriistad ebaõnnestuvad CI-s veaga 401. LINKDASH_API_KEY puudub selles keskkonnas või on vale või on võti kustutatud.

KKK

Kas Claude näeb minu parooli või võtit?

Ei. Logid brauseris sisse saidil linkdash.dev ja Claude Code saab tokeni, mida hoiab oma konfiguratsioonis. Ei sinu parool ega token ei pea vestluses kunagi ilmuma.

Kuidas Claude Code’i lahti ühendada?

Ava Linkdashi töölaual API-võtmed ja klõpsa jaotises Ühendatud rakendused Claude Code’i kõrval Ühenda lahti. Selle juurdepääs lõpeb kohe. Käsk claude mcp logout linkdash eemaldab ka sinu masinast salvestatud tokeni.

Kas Claude saab minu linke kustutada?

Ainult siis, kui sa seda lubad. 4. sammu keelureeglid blokeerivad links_delete ja variants_remove, isegi kui Claude seda proovib.

Kas see on tasuta?

Jah, Free paketis, mis sisaldab 5000 sündmust kuus. Suuremate limiitide kohta vaata hindu.

Kas saan ühendada ka Cursori, Codexi või ChatGPT?

Jah. Sama server töötab nendega kõigiga ja enamik vajab ainult URL-i ja sisselogimist. MCP dokumentatsioon loetleb igaühe sammud.