Serwer MCP Elido dla Claude Desktop, Cursor i Claude Code

Serwer MCP Elido to mały proces Node, który pozwala Claude Desktop, Cursor lub Claude Code tworzyć krótkie linki, listować je i czytać szeregi czasowe kliknięć z poziomu czatu. Mieszka w monorepo w packages/mcp-server, mówi MCP przez stdio i rozmawia z tym samym REST API co wszystko inne.

Jedna poprawka na początek, bo wcześniejsza wersja tego przewodnika się myliła: pakietu nie ma na npm i nie jest jeszcze publiczny. Na dzień 2026-11-11 npm view @elido/mcp-server zwraca 404; publiczne wydanie wkrótce. Do tego czasu uruchamiasz go z lokalnego buildu. Wszystko poniżej sprawdzono z kodem w packages/mcp-server i services/api-core.

Czym jest MCP

Model Context Protocol to otwarty standard pozwalający klientowi AI wywoływać narzędzia żyjące poza modelem. Klient uruchamia serwer lub łączy się z nim, prosi o listę narzędzi i wysyła wywołania narzędzi jako wiadomości JSON-RPC. Serwer wykonuje pracę i zwraca tekst, który czyta model. Model nigdy nie trzyma Twojego klucza API; trzyma go serwer.

Specyfikacja definiuje dwa transporty, stdio dla procesów lokalnych i Streamable HTTP dla zdalnych (specyfikacja MCP, najnowsza rewizja 2026-07-28, dostęp 2026-10-25). Serwer Elido implementuje tylko stdio.

Co robi serwer

Jest napisany ręcznie, bez oficjalnego @modelcontextprotocol/sdk, aby pozostać bez zależności. W src/index.ts odpowiada na cztery rzeczy: initialize (raportując wersję protokołu 2024-11-05), tools/list, tools/call i powiadomienie notifications/initialized. Wszystko inne dostaje błąd "method not found". Nie ma zasobów, promptów ani handlerów ping.

Każde wywołanie narzędzia staje się uwierzytelnionym żądaniem REST do ELIDO_API_BASE (domyślnie https://api.elido.app) z Authorization: Bearer <key> i nagłówkiem User-Agent: elido-mcp-server/0.1.0. Nieudane wywołania wracają jako błąd zawierający status HTTP i pierwsze 400 znaków odpowiedzi.

O generate_qr: api-core udostępnia publiczne POST /v1/qr/generate i projekt per link pod GET /v1/workspaces/{id}/links/{link_id}/qr, ale nic pod ścieżką, którą wywołuje narzędzie. Dopóki to nie zostanie uzgodnione, nie budowałbym na tym przepływu pracy. Jest w backlogu.

Zbuduj go i zdobądź klucz API

Monorepo jest prywatne, więc poniższe kroki dotyczą sytuacji, gdy masz kod źródłowy pakietu (publiczne wydanie wkrótce). Zbuduj pakiet:

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

To tworzy packages/mcp-server/dist/index.js. Potrzebujesz Node 20 lub nowszego (engines w jego package.json).

Dla klucza otwórz Dashboard, potem API keys (/dashboard/api-keys), nazwij klucz od agenta i wybierz rolę. Formularz oferuje viewer, editor i admin, a editor jest domyślny. Klucze Elido niosą rolę w przestrzeni roboczej, a nie zakresy per narzędzie. Klucz viewer to opcja tylko do odczytu: może listować i czytać analitykę, a API odrzuca create_link. Ustaw datę wygaśnięcia, jeśli klucz jest na próbę. Skopiuj klucz, gdy jest pokazany, i trzymaj go poza kontrolą wersji.

Konfiguracja Claude Desktop

Claude Desktop czyta claude_desktop_config.json. Lokalizację konfiguracji i kartę ustawień Developer opisano w dokumentacji MCP (łączenie serwerów lokalnych, dostęp 2026-10-25). W macOS plik to ~/Library/Application Support/Claude/claude_desktop_config.json, a w Windows %APPDATA%\Claude\claude_desktop_config.json.

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

Użyj ścieżki bezwzględnej. ELIDO_WORKSPACE_ID jest opcjonalne tylko wtedy, gdy klucz widzi dokładnie jedną przestrzeń roboczą; serwer wywołuje wtedy raz GET /v1/workspaces i buforuje id. Przy dwóch lub więcej przestrzeniach rzuca błąd z poleceniem ustawienia zmiennej, więc ustaw ją od początku.

Po zapisaniu zrestartuj Claude Desktop. Jeśli serwer się nie pojawia, najpierw uruchom to samo polecenie w terminalu. Brak klucza nie zatrzymuje procesu, wypisuje ostrzeżenie na stderr, a każde wywołanie narzędzia potem zawodzi.

Konfiguracja Cursor i Claude Code

Cursor czyta ten sam kształt mcpServers z .cursor/mcp.json w projekcie lub z ~/.cursor/mcp.json dla wszystkich projektów (dokumentacja MCP Cursor, dostęp 2026-10-25). Wklej powyższy blok, dodaj plik do .gitignore, bo zawiera aktywny klucz, i sprawdź serwer w ustawieniach MCP Cursora.

Claude Code dodaje serwer stdio z wiersza poleceń (dokumentacja MCP Claude Code, dostęp 2026-10-25):

claude mcp add --env ELIDO_API_KEY=elido_your_key_here --env ELIDO_WORKSPACE_ID=42 \
  --transport stdio elido -- node /absolute/path/to/packages/mcp-server/dist/index.js

Klucze w pliku konfiguracyjnym są jawnym tekstem. Na współdzielonej maszynie daj każdej osobie własny klucz, aby ślad audytu coś znaczył.

Dwie sesje z prawdziwymi kształtami żądań

To ilustracyjne rozmowy, a nie nagrania, a liczby są zmyślone. Argumenty narzędzi i pola wyniku zgadzają się z kodem.

Skróć link kampanii. Prosisz Claude o skrócenie https://shop.example.com/spring ze slugiem spring i tagiem spring. Wywołuje create_link z destination_url, slug, title i tags. Ponieważ nie przekazano domain_id, serwer najpierw pobiera GET /v1/workspaces/{id}/domains i używa pierwszej zwróconej. Jeśli Twoja przestrzeń ma kilka domen, przekaż domain_id sam. API odpowiada rekordem linku z short_url, a Claude wstawia go do szkicu. Jeśli slug jest zajęty, API zwraca 409 "slug already exists for this domain", a Claude może wybrać inny.

Odczytaj kliknięcia z ostatniego tygodnia. Prosisz o dzienne kliknięcia jednego linku w czasie berlińskim. Claude wywołuje query_analytics z link_id, from, to, interval: "day" i tz: "Europe/Berlin". Daty mają format YYYY-MM-DD, a API odrzuca zakres, w którym from nie jest przed to, więc jako to podaj dzień po swoim ostatnim dniu. Jeśli je pominiesz, zakres to ostatnie 30 dni. Wynik to {"items": [{"ts": "...", "count": 312}, ...]}. Nie ma pola total, więc poproś Claude o zsumowanie liczb. Tylko kliknięcia: przez to narzędzie nie przychodzi podział na kraje, urządzenia ani referrery.

Bezpieczeństwo i limity

Role, nie zakresy. Wybierz najniższą rolę, która wykonuje zadanie. Viewer dla agentów raportujących, editor dla tych, które tworzą linki, admin tylko ze szczególnego powodu.

Co opuszcza Twoją maszynę. Serwer wysyła żądania do Twojej bazy API Elido i nigdzie indziej. To, co Twój klient AI wysyła do własnego dostawcy, reguluje polityka tego dostawcy.

Ślad audytu. Utworzenie klucza emituje zdarzenie audytu api_key.created, a utworzenie linku link.created. Nie zweryfikowałem, jak zdarzenie jest przypisywane do konkretnego klucza, więc nie polegaj na dzienniku audytu przy odróżnianiu dwóch agentów. Daj każdemu własny klucz i obserwuj listę kluczy.

Limity zapytań. Wywołania liczą się do limitu przestrzeni roboczej: 10 żądań na sekundę w Free, 30 w Pro i 100 w Business, z zapasem serii 20, 60 i 200 (services/api-core/internal/httpserver/server.go). Agent tworzący setki linków powinien użyć POST /v1/workspaces/{id}/links/bulk przez API, jak w imporcie zbiorczym z Arkusza Google.

Zdalny MCP. To byłby hostowany endpoint z OAuth, dzięki któremu łącznik Claude mógłby dotrzeć do Elido bez lokalnego procesu. Jest planowany, nie zbudowany, a katalog integracji w panelu wymienia tylko serwer lokalny. Na razie używaj jego.

Dryf protokołu. Serwer deklaruje 2024-11-05, podczas gdy aktualna rewizja specyfikacji to 2026-07-28. Nie testowaliśmy go z każdym wydaniem klienta, więc po aktualizacji sprawdź status serwera w swoim kliencie.

Co dalej

Powyższe luki są w backlogu: opublikować pakiet, naprawić generate_qr, dodać Streamable HTTP i zdalny endpoint, dodać więcej narzędzi (aktualizacja, usuwanie, podziały geograficzne) i atrybucję audytu per klucz. Inną drogę do tego samego pomysłu agenta opisuje przewodnik po Gemini i przewodnik po ChatGPT; o higienie kluczy mówi uprawnienia kluczy API dla narzędzi linków.

Powiązane na blogu

• Uprawnienia kluczy API dla narzędzi linków - role, najmniejsze uprawnienia i rotacja.

• Import zbiorczy krótkich linków z Arkusza Google - właściwa droga dla setek linków.

• Skracacz URL w Gemini - gdzie wywołania narzędzi działają w Gemini.

• Skracacz URL w ChatGPT - co działa, a co tylko udaje.

• Krótkie linki jako Terraform - zarządzanie linkami w stylu infrastruktury.

• Limity zapytań i idempotentność API skracacza URL - jak limity zachowują się dla klientów.

• Marius