Serwer MCP Linkly

Serwer MCP Linkly pozwala 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 łą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 działań.

Obsługiwani asystenci AI

Serwer MCP Linkly współpracuje z:

Co możesz zrobić

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

  • Tworzenie krótkich linków - "Utwórz krótki link dla https://example.com"
  • Śledzenie wyników - "Ile kliknięć miały moje linki w tym tygodniu?"
  • Zarządzanie linkami - "Zaktualizuj link o nazwie 'promo' z nowym adresem docelowym"
  • Przeglądanie 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 niestandardowe domeny"
  • Konfigurowanie webhooków - "Zasubskrybuj https://my-site.com/webhook, aby otrzymywać zdarzenia kliknięć"

Opcje instalacji

Serwer MCP Linkly jest dostępny na dwa sposoby:

Opcja 1: Serwer hostowany (Zalecane)

Użyj naszego hostowanego serwera MCP - nie wymaga instalacji:

https://mcp.linklyhq.com

Opcja 2: Pakiet npm

Zainstaluj i uruchom lokalnie za pomocą npx:

npx -y linkly-mcp-server

Lub zainstaluj globalnie:

npm install -g linkly-mcp-server

Zobacz pakiet na npm.

Konfiguracja

Uzyskiwanie poświadczeń API

  1. 1Zaloguj się do panelu Linkly
  2. 2Przejdź do Ustawienia → Klucze API
  3. 3Skopiuj swój Klucz API i ID Workspace

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 MCP Linkly:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "twój-klucz-api",
        "LINKLY_WORKSPACE_ID": "twój-id-workspace"
      }
    }
  }
}

Konfiguracja ChatGPT Desktop

Otwórz plik konfiguracyjny ChatGPT:

  • macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
  • Windows: %APPDATA%\ChatGPT\mcp_servers.json

Dodaj serwer MCP Linkly:

Używając npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "twój-klucz-api"
      }
    }
  }
}

Używając serwera hostowanego:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "twój-klucz-api"
      }
    }
  }
}

Dostępne narzędzia

NarzędzieOpis
create_linkUtwórz nowy krótki link z opcjonalnymi parametrami UTM, pikselami i więcej
update_linkZaktualizuj ustawienia istniejącego linku
delete_linkUsuń link
get_linkPobierz szczegóły konkretnego linku
list_linksWyświetl wszystkie linki w Twoim workspace
search_linksWyszukaj linki według nazwy, URL lub notatki
get_clicksPobierz ostatnie dane o kliknięciach
get_analyticsPobierz dane o kliknięciach w szeregu czasowym do wykresów
get_analytics_byPobierz kliknięcia pogrupowane według kraju, przeglądarki, platformy itp.
list_domainsWyświetl swoje niestandardowe domeny
list_webhooksWyświetl subskrypcje webhooków workspace
subscribe_webhookZasubskrybuj URL, aby otrzymywać zdarzenia kliknięć

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

Zmienne środowiskowe

ZmiennaWymaganaOpis
LINKLY_API_KEYTakTwój klucz API Linkly
LINKLY_WORKSPACE_IDNieID Twojego workspace (niektórzy klienci tego wymagają)

Rozwiązywanie problemów

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

  • Sprawdź, czy Twój klucz API i ID Workspace są poprawne
  • Upewnij się, że masz zainstalowany Node.js (wersja 18 lub nowsza)
  • Spróbuj uruchomić npx linkly-mcp-server w terminalu, aby zobaczyć ewentualne błędy

"Uwierzytelnianie nie powiodło się"

  • Zweryfikuj swój klucz API w panelu Linkly w Ustawienia → Klucze API
  • Upewnij się, że w Twoich poświadczeniach nie ma dodatkowych spacji
  • Spróbuj wygenerować ponownie swój klucz API

Narzędzia się nie pojawiają

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

Serwer nie jest dostępny

  • Potwierdź, że ścieżka polecenia jest poprawna
  • Jeśli używasz serwera hostowanego, sprawdź swoje połączenie internetowe
  • Zweryfikuj, czy serwer MCP uruchamia się ręcznie z terminala

Powiązane zasoby

FAQ dotyczące serwera MCP

Czy muszę coś instalować, aby używać serwera MCP?

Nie, jeśli używasz serwera hostowanego pod adresem https://mcp.linklyhq.com. Jeśli wolisz uruchomić go lokalnie, będziesz potrzebować zainstalowanego Node.js w wersji 18 lub nowszej.

Którzy asystenci AI obsługują MCP?

Claude Desktop i ChatGPT Desktop obsługują MCP. Inne narzędzia, takie jak Cursor i Windsurf, również mają wsparcie dla MCP.

Czy mój klucz API jest bezpieczny?

Tak. Twój klucz API jest przechowywany lokalnie w pliku konfiguracyjnym Twojego asystenta AI i jest wysyłany tylko do serwerów Linkly podczas wykonywania żądań API. Nigdy nie jest udostępniany samemu modelowi AI.

Czy mogę używać MCP z internetowymi wersjami Claude lub ChatGPT?

Nie, MCP wymaga aplikacji desktopowych. Wersje internetowe nie obsługują połączeń MCP.

Jak zaktualizować serwer MCP?

Jeśli używasz npx, automatycznie pobiera najnowszą wersję za każdym razem. Jeśli zainstalowałeś globalnie, uruchom npm update -g linkly-mcp-server.

Śledź 500 miesięcznych kliknięć ze wszystkimi funkcjami.

Nie potrzebujesz karty kredytowej