Używaj Elido w Claude Desktop i Cursor

Elido udostępnia serwer Model Context Protocol (MCP) pod adresem https://api.elido.app/mcp. Po połączeniu Claude lub Cursor może odczytywać analitykę linków, skracać URL-e i wyszukiwać szczegóły linków — bezpośrednio z czatu lub edytora.

Co daje MCP#

• Zapytaj "Ile kliknięć zebrał spring-2026 w tym tygodniu?" — Claude odpytuje Elido i odpowiada prawdziwą liczbą.
• Powiedz "Skróć https://example.com/very-long-path z tagiem newsletter" — Claude tworzy link i pokazuje skrócony URL.
• W Cursor opisz wydanie i poproś, żeby "utworzyło skrócony link do posta na blogu o wydaniu" — skraca inline.

Dostęp tylko do odczytu jest domyślny. Dostęp do zapisu (tworzenie, aktualizowanie linków) wymaga wyrażenia zgody podczas autoryzacji.

Krok 1 — Wygeneruj token API Elido#

1. Przejdź do Dashboard → Klucze API → Nowy klucz.
2. Wybierz zakresy:
   • links:read analytics:read dla tylko odczytu.
   • Dodaj links:write jeśli chcesz, żeby Claude mógł tworzyć linki.
3. Skopiuj token (zaczyna się od ek_).

Połącz w Claude Desktop#

Claude Desktop przechowuje konfigurację serwera MCP w ~/.claude.json (lub w interfejsie ustawień Claude w nowszych wersjach).

Opcja A — Interfejs ustawień (Claude Desktop 0.10+):

1. Otwórz Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Wklej URL serwera: https://api.elido.app/mcp
3. W sekcji Authentication wybierz Bearer token i wklej swój token API Elido.
4. Kliknij Connect. Claude pobiera manifest narzędzi (~2 sekundy) i pokazuje dostępne narzędzia Elido.

Opcja B — Bezpośrednia edycja pliku konfiguracyjnego:

Otwórz ~/.claude.json w edytorze tekstowym i dodaj wpis pod mcpServers:

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

Zapisz plik. Uruchom ponownie Claude Desktop. Konektor Elido pojawi się na liście konektorów.

Połącz w Cursor#

1. Otwórz Cursor → Settings → MCP (lub Cmd/Ctrl + , → szukaj "MCP").
2. Kliknij Add MCP server.
3. URL serwera: https://api.elido.app/mcp
4. Nagłówek auth: Authorization: Bearer ek_your_token_here
5. Kliknij Save. Cursor pobiera manifest. Dostępne narzędzia pojawiają się w panelu MCP.

Alternatywa — Claude Code CLI (dla użytkowników terminala):

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

Dodaje serwer do Twojego ~/.claude.json z wiersza poleceń. Ustaw ELIDO_TOKEN w profilu powłoki, żeby był dostępny w każdej sesji.

Dostępne narzędzia#

Narzędzie	Wymagany zakres	Co robi
list_links	links:read	Wyświetla linki z opcjonalnymi filtrami (tag, domena, wyszukiwanie)
get_link	links:read	Zwraca pojedynczy link po slugu lub ID
get_analytics	analytics:read	Zwraca liczbę kliknięć + podział dla linku
create_link	links:write	Tworzy nowy skrócony link
update_link	links:write	Aktualizuje cel, slug, tagi lub datę wygaśnięcia

Narzędzia są domyślnie tylko do odczytu. Tworzenie i aktualizowanie linków wymaga zakresu links:write w tokenie API.

Zakres dostępu#

Serwer MCP udostępnia dane tylko z workspace, do którego należy token API. Nie może uzyskiwać dostępu do innych workspace. Jeśli masz wiele workspace, utwórz oddzielny token dla każdego i dodaj wiele wpisów serwera MCP z różnymi nazwami (elido-workspace-a, elido-workspace-b).

Rozwiązywanie problemów#

"Failed to fetch tool manifest" — URL serwera MCP jest błędny lub nieosiągalny. Potwierdź otwierając https://api.elido.app/mcp w przeglądarce — powinien zwrócić manifest JSON. Jeśli otrzymasz błąd certyfikatu, Twoja sieć może blokować TLS do api.elido.app.

"Unauthorized" przy wywoływaniu narzędzia — Token API jest brakujący lub nieprawidłowy w nagłówku Authorization. Sprawdź, czy format nagłówka to dokładnie Authorization: Bearer ek_... (bez dodatkowych spacji, właściwy prefiks).

Narzędzia pojawiają się, ale narzędzia zapisu zwracają "forbidden" — Twój token API nie ma links:write. Wygeneruj nowy token z tym zakresem i zaktualizuj nagłówek w konfiguracji MCP.

Claude Desktop nie pokazuje Elido w konektorach po edycji konfiguracji — Uruchom ponownie Claude Desktop całkowicie (Zakończ, nie tylko zamknij okno). Na macOS sprawdź pasek menu pod kątem działającej instancji Claude.

Panel MCP Cursor pokazuje "disconnected" — Cursor ponownie pobiera manifest przy każdej sesji. Jeśli api.elido.app wolno odpowiada, Cursor może przekroczyć limit czasu. Spróbuj kliknąć Reconnect w panelu MCP. Jeśli problem będzie się utrzymywał, sprawdź stronę statusu Elido.