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 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
Skróć każdy link w wydaniu
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 poleceniemnpx skills add https://linkdash.dev/skills/linkdash/SKILL.md.
Rozwiązywanie problemów
linkdashpokazuje! Needs authentication. Uruchomclaude mcp login linkdashi zaloguj się ponownie. Dzieje się tak również po odłączeniu Claude Code w panelu.- Serwer z
.mcp.jsonciągle czeka na zatwierdzenie. Uruchomclaudew projekcie i zatwierdź go.claude mcp reset-project-choicesczyś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.

