Serwer Linkly MCP

Serwer Linkly MCP pozwala na połączenie 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ą rozmowę.

Czym jest MCP?

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

Obsługiwani asystenci AI

Serwer Linkly MCP pracuje z:

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

Serwer MCP czy interfejs wiersza poleceń Linkly?

Jeśli Twój asystent AI to agent kodujący, który może uruchamiać polecenia powłoki — taki jak Claude Code lub Cursor — interfejs wiersza poleceń Linkly jest często lepszym wyborem niż serwer MCP. Agenty kodujące są już przyzwyczajone do obsługi narzędzi wiersza poleceń, a interfejs wiersza poleceń daje im dane wyjściowe --json dla każdego polecenia plus polecenie linkly schema, które wypisuje pełne drzewo poleceń, dzięki czemu agent może odkryć wszystko, co potrafi robić. 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"
• Śledzył wydajność - „Ile kliknięć otrzymały moje linki w tym tygodniu?"
• Zarządzał linkami - „Zaktualizuj link zwany 'promo' nowym adresem docelowym"
• Wyświetlał analizy - „Pokaż mi kliknięcia według kraju z ostatnich 30 dni"
• Przeszukiwał linki - „Znajdź wszystkie linki związane z uruchomieniem produktu"
• Zarządzał domenami - „Wylistuj moje domeny niestandardowe"
• Konfigurował webhooks - „Subskrybuj https://my-site.com/webhook, aby otrzymywać zdarzenia kliknięć"

Pierwsze kroki

Hostowany serwer Linkly MCP znajduje się pod adresem https://mcp.linklyhq.com. Nie ma niczego do zainstalowania i żadnego klucza API do skopiowania — serwer używa OAuth, więc przy pierwszym połączeniu asystenta AI okno przeglądarki otwiera się, prosząc Cię o zalogowanie się do Linkly i zatwierdzenie dostępu. Po tym 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"]
    }
  }
}

Uruchom ponownie Claude Desktop. Przy pierwszym użyciu narzędzia Linkly otwiera się karta przeglądarki, aby zalogować się i zatwierdzić dostęp.

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 wewnątrz Claude Code, wybierz linkly i autoryzuj w przeglądarce po wyświetleniu monitu.

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 linku

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 v18 lub nowszy jest zainstalowany
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie uruchomić przepływ OAuth

"Uwierzytelnienie nie powiodło się" / przeglądarka wciąż prosi o zalogowanie

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

Narzędzia się nie pojawiają

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

Powiązane zasoby

• Integracja Claude Desktop
• Integracja ChatGPT
• Dokumentacja API Linkly
• Interfejs wiersza poleceń Linkly
• Webhooks
• Model Context Protocol