Conectează Elido la orice agent AI.
Elido MCP este un server open-source care expune API-urile noastre de linkuri, QR și analiză sub formă de instrumente MCP. Adaugă-l în Claude Desktop, Cursor sau propriul tău agent în 30 de secunde.
Ce este MCP?
Model Context Protocol este un standard deschis creat de Anthropic, care permite agenților AI să comunice cu instrumente, fișiere și API-uri într-un mod structurat. Un singur protocol, mulți clienți.
Înainte de MCP, conectarea unui agent AI la un serviciu extern însemna să scrii instrucțiuni personalizate de prompt, să întreții manual o schemă de instrumente și să speri că modelul o va apela corect. MCP înlocuiește asta cu un protocol standardizat: serverul își declară instrumentele în JSON Schema, clientul le descoperă automat, iar fiecare apel este tipizat și auditabil. Un singur protocol funcționează în Claude Desktop, Cursor, Claude Code, Continue.dev și orice alt client compatibil cu MCP.
Serverul Elido MCP rulează local, în mediul tău. Păstrează cheia ta API, traduce apelurile structurate de instrumente ale agentului în cereri REST către api.elido.app și returnează rezultate structurate. Agentul nu vede niciodată cheia ta; api.elido.app nu comunică niciodată direct cu modelul.
Flux de execuție
De la mesajul tău din chat până la API-ul Elido și înapoi
Secvența are patru pași. Fiecare este rapid - stratul MCP adaugă sub 5ms de overhead. Apelul REST către api.elido.app durează 30-80ms din UE. Vezi rezultatul în chat înainte să apuci să comuți la un browser.
Cum funcționează
MCP este un protocol de transport ușor. Serverul rulează în mediul tău, păstrează cheia ta API și traduce apelurile structurate de instrumente ale agentului în cereri REST către api.elido.app.
- 1. Agentul cere lista de instrumente
La pornire, clientul MCP (Claude Desktop, Cursor, propriul tău agent) cere serverului Elido catalogul său de instrumente. Serverul returnează o descriere JSON-Schema a fiecărui instrument disponibil - nume, parametri, forme de răspuns.
- 2. Utilizatorul face o cerere în chat
Când spui „scurtează acest URL cu eticheta launch-2026”, agentul potrivește cererea cu catalogul și decide să apeleze create_link cu argumente structurate. Vezi apelul instrumentului înainte de execuție dacă clientul tău îl afișează (Claude Desktop o face).
- 3. Serverul apelează api.elido.app
Serverul local MCP semnează cererea cu ELIDO_API_KEY-ul tău și apelează endpoint-ul REST corespunzător. Latența este dominată de călătoria dus-întors către api.elido.app - de obicei 30-80ms din UE; stratul MCP adaugă sub 5ms.
- 4. Rezultatul ajunge înapoi la agent
Răspunsul este returnat ca un rezultat structurat de instrument, pe care agentul îl poate cita, rezuma sau înlănțui în apelul următor. Erorile includ mesaje utile (indicii privind limita de rată, domeniu lipsă, negăsit), astfel încât agentul să se poată redresa fără să escaladeze către tine.
Instrumente disponibile
Fiecare instrument este tipizat prin JSON-Schema. Agentul vede numele parametrilor, tipurile și descrierile la pornire. Nu este nevoie de inginerie manuală de prompturi.
Exemplu de sesiune
Cum arată după instalare
Aceasta este o sesiune reală Claude Code după adăugarea serverului Elido MCP. Agentul descoperă instrumentele la pornire. De acolo, limbajul natural este suficient.
$ 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 loggedApelul instrumentului este vizibil înainte de execuție în Claude Desktop și Claude Code. Vezi exact ce argumente transmite agentul. Poți anula înainte ca apelul să se declanșeze.
Ce livrează echipele cu asta
Trei tipare pe care le vedem în producție. Alege-l pe cel care se potrivește modului în care echipa ta lucrează deja.
De ce MCP, nu apeluri API directe?
Toate cele trei abordări ajung la aceleași endpoint-uri Elido. Diferențele apar în timpul de configurare, postura de securitate și cât de lizibil este raționamentul agentului.
| Fiecare funcție, una lângă alta | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Timp de configurare | 30 de secunde (configurare + cheie) | Prompt personalizat + definiții de instrumente (ore) | Lipire/extragere manuală (fără automatizare) |
| Catalog de instrumente | Descoperit automat, tipizat prin JSON-Schema | Scris manual, se depărtează de realitate pe măsură ce API-ul evoluează | Niciunul - agentul trebuie să ghicească |
| Gestionarea cheii API | Rămâne în mediul serverului local | Lipită în prompturi (predispusă la scurgeri) | Lipită în dashboard (legată de cookie) |
| Jurnal de audit | Apeluri de instrumente structurate în istoricul chatului | Text liber - greu de căutat ulterior | Istoricul browserului; nu surprinde intenția |
| Reutilizare pe mai mulți clienți | O singură configurare, N clienți compatibili cu MCP | Prompt reformulat pentru fiecare client | Stare per browser, fără portabilitate |
Clienți testați
Ratingurile de stabilitate se bazează pe suita noastră internă de teste, care rulează pentru fiecare client la fiecare lansare. „Stabil” înseamnă că întregul catalog de instrumente trece testele. „Beta” înseamnă că funcționează, dar cazurile limită (rezultate în flux, liste lungi) se pot comporta neașteptat.
Securitate
Doar-citire în mod implicit. Cheia rămâne locală.
Modelul de securitate urmează principiul „cele mai puține domenii necesare”. Instalarea implicită are acces doar-citire. Fiecare modificare este înregistrată. Cheia API nu părăsește niciodată procesul serverului local.
Izolarea cheii
ELIDO_API_KEY trăiește în mediul serverului - niciodată într-un prompt, niciodată trimisă modelului. Modelul apelează instrumentul; serverul semnează cererea. Compromiterea conversației cu modelul nu expune cheia.
Restricționare pe domenii
Doar-citire este implicit. Acordarea accesului de scriere sau ștergere necesită o setare deliberată a spațiului de lucru. Chiar și cu scrierea activată, fiecare modificare apare în jurnalul de audit al spațiului de lucru, împreună cu cheia care a apelat-o.
Open source
Serverul are licență MIT, la github.com/elidoapp/mcp-server. Citește codul sursă înainte de a-l pune în producție. Fork-urile obișnuite adaugă îmbogățire specifică spațiului de lucru sau apeluri interne de instrumente.
Instalare în 30 de secunde
Serverul rulează local și se autentifică folosind cheia API a spațiului tău de lucru. Niciun fel de date nu părăsesc mașina ta, cu excepția apelurilor către api.elido.app pe care le-ai face oricum.
- 1Adaugă serverul în configurația clientului tău
- 2Setează ELIDO_API_KEY (emite una din Setări → Chei API)
- 3Repornește clientul. Instrumentele Elido apar în lista de instrumente a agentului.
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Același fragment funcționează pentru Cursor - adaugă-l în .cursor/mcp.json. Pentru Claude Code, adaugă-l în fișierul .mcp.json al proiectului tău. Emite cheia API din Setări → Chei API. Domeniul doar-citire este suficient pentru majoritatea fluxurilor de lucru.
Întrebări frecvente
Datele mele părăsesc mașina mea?+
Doar apelurile pe care le-ai face oricum către api.elido.app. Serverul MCP folosește stdio (implicit) sau SSE local - nu trimite date acasă, nu face telemetrie, iar codul sursă este pe GitHub dacă vrei să verifici. Aceleași reguli de rezidență în UE ca în dashboard.
Poate agentul să-mi șteargă linkurile din greșeală?+
Nu, la instalarea implicită. Modul doar-citire este implicit; acordarea accesului de scriere/ștergere necesită o setare deliberată a spațiului de lucru. Chiar și cu scrierea activată, fiecare modificare apare în jurnalul de audit împreună cu cheia API care a apelat-o.
Ce clienți sunt susținuți?+
Claude Desktop, Cursor și Claude Code sunt stabile. Continue.dev este în beta. Orice client care vorbește MCP 0.1.0 peste stdio sau SSE funcționează - testăm în raport cu implementarea de referință a clientului.
Care este limita de rată?+
Aceeași ca a cheii API a spațiului tău de lucru - 100 cereri/secundă susținute, 200 în vârf, blocare cu cod 429 și Retry-After. Serverul MCP transmite codul 429 ca eroare de instrument, astfel încât agentul să poată încetini; nu adăugăm un strat suplimentar.
Cum se compară asta cu integrările LLM de la /ai/llm?+
Straturi diferite. /ai/llm este orientat către utilizatorul final (GPT-uri personalizate, boți Slack, butoane deep-link) - preconstruit, gata de folosit dintr-un clic. MCP este protocolul pentru dezvoltatori care stă dedesubt: oricare dintre acele integrări ar putea fi construită peste MCP, iar mulți clienți terți fac exact asta.
Pot rula propriul meu fork?+
Da. Depozitul are licență MIT. Fork-urile obișnuite adaugă instrumente personalizate (de ex. îmbogățire de metadate specifică spațiului de lucru, linkuri interne către Notion/Linear). Dacă lansezi unul, deschide un issue - vrem să integrăm în amonte instrumentele cu adevărat utile pentru toată lumea.
Funcționează în medii izolate (air-gapped)?+
Da, pentru Elido self-hosted. Serverul MCP are nevoie doar de acces la rețea către endpoint-ul tău api-core; acesta poate fi VPC-ul tău privat. Elido în cloud public are nevoie de trafic de ieșire către api.elido.app, ca orice alt client API.
Care este modelul de securitate pentru cheia API?+
Se aplică standardul „cele mai puține domenii necesare”. Emite o cheie limitată la un singur spațiu de lucru, restricționează după IP dacă clientul tău rulează dintr-un IP cunoscut și rotește-o trimestrial. Compromiterea cheii are aceeași rază de impact ca și compromiterea oricărei chei API - limitată la spațiul de lucru, înregistrată în jurnalul de audit, revocabilă.
Continuă lectura
AI în interiorul dashboard-ului - generează sluguri, pune întrebări în limbaj natural.
GPT-uri personalizate, boți Slack, butoane deep-link. Partea preconstruită din /ai.
Zapier, HubSpot, Slack și restul. Acolo unde MCP nu este instrumentul potrivit.
Endpoint-urile REST pe care MCP le încapsulează. Util atunci când ai nevoie de un instrument pe care MCP nu îl expune încă.
Gata în 30 de secunde
Adaugă fragmentul de cod în Claude Desktop sau Cursor, repornește și urmărește cum apar instrumentele în catalogul agentului tău.