Serwer Linkly MCP

Serwer Linkly MCP 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ę.

Co to jest MCP?

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentom AI bezpiecznie połączyć 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 wykonanie działań bezpośrednio.

Obsługiwane asystenty AI

Serwer Linkly MCP współpracuje z:

• Claude Desktop
• ChatGPT Desktop
• Inne klienty kompatybilne z MCP (Cursor, Windsurf, itp.)

Gdzie go znaleźć

Serwer Linkly MCP znajduje się w głównych katalogach MCP, więc możesz go zainstalować z dowolnego miejsca, gdzie szukasz konektorów:

• Katalog konektora Claude — jednokrotne połączenie w Claude (web i Desktop)
• Oficjalny rejestr MCP — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — wtyczka Linkly dla Claude Code i Cowork
• Kod źródłowy na GitHub — licencja MIT

Serwer MCP czy Linkly CLI?

Jeśli twój asystent AI to agent kodujący, który może uruchamiać polecenia powłoki — taki jak Claude Code lub Cursor — Linkly CLI jest często lepszym wyborem niż serwer MCP. Agenci kodujący już lubią obsługiwać narzędzia wiersza poleceń, a CLI daje im wyjście --json dla każdego polecenia oraz polecenie linkly schema, które drukuje całe drzewo poleceń, aby agent mógł odkryć wszystko, co może zrobić. Serwer MCP pozostaje lepszym wyborem dla asystentów, którzy nie mogą uruchamiać poleceń powłoki, takich jak Claude Desktop i ChatGPT Desktop.

Co możesz zrobić

Po połączeniu możesz poprosić swojego asystenta AI, aby:

• Tworzył krótkie linki - „Utwórz krótki link dla https://example.com"
• Śledził wydajność - „Ile kliknięć otrzymały moje linki w tym tygodniu?"
• Zarządzał linkami - „Zaktualizuj link o nazwie 'promo' nowym adresem docelowym"
• Wyświetlał analitykę - „Pokaż mi kliknięcia wg kraju z ostatnich 30 dni"
• Wyszukiwał linki - „Znajdź wszystkie linki związane z uruchomieniem produktu"
• Zarządzał domenami - „Wypisz moje domeny niestandardowe"
• Konfigurował webhooki - „Subskrybuj https://my-site.com/webhook aby otrzymywać zdarzenia kliknięć"

Wprowadzenie

Hostowany serwer Linkly MCP znajduje się pod adresem https://mcp.linklyhq.com. Nie ma nic do zainstalowania i żadnego klucza API do skopiowania — serwer używa OAuth, więc po raz pierwszy, gdy twój asystent AI się połączy, otwiera się okno przeglądarki z prośbą o zalogowanie do Linkly i zatwierdzenie dostępu. Po tym twój asystent pozostaje połączony.

https://mcp.linklyhq.com

Konfiguracja

Claude desktop

W Claude Desktop przejdź do Settings → Connectors → Add custom connector. Wpisz nazwę (Linkly) i adres URL zdalnego serwera MCP:

https://mcp.linklyhq.com

Kliknij Add, a następnie Connect na konektorze Linkly. Otwiera się karta przeglądarki, aby się zalogować i zatwierdzić dostęp. Claude Desktop pozostaje wtedy połączony — nie jest potrzebny plik konfiguracyjny ani dodatkowe narzędzia.

Claude code (CLI)

Claude Code natywnie obsługuje zdalne serwery MCP. Dodaj Linkly za pomocą jednego polecenia:

claude mcp add --transport http linkly https://mcp.linklyhq.com

Następnie uruchom /mcp w Claude Code, wybierz linkly i autoryzuj w przeglądarce, gdy zostaniesz o to poproszony.

ChatGPT desktop

Otwórz swój plik konfiguracyjny ChatGPT:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Dodaj serwer Linkly MCP:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Dostępne narzędzia

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

"Could not connect to MCP server"

• Potwierdź, że https://mcp.linklyhq.com jest osiągalne z twojej maszyny
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie wyzwolić przepływ OAuth

"Authentication failed", "invalid_client", lub przeglądarka wciąż prosi o zalogowanie

Oznacza to, że twój klient przechowuje starą rejestrację połączenia. Wyczyść zbuforowane poświadczenia i ponownie autoryzuj. W Claude Code uruchom /mcp → linkly → połącz ponownie. W Claude Desktop usuń konektor Linkly w Settings → Connectors i dodaj go ponownie, a następnie zaloguj się ponownie.

Narzędzia nie pojawiają się

• Uruchom ponownie swojego asystenta AI po zapisaniu konfiguracji
• Sprawdź, czy składnia JSON w pliku konfiguracji jest prawidłowa
• Zweryfikuj, czy serwer MCP jest uruchomiony (sprawdź ikonę narzędzi w twoim asystencie)

Zasoby pokrewne

• Integracja Claude Desktop
• Integracja ChatGPT
• Dokumentacja API Linkly
• Linkly CLI
• Webhooki
• Model Context Protocol