Serwer Linkly MCP

Serwer Linkly MCP umożliwia podłączenie asystentów AI do Twojego konta Linkly za pomocą Model Context Protocol. Po podłączeniu możesz tworzyć i zarządzać skrótami linków poprzez naturalną rozmowę.

Co to jest MCP?

Model Context Protocol (MCP) to otwarty standard, który umożliwia asystentom AI bezpieczne łą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 bezpośrednie wykonanie akcji.

Obsługiwani asystenci AI

Serwer Linkly MCP działa z:

• Claude Desktop
• ChatGPT Desktop
• Innymi klientami kompatybilnymi z MCP (Cursor, Windsurf, itp.)

Serwer MCP czy Linkly CLI?

Jeśli Twój asystent AI jest agentem kodującym, który może uruchamiać polecenia shell — takim jak Claude Code lub Cursor — Linkly CLI jest często lepszym wyborem niż serwer MCP. Agenty kodujące są już przyzwyczajone do obsługi narzędzi wiersza poleceń, a CLI daje im --json output na każde polecenie oraz linkly schema command, które wypisuje całe drzewo poleceń, więc agent może odkryć wszystko, co może robić. 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 podłączeniu możesz poprosić swojego asystenta AI o:

• Tworzenie skrótów linków - "Utwórz skrót linku dla https://example.com"
• Śledzenie wydajności - "Ile kliknięć otrzymały moje linki w tym tygodniu?"
• Zarządzanie linkami - "Zaktualizuj link o nazwie 'promo' nowym celem"
• Przeglądanie analityki - "Pokaż mi kliknięcia według kraju za ostatnie 30 dni"
• Wyszukiwanie linków - "Znajdź wszystkie linki związane z premierą produktu"
• Zarządzanie domenami - "Wyświetl listę moich domen niestandardowych"
• Konfigurowanie webhooków - "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. Nic nie trzeba instalować i żaden klucz API do skopiowania — serwer używa OAuth, więc za pierwszym razem, gdy asystent AI się połączy, otwiera się okno przeglądarki z prośbą o zalogowanie się do Linkly i zatwierdzenie dostępu. Potem 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, w której musisz się zalogować i zatwierdzić dostęp. Claude Desktop pozostaje wtedy połączony — nie potrzeba pliku konfiguracyjnego ani dodatkowych narzędzi.

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 będzie to wymagane.

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

"Could not connect to MCP server"

• Potwierdź, że https://mcp.linklyhq.com jest dostępny z Twojej maszyny
• W Claude Code uruchom /mcp i wybierz linkly, aby ponownie uruchomić przepływ OAuth

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

To oznacza, że Twój klient przechowuje przestarzałą rejestrację połączenia. Wyczyść buforowane poświadczenia i ponownie autoryzuj się. W Claude Code uruchom /mcp → linkly → reconnect. W Claude Desktop usuń konektor Linkly w Settings → Connectors i dodaj go ponownie, następnie zaloguj się ponownie.

Narzędzia się nie pojawiają

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

Powiązane zasoby

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