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ęć"
Pierwsze kroki
Hostowany serwer MCP Linkly jest dostępny pod adresem https://mcp.linklyhq.com. Nie musisz niczego instalować ani kopiować klucza API — serwer korzysta z OAuth, więc przy pierwszym połączeniu Twojego asystenta AI otworzy się okno przeglądarki z prośbą o zalogowanie się do Linkly i zatwierdzenie dostępu. Od tego momentu Twój asystent pozostanie połączony.
https://mcp.linklyhq.com
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", "mcp-remote", "https://mcp.linklyhq.com"]
}
}
}
Uruchom ponownie Claude Desktop. Przy pierwszym użyciu narzędzia Linkly otworzy się karta przeglądarki, w której zalogujesz się i zatwierdzisz dostęp.
Claude Code (CLI)
Claude Code obsługuje zdalne serwery MCP natywnie. Dodaj Linkly jednym poleceniem:
claude mcp add --transport http linkly https://mcp.linklyhq.com
Następnie uruchom /mcp w Claude Code, wybierz linkly i autoryzuj się w przeglądarce, gdy pojawi się prośba.
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:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}
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
Rozwiązywanie problemów
"Nie można połączyć się z serwerem MCP"
- Upewnij się, że adres
https://mcp.linklyhq.comjest dostępny z Twojego komputera - Jeśli Twój klient korzysta z
mcp-remote, sprawdź, czy masz zainstalowany Node.js w wersji 18 lub nowszej - W Claude Code uruchom
/mcpi wybierz linkly, aby ponownie uruchomić przepływ OAuth
"Uwierzytelnianie nie powiodło się" / przeglądarka wciąż prosi o zalogowanie
Wyczyść zapamiętane dane uwierzytelniające MCP w swoim kliencie i autoryzuj się ponownie. W Claude Code uruchom /mcp → linkly → połącz ponownie. W Claude Desktop zamknij aplikację, usuń zapamiętany token mcp-remote w ~/.mcp-auth/ i uruchom ją ponownie.
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)
Powiązane zasoby
FAQ dotyczące serwera MCP
Czy muszę coś instalować, aby używać serwera MCP?
Nie. Hostowany serwer pod adresem https://mcp.linklyhq.com korzysta z OAuth — wystarczy jednorazowe zalogowanie w przeglądarce, a Twój asystent AI pozostanie połączony. Poza samym asystentem AI nie musisz niczego instalować na swoim komputerze.
Czy potrzebuję klucza API?
Nie. Serwer MCP korzysta z OAuth — przy pierwszym połączeniu Twojego asystenta AI logujesz się do Linkly w przeglądarce i nie musisz nigdzie kopiować ani wklejać klucza API.
Którzy asystenci AI obsługują MCP?
Claude Desktop, Claude Code (CLI) i ChatGPT Desktop obsługują MCP. Inne narzędzia, takie jak Cursor i Windsurf, również mają wsparcie dla MCP.
Czy moje konto jest bezpieczne?
Tak. Hostowany serwer korzysta z OAuth 2.1 z PKCE — Twoje hasło do Linkly wpisujesz wyłącznie na app.linklyhq.com, a Twój asystent AI otrzymuje jedynie token dostępu ograniczony do Twojego workspace. Sam model AI nigdy nie widzi Twoich danych uwierzytelniających.
Czy mogę używać MCP z internetowymi wersjami Claude lub ChatGPT?
Nie, MCP wymaga aplikacji desktopowych lub interfejsu Claude Code CLI. Wersje internetowe nie obsługują połączeń MCP.
Jak zaktualizować serwer MCP?
Nie musisz nic aktualizować — wdrażamy ulepszenia do hostowanego serwera na bieżąco, a każdy połączony klient otrzymuje je automatycznie.
Śledź 500 kliknięć miesięcznie ze wszystkimi funkcjami włączonymi.
Karta kredytowa nie wymagana