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ą rozmowę.

Co to 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ć pomiędzy aplikacjami, możesz poprosić swojego asystenta AI o wykonanie działań bezpośrednio.

Obsługiwani asystenci AI

Serwer Linkly MCP działa z:

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

Co możesz robić

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

• Tworzenie krótkich linków - "Utwórz krótki link do https://example.com"
• Śledzenie wydajności - "Ile kliknięć otrzymały moje linki w tym tygodniu?"
• Zarządzanie linkami - "Zaktualizuj link o nazwie 'promo' z nowym adresem docelowym"
• Wyświetlanie 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 domeny niestandardowe"
• Konfigurowanie elementów webhook - "Subskrybuj https://my-site.com/webhook, aby odbierać zdarzenia kliknięć"

Pierwsze kroki

Hostowany serwer Linkly MCP znajduje się pod adresem https://mcp.linklyhq.com. Nie ma nic do instalacji i nie ma klucza API do skopiowania — serwer używa OAuth, więc przy pierwszym połączeniu asystenta AI otwiera się okno przeglądarki z prośbą o zalogowanie się do Linkly i zatwierdzenie dostępu. Po tym asystent pozostaje podłączony.

https://mcp.linklyhq.com

Konfiguracja

Claude Desktop

Otwórz plik konfiguracji 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 otworzy się karta przeglądarki, w której możesz się zalogować 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 w Claude Code, wybierz linkly i autoryzuj się w przeglądarce, gdy zostaniesz o to poproszony.

ChatGPT Desktop

Otwórz plik konfiguracji 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 nawiązać połączenia z serwerem MCP"

• Potwierdź, że https://mcp.linklyhq.com jest dostępny z Twojego komputera
• Jeśli Twój klient używa mcp-remote, upewnij się, że zainstalowany jest Node.js v18 lub nowszy
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie wyzwolić 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 → 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 swojego asystenta AI po zapisaniu konfiguracji
• Sprawdź, czy składnia JSON w pliku konfiguracji jest prawidłowa
• Sprawdź, czy serwer MCP działa (sprawdzaj ikonę narzędzi w asystencie)

Powiązane zasoby

• Integracja Claude Desktop
• Integracja ChatGPT
• Dokumentacja API Linkly
• Elementy webhook
• Model Context Protocol