Serwer MCP Linkly
Serwer MCP Linkly pozwala połączyć asystentów AI z Twoim kontem Linkly za pomocą Model Context Protocol. Po połączeniu możesz tworzyć i zarządzać krótkimi linkami poprzez naturalną konwersację.
Czym jest MCP?
Model Context Protocol (MCP) to otwarty standard, który umożliwia asystentom AI bezpieczne łączenie się z zewnętrznymi narzędziami i źródłami danych. Zamiast kopiować i wklejać między aplikacjami, możesz poprosić swojego asystenta AI o bezpośrednie wykonanie działań.
Obsługiwani asystenci AI
Serwer MCP Linkly współpracuje z:
- Claude Desktop
- ChatGPT Desktop
- Innymi klientami zgodnymi z MCP (Cursor, Windsurf itp.)
Co możesz zrobić
Po połączeniu możesz poprosić swojego asystenta AI o:
- Tworzenie krótkich linków - "Utwórz krótki link dla https://example.com"
- Śledzenie wyników - "Ile kliknięć miały moje linki w tym tygodniu?"
- Zarządzanie linkami - "Zaktualizuj link o nazwie 'promo' z nowym adresem docelowym"
- Przeglądanie analityki - "Pokaż mi kliknięcia według kraju z ostatnich 30 dni"
- Wyszukiwanie linków - "Znajdź wszystkie linki związane z premierą produktu"
- Zarządzanie domenami - "Wyświetl moje niestandardowe domeny"
- Konfigurowanie webhooków - "Zasubskrybuj
https://my-site.com/webhook, aby otrzymywać zdarzenia kliknięć"
Opcje instalacji
Serwer MCP Linkly jest dostępny na dwa sposoby:
Opcja 1: Serwer hostowany (Zalecane)
Użyj naszego hostowanego serwera MCP - nie wymaga instalacji:
https://mcp.linklyhq.com
Opcja 2: Pakiet npm
Zainstaluj i uruchom lokalnie za pomocą npx:
npx -y linkly-mcp-server
Lub zainstaluj globalnie:
npm install -g linkly-mcp-server
Zobacz pakiet na npm.
Konfiguracja
Uzyskiwanie poświadczeń API
- 1Zaloguj się do panelu Linkly
- 2Przejdź do Ustawienia → Klucze API
- 3Skopiuj swój Klucz API i ID Workspace
Konfiguracja Claude Desktop
Otwórz plik konfiguracyjny Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Dodaj serwer MCP Linkly:
{
"mcpServers": {
"linkly": {
"command": "npx",
"args": ["-y", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "twój-klucz-api",
"LINKLY_WORKSPACE_ID": "twój-id-workspace"
}
}
}
}
Konfiguracja ChatGPT Desktop
Otwórz plik konfiguracyjny ChatGPT:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
Dodaj serwer MCP Linkly:
Używając npx:
{
"servers": {
"linkly": {
"command": "npx",
"args": ["-y", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "twój-klucz-api"
}
}
}
}
Używając serwera hostowanego:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com",
"env": {
"LINKLY_API_KEY": "twój-klucz-api"
}
}
}
}
Dostępne narzędzia
| Narzędzie | Opis |
|---|---|
create_link | Utwórz nowy krótki link z opcjonalnymi parametrami UTM, pikselami i więcej |
update_link | Zaktualizuj ustawienia istniejącego linku |
delete_link | Usuń link |
get_link | Pobierz szczegóły konkretnego linku |
list_links | Wyświetl wszystkie linki w Twoim workspace |
search_links | Wyszukaj linki według nazwy, URL lub notatki |
get_clicks | Pobierz ostatnie dane o kliknięciach |
get_analytics | Pobierz dane o kliknięciach w szeregu czasowym do wykresów |
get_analytics_by | Pobierz kliknięcia pogrupowane według kraju, przeglądarki, platformy itp. |
list_domains | Wyświetl swoje niestandardowe domeny |
list_webhooks | Wyświetl subskrypcje webhooków workspace |
subscribe_webhook | Zasubskrybuj URL, aby otrzymywać zdarzenia kliknięć |
Opcje tworzenia linków
Podczas tworzenia linków możesz określić:
- Podstawowe:
url,name,note,domain,slug,enabled - Parametry UTM:
utm_source,utm_medium,utm_campaign,utm_term,utm_content - Open Graph:
og_title,og_description,og_image - Śledzenie:
fb_pixel_id,ga4_tag_id,gtm_id - Zaawansowane:
cloaking,forward_params,block_bots,hide_referrer - Wygaśnięcie:
expiry_datetime,expiry_destination
Zmienne środowiskowe
| Zmienna | Wymagana | Opis |
|---|---|---|
LINKLY_API_KEY | Tak | Twój klucz API Linkly |
LINKLY_WORKSPACE_ID | Nie | ID Twojego workspace (niektórzy klienci tego wymagają) |
Rozwiązywanie problemów
"Nie można połączyć się z serwerem MCP"
- Sprawdź, czy Twój klucz API i ID Workspace są poprawne
- Upewnij się, że masz zainstalowany Node.js (wersja 18 lub nowsza)
- Spróbuj uruchomić
npx linkly-mcp-serverw terminalu, aby zobaczyć ewentualne błędy
"Uwierzytelnianie nie powiodło się"
- Zweryfikuj swój klucz API w panelu Linkly w Ustawienia → Klucze API
- Upewnij się, że w Twoich poświadczeniach nie ma dodatkowych spacji
- Spróbuj wygenerować ponownie swój klucz API
Narzędzia się nie pojawiają
- Uruchom ponownie swojego asystenta AI po zapisaniu konfiguracji
- Sprawdź, czy składnia JSON w pliku konfiguracyjnym jest poprawna
- Zweryfikuj, czy serwer MCP działa (sprawdź ikonę narzędzi w swoim asystencie)
Serwer nie jest dostępny
- Potwierdź, że ścieżka polecenia jest poprawna
- Jeśli używasz serwera hostowanego, sprawdź swoje połączenie internetowe
- Zweryfikuj, czy serwer MCP uruchamia się ręcznie z terminala
Powiązane zasoby
FAQ dotyczące serwera MCP
Czy muszę coś instalować, aby używać serwera MCP?
Nie, jeśli używasz serwera hostowanego pod adresem https://mcp.linklyhq.com. Jeśli wolisz uruchomić go lokalnie, będziesz potrzebować zainstalowanego Node.js w wersji 18 lub nowszej.
Którzy asystenci AI obsługują MCP?
Claude Desktop i ChatGPT Desktop obsługują MCP. Inne narzędzia, takie jak Cursor i Windsurf, również mają wsparcie dla MCP.
Czy mój klucz API jest bezpieczny?
Tak. Twój klucz API jest przechowywany lokalnie w pliku konfiguracyjnym Twojego asystenta AI i jest wysyłany tylko do serwerów Linkly podczas wykonywania żądań API. Nigdy nie jest udostępniany samemu modelowi AI.
Czy mogę używać MCP z internetowymi wersjami Claude lub ChatGPT?
Nie, MCP wymaga aplikacji desktopowych. Wersje internetowe nie obsługują połączeń MCP.
Jak zaktualizować serwer MCP?
Jeśli używasz npx, automatycznie pobiera najnowszą wersję za każdym razem. Jeśli zainstalowałeś globalnie, uruchom npm update -g linkly-mcp-server.
Śledź 500 miesięcznych kliknięć ze wszystkimi funkcjami.
Nie potrzebujesz karty kredytowej