Serwer Linkly MCP

Serwer Linkly MCP pozwala Ci 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 połą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, aby wykonał akcje bezpośrednio.

Obsługiwani asystenci AI

Serwer Linkly MCP działa z:

• Claude Desktop
• ChatGPT Desktop
• Inni klienci kompatybilni z MCP (Cursor, Windsurf, itp.)

Serwer MCP czy Linkly CLI?

Jeśli Twój asystent AI to agent kodujący, który potrafi uruchamiać polecenia powłoki — na przykład Claude Code lub Cursor — Linkly CLI jest często lepszym rozwiązaniem niż serwer MCP. Agenci kodujący już chętnie korzystają z narzędzi wiersza poleceń, a CLI daje im wyjście --json dla każdego polecenia plus polecenie linkly schema, które wyświetla pełne drzewo poleceń, dzięki czemu agent może odkrywać wszystko, co potrafi 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 robić

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

• Tworzył krótkie linki - "Utwórz krótki link do 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ł analizę - "Pokaż mi kliknięcia według kraju z ostatnich 30 dni"
• Szukał linków - "Znajdź wszystkie linki związane z premierą produktu"
• Zarządzał domenami - "Wyświetl moje niestandardowe domeny"
• Konfigurował webhooks - "Zasubskrybuj https://my-site.com/webhook, aby otrzymywać zdarzenia kliknięcia"

Pierwsza konfiguracja

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 za pierwszym razem, gdy Twój asystent AI się połączy, otworzy się okno przeglądarki z prośbą o zalogowanie się do Linkly i zatwierdzenie dostępu. Po tym Twój asystent pozostaje 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 Linkly MCP:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Zrestartuj Claude Desktop. Za pierwszym razem, gdy użyjesz narzędzia Linkly, otworzy się karta przeglądarki, aby zalogować się i zatwierdzić dostęp.

Claude code (CLI)

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

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

Następnie uruchom /mcp wewnątrz Claude Code, wybierz linkly i autoryzuj się w przeglądarce, gdy pojawi się monit.

ChatGPT desktop

Otwórz 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

"Nie można połączyć się z serwerem MCP"

• Potwierdź, że https://mcp.linklyhq.com jest dostępny z Twojej maszyny
• Jeśli Twój klient używa mcp-remote, upewnij się, że Node.js w wersji 18 lub nowszej jest zainstalowany
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie uruchomić przepływ OAuth

"Uwierzytelnianie nie powiodło się" / przeglądarka ciągle prosi o zalogowanie

Wyczyść buforowane poświadczenia MCP klienta i ponownie autoryzuj. W Claude Code uruchom /mcp → linkly → reconnect. W Claude Desktop zamknij aplikację, usuń buforowany token mcp-remote w ~/.mcp-auth/, a następnie uruchom ponownie.

Narzędzia się nie pojawiają

• Zrestartuj asystenta AI po zapisaniu konfiguracji
• Sprawdź, czy składnia JSON w pliku konfiguracyjnym jest poprawna
• Sprawdź, czy serwer MCP działa (sprawdź ikonę narzędzi u asystenta)

Powiązane zasoby

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