Podłącz Elido do dowolnego agenta AI.
Elido MCP to otwartoźródłowy serwer, który udostępnia nasze API linków, QR i analityki jako narzędzia MCP. Dodaj go do Claude Desktop, Cursor lub własnego agenta w 30 sekund.
Czym jest MCP?
Model Context Protocol to otwarty standard od Anthropic, który pozwala agentom AI komunikować się z narzędziami, plikami i API w ustrukturyzowany sposób. Jeden protokół, wielu klientów.
Przed MCP, podłączenie agenta AI do zewnętrznej usługi wymagało pisania niestandardowych instrukcji promptów, utrzymywania ręcznie zbudowanego schematu narzędzia i mienia nadziei, że model wywoła go poprawnie. MCP zastępuje to ustandaryzowanym protokołem: serwer deklaruje swoje narzędzia w JSON Schema, klient odkrywa je automatycznie, a każde wywołanie jest typowane i audytowalne. Jeden protokół działa w Claude Desktop, Cursor, Claude Code, Continue.dev i każdym innym kliencie obsługującym MCP.
Serwer MCP Elido działa lokalnie w Twoim środowisku. Przechowuje Twój klucz API, tłumaczy ustrukturyzowane wywołania narzędzi od agenta na żądania REST do api.elido.app i zwraca ustrukturyzowane wyniki. Agent nigdy nie widzi Twojego klucza; api.elido.app nigdy nie komunikuje się bezpośrednio z modelem.
Przepływ w czasie działania
Od Twojej wiadomości na chacie do API Elido i z powrotem
Sekwencja składa się z czterech kroków. Każdy jest szybki - warstwa MCP dodaje mniej niż 5ms narzutu. Wywołanie REST do api.elido.app zajmuje 30–80ms z UE. Widzisz wynik na chacie, zanim zdążysz przełączyć się do przeglądarki.
Jak to działa
MCP to lekki protokół komunikacyjny. Serwer działa w Twoim środowisku, przechowuje Twój klucz API i tłumaczy strukturalne wywołania narzędzi z agenta na żądania REST do api.elido.app.
- 1. Agent pyta o narzędzia
Przy starcie klient MCP (Claude Desktop, Cursor, Twój własny agent) pyta serwer Elido o katalog narzędzi. Serwer zwraca opis każdego dostępnego narzędzia w formacie JSON-Schema - nazwy, parametry, formaty zwracanych danych.
- 2. Użytkownik składa prośbę na czacie
Gdy powiesz 'skróć ten URL z tagiem launch-2026', agent dopasowuje prośbę do katalogu i decyduje się na wywołanie create_link ze strukturalnymi argumentami. Zobaczysz wywołanie narzędzia przed jego wykonaniem, jeśli Twój klient je renderuje.
- 3. Serwer łączy się z api.elido.app
Lokalny serwer MCP podpisuje żądanie Twoim kluczem ELIDO_API_KEY i wywołuje odpowiedni punkt końcowy REST. Opóźnienie jest zdominowane przez komunikację z api.elido.app - zazwyczaj 30-80ms z UE; warstwa MCP dodaje <5ms.
- 4. Wynik trafia z powrotem do agenta
Odpowiedź jest zwracana jako strukturalny wynik narzędzia, który agent może cytować, podsumowywać lub łączyć z następnym wywołaniem. Błędy zawierają konkretne komunikaty (limit zapytań, brak zakresu, nie znaleziono), dzięki czemu agent może naprawić błąd bez angażowania Ciebie.
Dostępne narzędzia
Każde narzędzie jest typowane JSON-Schema. Agent widzi nazwy parametrów, typy i opisy przy starcie. Żadnego ręcznego inżynieria promptów.
Przykładowa sesja
Jak to wygląda po instalacji
To jest prawdziwa sesja Claude Code po dodaniu serwera MCP Elido. Agent odkrywa narzędzia przy starcie. Następnie wystarczy prosty język.
$ claude
> What tools do you have available?
Claude: I have access to the Elido MCP server with these tools:
- create_link: Shorten a URL with optional slug, domain, and tags
- list_links: Search and filter links by tag, folder, or query
- get_link_analytics: Click counts, geo, devices, conversions
- create_qr: Generate a QR code for a short link
- list_workspaces: Enumerate accessible workspaces
> Shorten https://elido.app/pricing with tag launch-2026
Claude: [calling create_link with {url, slug: "pricing-launch", tags: ["launch-2026"]}]
Result: eldo.link/pricing-launch · 0 clicks · audit loggedWywołanie narzędzia jest widoczne przed wykonaniem w Claude Desktop i Claude Code. Widzisz dokładnie jakie argumenty przekazuje agent. Możesz anulować przed wykonaniem wywołania.
Co wdrażają z tym zespoły
Trzy wzorce, które widzimy na produkcji. Wybierz ten, który pasuje do sposobu pracy Twojego zespołu.
Dlaczego MCP, a nie bezpośrednie wywołania API?
Wszystkie trzy podejścia docierają do tych samych punktów końcowych Elido. Różnice pojawiają się w czasie konfiguracji, poziomie bezpieczeństwa i tym, jak czytelne jest wnioskowanie agenta.
| Każda funkcja, obok siebie | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Czas konfiguracji | 30 sekund (konfiguracja + klucz) | Niestandardowy prompt + definicje narzędzi (godziny) | Ręczne wklejanie / scrapowanie (brak automatyzacji) |
| Katalog narzędzi | Automatycznie wykrywany, typowany za pomocą JSON-Schema | Pisany ręcznie, dezaktualizuje się wraz z rozwojem API | Brak - agent musi zgadywać |
| Obsługa kluczy API | Pozostaje w środowisku lokalnego serwera | Wklejany do promptów (ryzyko wycieku) | Wklejany w panelu (powiązany z ciasteczkiem) |
| Ścieżka audytu | Strukturalne wywołania narzędzi w historii czatu | Tekst swobodny - trudny do późniejszego przeszukiwania | Historia przeglądarki; nie rejestruje intencji |
| Wielokrotne użycie w różnych klientach | Jedna konfiguracja, wiele klientów obsługujących MCP | Ponowny prompt dla każdego klienta | Stan przypisany do przeglądarki, brak przenośności |
Przetestowani klienci
Oceny stabilności oparte są na naszym wewnętrznym zestawie testów uruchamianym dla każdego klienta przy każdym wydaniu. 'Stabilny' oznacza, że pełny katalog narzędzi przechodzi. 'Beta' oznacza, że działa, ale przypadki brzegowe (wyniki strumieniowane, długie listy) mogą zachowywać się nieoczekiwanie.
Bezpieczeństwo
Domyślnie tylko do odczytu. Klucz zostaje lokalnie.
Model bezpieczeństwa opiera się na zasadzie minimalnego zakresu uprawnień. Domyślna instalacja ma dostęp tylko do odczytu. Każda mutacja jest logowana. Klucz API nigdy nie opuszcza lokalnego procesu serwera.
Izolacja klucza
ELIDO_API_KEY żyje w środowisku serwera - nigdy w promptcie, nigdy nie wysyłany do modelu. Model wywołuje narzędzie; serwer podpisuje żądanie. Kompromitacja rozmowy z modelem nie ujawnia klucza.
Kontrola zakresu
Domyślny zakres to tylko odczyt. Przyznanie dostępu do zapisu lub usuwania wymaga świadomego ustawienia obszaru roboczego. Nawet przy włączonym zapisie, każda mutacja pojawia się w logu audytu obszaru roboczego z wywołującym kluczem.
Otwarte źródło
Serwer jest na licencji MIT pod adresem github.com/elidoapp/mcp-server. Przeczytaj źródło przed wdrożeniem. Popularne forki dodają wzbogacenie specyficzne dla obszaru roboczego lub wewnętrzne wywołania narzędzi.
Instalacja w 30 sekund
Serwer działa lokalnie i uwierzytelnia się za pomocą klucza API Twojego obszaru roboczego. Żadne dane nie opuszczają Twojej maszyny poza wywołaniami do api.elido.app.
- 1Dodaj serwer do konfiguracji klienta
- 2Ustaw ELIDO_API_KEY (wygeneruj w Settings → API Keys)
- 3Zrestartuj klienta. Narzędzia Elido pojawią się na liście agenta.
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Ten sam fragment działa dla Cursor - wklej go do .cursor/mcp.json. Dla Claude Code dodaj go do .mcp.json swojego projektu. Wystaw klucz API w Ustawienia → Klucze API. Zakres tylko do odczytu wystarczy dla większości przepływów pracy.
Częste pytania
Czy moje dane opuszczają moją maszynę?+
Tylko te wywołania, które i tak wykonałbyś do api.elido.app. Serwer MCP działa przez stdio (domyślnie) lub lokalne SSE - nie wysyła danych do domu, nie zbiera telemetrii, a kod źródłowy jest na GitHubie, jeśli chcesz go zweryfikować. Te same zasady rezydencji danych w UE, co w panelu.
Czy agent może przypadkowo usunąć moje linki?+
Nie przy domyślnej instalacji. Tryb tylko do odczytu jest domyślny; przyznanie uprawnień do zapisu/usuwania wymaga celowej zmiany ustawień obszaru roboczego. Nawet przy włączonym zapisie każda zmiana pojawia się w logu audytu z informacją o kluczu API, który ją wywołał.
Którzy klienci są obsługiwani?+
Claude Desktop, Cursor i Claude Code są stabilne. Continue.dev jest w wersji beta. Każdy klient obsługujący MCP 0.1.0 przez stdio lub SSE zadziała - testujemy rozwiązanie względem referencyjnej implementacji klienta.
Jaki jest limit zapytań (rate limit)?+
Taki sam jak dla klucza API Twojego obszaru roboczego - 100 żądań/sek w sposób ciągły, 200 w impulsie, blokuje błędem 429 z nagłówkiem Retry-After. Serwer MCP przekazuje błąd 429 jako błąd narzędzia, aby agent mógł ponowić próbę później; nie dodajemy dodatkowej warstwy.
Jak to się ma do integracji LLM na /ai/llm?+
Różne warstwy. /ai/llm jest skierowane do konsumenta (niestandardowe GPT, boty Slack, przyciski głębokich linków) - gotowe rozwiązania typu kliknij-i-używaj. MCP to protokół deweloperski leżący u podstaw: każda z tych integracji mogłaby zostać zbudowana na bazie MCP i wielu zewnętrznych klientów właśnie tak robi.
Czy mogę uruchomić własny fork?+
Tak. Repozytorium posiada licencję MIT. Popularne forki dodają niestandardowe narzędzia (np. wzbogacanie metadanych specyficznych dla obszaru roboczego, wewnętrzne linki do Notion/Linear). Jeśli stworzysz własny, otwórz zgłoszenie - chcemy wdrażać szeroko użyteczne narzędzia w głównym nurcie projektu.
Czy działa w środowiskach izolowanych (air-gapped)?+
Tak w przypadku self-hosted Elido. Serwer MCP potrzebuje jedynie dostępu sieciowego do punktu końcowego api-core; może to być Twoja prywatna sieć VPC. Elido w chmurze publicznej potrzebuje wyjścia do api.elido.app, jak każdy inny klient API.
Jaki jest model bezpieczeństwa dla klucza API?+
Obowiązuje standardowa zasada 'najmniejszych niezbędnych uprawnień'. Wygeneruj klucz ograniczony do jednego obszaru roboczego, ogranicz dostęp po IP, jeśli Twój klient działa ze znanego adresu, i rotuj klucze co kwartał. Przejęcie klucza wiąże się z takim samym ryzykiem, jak przejęcie dowolnego klucza API - ograniczone do obszaru roboczego, rejestrowane w logach audytowych i możliwe do unieważnienia.
Czytaj dalej
AI wewnątrz panelu - generuj slugi, zadawaj pytania w języku naturalnym.
Niestandardowe GPT, boty Slack, przyciski głębokich linków. Gotowa strona /ai.
Zapier, HubSpot, Slack i reszta. Tam, gdzie MCP nie jest odpowiednim narzędziem.
Punkty końcowe REST, które opakowuje MCP. Przydatne, gdy potrzebujesz narzędzia, którego MCP jeszcze nie udostępnia.
Gotowe w 30 sekund
Wklej fragment kodu do Claude Desktop lub Cursor, zrestartuj i obserwuj, jak narzędzia pojawiają się w katalogu Twojego agenta.