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:

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ędzieOpis
create_linkUtwórz nowy krótki link z opcjonalnymi parametrami UTM, pikselami i więcej
update_linkZaktualizuj ustawienia istniejącego linku
delete_linkUsuń link
get_linkPobierz szczegóły konkretnego linku
list_linksWyświetl wszystkie linki w Twoim workspace
search_linksWyszukaj linki według nazwy, URL lub notatki
get_clicksPobierz ostatnie dane o kliknięciach
get_analyticsPobierz dane o kliknięciach w szeregu czasowym do wykresów
get_analytics_byPobierz kliknięcia pogrupowane według kraju, przeglądarki, platformy itp.
list_domainsWyświetl swoje niestandardowe domeny
list_webhooksWyświetl subskrypcje webhooków workspace
subscribe_webhookZasubskrybuj 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.com jest 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 /mcp i 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 /mcplinkly → 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