Serwer Linkly MCP

Serwer Linkly MCP umożliwia 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ą konwersację.

Co to 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ć asystenta AI, aby bezpośrednio wykonał działania.

Wspierani asystenci AI

Serwer Linkly MCP współpracuje z:

• Claude Desktop
• ChatGPT Desktop
• Innymi klientami kompatybilnymi 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 shell — na przykład Claude Code lub Cursor — Linkly CLI jest często lepszym wyborem niż serwer MCP. Agenci kodujący są już przyzwyczajeni do kierowania narzędziami wiersza poleceń, a CLI daje im wyjście --json dla każdego polecenia oraz komendę linkly schema, która drukuje całe drzewo poleceń, więc agent może odkryć wszystko, co może zrobić. Serwer MCP pozostaje lepszym wyborem dla asystentów, którzy nie mogą uruchamiać poleceń shell, takich jak Claude Desktop i ChatGPT Desktop.

Co możesz robić

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

• Tworzył krótkie linki - „Utwórz krótki link do https://example.com"
• Śledzył wydajność - „Ile kliknięć uzyskały moje linki w tym tygodniu?"
• Zarządzał linkami - „Zaktualizuj link o nazwie 'promo' z nowym celem"
• 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 - „Wylistuj moje niestandardowe domeny"
• Konfigurował webhooki - „Zasubskrybuj https://my-site.com/webhook, aby otrzymywać zdarzenia kliknięcia"

Pierwsze kroki

Hostowany Serwer Linkly MCP znajduje się pod adresem https://mcp.linklyhq.com. Nie ma nic do zainstalowania i nie ma żadnego klucza API do skopiowania — serwer używa OAuth, więc przy pierwszym połączeniu Twojego asystenta AI otwiera się okno przeglądarki, w którym proszona jest 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"]
    }
  }
}

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

Claude Code (CLI)

Claude Code natywnie wspiera zdalne serwery MCP. Dodaj Linkly jednym poleceniem:

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 zostaniesz o to poproszony.

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 adres https://mcp.linklyhq.com jest osiągalny z Twojej maszyny
• Jeśli Twój klient używa mcp-remote, upewnij się, że zainstalowany jest Node.js w wersji 18 lub nowszej
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie wyzwolić przepływ OAuth

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

Wyczyść buforowane poświadczenia MCP 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
• Zweryfikuj, czy serwer MCP działa (sprawdź ikonę narzędzi u asystenta)

Powiązane zasoby

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