Przejdź do treści
Wszystkie wpisy

mcpclaude-codeagents

Jak dodać skracacz linków do Claude Code przez MCP

Połącz Claude Code z Linkdash przez MCP, aby tworzył krótkie linki, dzielił ruch, udostępniał pliki i czytał statystyki kliknięć bez wychodzenia z terminala.

Igor Kirnosov5 min czytania

Claude Code wywołujący serwer MCP Linkdash, aby utworzyć krótki link lida.sh/pricing

Claude Code może tworzyć krótkie linki i nimi zarządzać, gdy połączysz go ze skracaczem linków przez MCP. Dodaj serwer MCP Linkdash jednym poleceniem, zaloguj się raz w przeglądarce, a Claude będzie skracać URL-e, dzielić ruch między strony, udostępniać pliki z datą wygaśnięcia i czytać statystyki kliknięć — wszystko w tej samej sesji terminala, w której pisze twój kod.

Ten poradnik opisuje konfigurację, udostępnienie jej zespołowi, wybór narzędzi, które Claude może uruchamiać bez pytania, scenariusze, w których to się opłaca, i uruchamianie w CI. Używasz zamiast tego Cursor albo Codex? Dokumentacja MCP podaje polecenia konfiguracyjne dla nich.

Co Claude Code może z tym zrobić

Serwer MCP Linkdash udostępnia te same operacje co CLI i HTTP API w postaci narzędzi, które Claude wykrywa sam:

Narzędzia Co Claude może zrobić
links_create, links_update, links_delete Tworzyć, zmieniać, wstrzymywać i usuwać linki
variants_add, variants_update, variants_remove Dzielić ruch albo kierować go według kraju, urządzenia lub systemu
links_list, links_get, links_stats Wyszukiwać linki i czytać wizyty, kraje i źródła odesłań
files_upload_url Przesłać plik i udostępnić go jako link
links_export, links_import Eksportować i importować linki w CSV
domains_*, webhooks_* Zarządzać własnymi domenami i webhookami

Krok 1: Dodaj serwer

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

To polecenie dodaje Linkdash do bieżącego projektu. Dodaj --scope user, aby serwer był dostępny w każdym projekcie na twojej maszynie.

Krok 2: Zaloguj się

claude mcp login linkdash

Przeglądarka otworzy logowanie do Linkdash. Jeśli nie masz jeszcze konta, możesz je tam założyć w planie Free. Po zalogowaniu ekran zgody zapyta, czy Claude Code może korzystać z twojego konta. Kliknij Zezwól, a Claude Code zapisze token dostępu i będzie go sam odnawiać.

Możesz też zalogować się w trakcie sesji: uruchom /mcp, wybierz linkdash i wybierz uwierzytelnienie. Połączenie sprawdzisz poleceniem:

claude mcp list

linkdash powinien mieć status ✔ Connected. Potem wypróbuj:

Skróć https://example.com/pricing jako lida.sh/pricing.

Claude wywoła links_create i odpowie nowym krótkim linkiem.

Krok 3: Udostępnij konfigurację zespołowi

Aby każdy w repozytorium miał ten sam serwer, dodaj plik .mcp.json w katalogu głównym projektu:

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

W pliku nie ma niczego tajnego, więc można go bezpiecznie commitować. Gdy osoba z zespołu pierwszy raz otworzy projekt, Claude Code poprosi ją o zatwierdzenie serwera, a każdy loguje się własnym kontem Linkdash, więc każdy link trafia na konto osoby, która o niego poprosiła.

Krok 4: Zdecyduj, co działa bez pytania

Domyślnie Claude Code pyta, zanim wywoła narzędzie MCP. Czytanie statystyk jest nieszkodliwe, więc warto na nie zezwolić; usuwanie linków warto zablokować całkowicie. Dodaj reguły uprawnień 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"
    ]
  }
}

Narzędzia MCP mają nazwy w formacie mcp__<server>__<tool>, więc te reguły zakładają, że w kroku 1 serwer nazywa się linkdash. Tworzenie i aktualizowanie linków nadal za każdym razem wymaga zgody, więc masz kontrolę nad wszystkim, co zmienia cel linku.

Scenariusze, które opłacają się w terminalu

Utwórz krótkie linki dla każdego URL-a w CHANGELOG.md w sekcji 2.4.0, otaguj je release-2.4 i podmień URL-e w pliku.

Claude czyta plik, wywołuje links_create raz dla każdego URL-a z tagiem i edytuje changelog. Tag trzyma linki z wydania razem w panelu i przy późniejszych pytaniach o statystyki.

Podziel ruch na stronie, którą właśnie zbudowano

Utwórz lida.sh/pricing, który dzieli odwiedzających 50/50 między /pricing i /pricing-v2, z utm_content ustawionym na nazwę każdego wariantu.

Claude tworzy jeden link z dwoma wariantami, każdy otagowany tak, by twoje narzędzie analityczne odróżniło grupy. Poradnik o testach A/B linku opisuje, jak długo prowadzić test i jak czytać wynik.

Udostępnij build, który wygasa

Udostępnij dist/app-1.4.2.dmg jako link, który wygaśnie za 3 dni i przestanie działać po 5 otwarciach.

Ponieważ Claude Code ma dostęp do powłoki, radzi sobie z plikami: wywołuje files_upload_url, przesyła plik pod zwrócony URL przez curl, a potem wywołuje links_create z przesłanym plikiem, expires: "3d" i maxOpenings: 5. Plik nigdy nie przechodzi przez samą rozmowę.

Sprawdź, jak radzą sobie linki

Które linki z tagiem release-2.4 miały najwięcej wizyt w ciągu ostatnich 7 dni i skąd przyszły te wizyty?

Claude listuje otagowane linki, a potem wywołuje links_stats dla każdego z last: "7d". Każdy wynik zawiera wizyty, kraje i źródła odesłań. Z regułami uprawnień z kroku 4 te odczyty działają bez pytania.

Claude Code w CI

Logowanie wymaga człowieka przy przeglądarce, więc uruchomienia bez interfejsu, np. claude -p w zadaniu CI, używają zamiast tego klucza API. Utwórz go w sekcji Klucze API (klucze zaczynają się od ldash_), zapisz jako sekret CI o nazwie LINKDASH_API_KEY i przekaż w nagłówku:

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

Claude Code uzupełnia ${LINKDASH_API_KEY} ze zmiennych środowiskowych, więc sam klucz nigdy nie trafia do repozytorium. Narzędzia i reguły uprawnień działają tak samo w obu przypadkach.

MCP czy CLI?

Claude Code może też uruchamiać CLI linkdash przez powłokę, a oba sposoby trafiają na to samo konto:

  • MCP nie wymaga instalacji. Claude widzi typowane narzędzia i ich parametry, więc to prostszy wybór, gdy chcesz po prostu, żeby Claude zarządzał linkami.
  • CLI (npm i -g linkdash-cli) wypisuje JSON, co pasuje do skryptów, które Claude pisze dla ciebie. Aby nauczyć Claude obsługi CLI, zainstaluj skill Linkdash dla agentów poleceniem npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Rozwiązywanie problemów

  • linkdash pokazuje ! Needs authentication. Uruchom claude mcp login linkdash i zaloguj się ponownie. Dzieje się tak również po odłączeniu Claude Code w panelu.
  • Serwer z .mcp.json ciągle czeka na zatwierdzenie. Uruchom claude w projekcie i zatwierdź go. claude mcp reset-project-choices czyści wcześniejsze wybory.
  • Narzędzia w CI kończą się błędem 401. W tym środowisku brakuje LINKDASH_API_KEY, ma on złą wartość albo klucz został usunięty.

FAQ

Czy Claude widzi moje hasło albo klucz?

Nie. Logujesz się na linkdash.dev w przeglądarce, a Claude Code otrzymuje token, który trzyma we własnej konfiguracji. Ani twoje hasło, ani token nie muszą pojawić się w rozmowie.

Jak odłączyć Claude Code?

W panelu Linkdash otwórz Klucze API i kliknij Odłącz obok Claude Code w sekcji Połączone aplikacje. Dostęp ustaje natychmiast. Polecenie claude mcp logout linkdash usuwa też zapisany token z twojej maszyny.

Czy Claude może usunąć moje linki?

Tylko jeśli mu na to pozwolisz. Reguły deny z kroku 4 blokują links_delete i variants_remove, nawet jeśli Claude spróbuje.

Czy to jest darmowe?

Tak, w planie Free, który obejmuje 5000 zdarzeń miesięcznie. Wyższe limity znajdziesz w cenniku.

Czy mogę połączyć też Cursor, Codex albo ChatGPT?

Tak. Ten sam serwer działa ze wszystkimi, a większość potrzebuje tylko URL-a i logowania. Dokumentacja MCP podaje kroki dla każdego z nich.

Linkdash

© 2026 Igor Kirnosov s.p. Wszelkie prawa zastrzeżone.