Używaj Elido w Claude Desktop i Cursor

Elido udostępnia serwer Model Context Protocol (MCP) jako program lokalny. Działa na Twoim komputerze, wywołuje REST API Elido z Twoim kluczem API i komunikuje się z klientem przez stdio. Nie ma hostowanego adresu MCP ani konektora OAuth: adresu serwera nie da się wkleić na ekranie Connectors w Claude.

Krok 1: zbuduj serwer

W kopii repozytorium Elido uruchom poniższe polecenia. Powstanie packages/mcp-server/dist/index.js; zapisz ścieżkę bezwzględną.

pnpm install
pnpm --filter @elido/mcp-server build

Krok 2: utwórz klucz API

1. Otwórz Dashboard → API Keys → New key.
2. Wybierz uprawnienia (links:read i analytics:read do odczytu, plus links:write do tworzenia linków).
3. Skopiuj klucz. Jest wysyłany do API jako Authorization: Bearer ….

Claude Desktop

{
  "mcpServers": {
    "elido": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "ELIDO_API_KEY": "your_api_key",
        "ELIDO_WORKSPACE_ID": "42"
      }
    }
  }
}

Edytuj ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) lub %APPDATA%\Claude\claude_desktop_config.json (Windows) i całkowicie zrestartuj Claude Desktop.

Cursor

Dodaj ten sam blok mcpServers do .cursor/mcp.json w projekcie (lub ~/.cursor/mcp.json dla wszystkich) i zrestartuj Cursora.

Claude Code

claude mcp add elido --env ELIDO_API_KEY=your_api_key -- \
  node /absolute/path/to/packages/mcp-server/dist/index.js

Uruchom claude mcp list, aby sprawdzić, czy serwer jest połączony.

Dostępne narzędzia

Narzędzie	Co robi
create_link	Skraca URL z opcjonalnym slugiem, domeną, tytułem i tagami
list_links	Wyświetla ostatnie linki przestrzeni roboczej
query_analytics	Szereg czasowy kliknięć dla przestrzeni lub linku, ze strefą czasową
generate_qr	Kod QR (SVG lub PNG) dla istniejącego linku
list_workspaces	Wyświetla przestrzenie dostępne dla klucza API

Zmienne środowiskowe: ELIDO_API_KEY (wymagana), ELIDO_WORKSPACE_ID (opcjonalna, gdy klucz widzi kilka przestrzeni), ELIDO_API_BASE (domyślnie https://api.elido.app, zmień przy self-hostingu).

Rozwiązywanie problemów

Klient pokazuje serwer jako niedziałający. Sprawdź, czy ścieżka w args jest bezwzględna i czy istnieje dist/index.js (powtórz build). Uruchom ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js w terminalu, aby zobaczyć błędy startu.

„Unauthorized”. Klucz jest brakujący, błędny lub unieważniony. Utwórz nowy w Dashboard → API Keys.

Tworzenie linku zwraca „forbidden”. Kluczowi brakuje links:write.