Collega Elido a qualsiasi agente AI.
Elido MCP è un server open-source che espone le nostre API per link, QR e analytics come strumenti MCP. Aggiungilo a Claude Desktop, Cursor o al tuo agente in 30 secondi.
Cos'è MCP?
Model Context Protocol è uno standard aperto di Anthropic che permette agli agenti AI di comunicare con strumenti, file e API in modo strutturato. Un unico protocollo, molti client.
Before MCP, wiring an AI agent to an external service meant writing custom prompt instructions, maintaining a hand-crafted tool schema, and hoping the model would call it correctly. MCP replaces that with a standardized protocol: the server declares its tools in JSON Schema, the client discovers them automatically, and every call is typed and auditable. One protocol works across Claude Desktop, Cursor, Claude Code, Continue.dev, and any other MCP-aware client.
The Elido MCP server runs locally in your environment. It holds your API key, translates structured tool calls from the agent into REST requests to api.elido.app, and returns structured results. The agent never sees your key; api.elido.app never speaks directly with the model.
Runtime flow
From your chat message to the Elido API and back
The sequence is four steps. Each is fast — the MCP layer adds under 5ms of overhead. The REST call to api.elido.app takes 30-80ms from EU. You see the result in chat before you can alt-tab to a browser.
Come funziona
MCP è un protocollo di comunicazione leggero. Il server gira nel tuo ambiente, conserva la tua chiave API e traduce le chiamate strutturate dell'agente in richieste REST verso api.elido.app.
- 1. L'agente richiede gli strumenti
All'avvio il client MCP (Claude Desktop, Cursor, il tuo agente) chiede al server Elido il suo catalogo di strumenti. Il server restituisce una descrizione JSON-Schema di ogni strumento disponibile — nomi, parametri, formati di ritorno.
- 2. L'utente fa una richiesta in chat
Quando dici 'accorcia questo URL con il tag lancio-2026', l'agente lo confronta con il catalogo e decide di chiamare create_link con argomenti strutturati. Vedi la chiamata allo strumento prima che venga eseguita se il tuo client la renderizza (Claude Desktop lo fa).
- 3. Il server interroga api.elido.app
Il server MCP locale firma la richiesta con la tua ELIDO_API_KEY e chiama l'endpoint REST corrispondente. La latenza è dominata dal viaggio di andata e ritorno verso api.elido.app — tipicamente 30-80ms dall'UE; il livello MCP aggiunge <5ms.
- 4. Il risultato torna all'agente
La risposta viene restituita come un risultato strutturato dello strumento che l'agente può citare, riassumere o concatenare nella chiamata successiva. Gli errori includono messaggi pronti all'azione (suggerimento limite di frequenza, ambito mancante, non trovato) in modo che l'agente possa riprendersi senza coinvolgerti.
Strumenti disponibili
Every tool is JSON-Schema typed. The agent sees parameter names, types, and descriptions on startup. No manual prompt engineering required.
Example session
What it looks like after install
This is a real Claude Code session after adding the Elido MCP server. The agent discovers tools on startup. From there, plain language is enough.
$ 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 loggedThe tool call is visible before it executes in Claude Desktop and Claude Code. You see exactly what arguments the agent passes. You can cancel before the call fires.
Cosa realizzano i team con questo
Tre pattern che vediamo in produzione. Scegli quello che meglio si adatta al modo di lavorare del tuo team.
Perché MCP e non chiamate API dirette?
Tutti e tre gli approcci raggiungono gli stessi endpoint Elido. Le differenze emergono nei tempi di configurazione, nella postura di sicurezza e nella leggibilità del ragionamento dell'agente.
| Tutte le funzionalità, fianco a fianco | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Tempo di configurazione | 30 secondi (configurazione + chiave) | Prompt personalizzato + definizioni strumenti (ore) | Incolla/estrai manualmente (nessuna automazione) |
| Catalogo strumenti | Scoperta automatica, tipizzata con JSON-Schema | Scritto a mano, va fuori sincronia con l'evoluzione dell'API | Nessuno — l'agente deve indovinare |
| Gestione chiave API | Rimane nell'ambiente del server locale | Incollata nei prompt (rischio di fuga) | Incollata nella dashboard (legata ai cookie) |
| Traccia di audit | Chiamate strutturate agli strumenti nella cronologia chat | Testo libero — difficile da filtrare in seguito | Cronologia del browser; non cattura l'intento |
| Riutilizzo su più client | Una configurazione, N client compatibili con MCP | Nuovo prompt per ogni client | Stato specifico del browser, nessuna portabilità |
Client testati
Stability ratings are based on our internal test suite that runs against each client on every release. “Stable” means the full tool catalogue passes. “Beta” means it works but edge cases (streaming results, long lists) may behave unexpectedly.
Security
Read-only by default. Key stays local.
The security model follows the principle of fewest-scopes-needed. The default install has read-only access. Every mutation is logged. The API key never leaves the local server process.
Key isolation
ELIDO_API_KEY lives in the server's env — never in a prompt, never sent to the model. The model calls the tool; the server signs the request. Compromise of the model conversation doesn't expose the key.
Scope gating
Read-only is default. Granting write or delete access requires a deliberate workspace setting. Even with writes enabled, every mutation shows up in the workspace audit log with the calling key.
Open source
The server is MIT-licensed at github.com/elidoapp/mcp-server. Read the source before you deploy. Common forks add workspace-specific enrichment or internal tool calls.
Installa in 30 secondi
Il server gira localmente e si autentica con la chiave API del tuo workspace. Nessun dato lascia la tua macchina tranne le chiamate a api.elido.app che faresti comunque.
- 1Aggiungi il server alla configurazione del tuo client
- 2Imposta ELIDO_API_KEY (creane una in Settings → API Keys)
- 3Riavvia il client. Gli strumenti Elido appariranno nella lista degli strumenti dell'agente.
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Same snippet works for Cursor — drop it into .cursor/mcp.json. For Claude Code, add it to your project’s .mcp.json. Issue the API key in Settings → API Keys. Read-only scope is sufficient for most workflows.
Domande comuni
I miei dati lasciano la mia macchina?+
Solo le chiamate che faresti comunque ad api.elido.app. Il server MCP è stdio (predefinito) o SSE locale — non comunica con l'esterno, non invia telemetria e il sorgente è su GitHub se vuoi verificare. Stesse regole di residenza UE della dashboard.
L'agente può eliminare i miei link per errore?+
Non con l'installazione predefinita. La modalità sola lettura è l'impostazione di base; concedere i permessi di scrittura/eliminazione richiede un'impostazione deliberata del workspace. Anche con la scrittura abilitata, ogni modifica appare nel log di audit con la chiave API che l'ha chiamata.
Quali client sono supportati?+
Claude Desktop, Cursor e Claude Code sono stabili. Continue.dev è in beta. Qualsiasi client che parli MCP 0.1.0 tramite stdio o SSE funziona — testiamo rispetto all'implementazione di riferimento del client.
Qual è il limite di frequenza?+
Lo stesso della chiave API del tuo workspace — 100 req/sec sostenute, 200 di picco, risponde con 429 e un Retry-After. Il server MCP trasmette l'errore 429 come errore dello strumento in modo che l'agente possa rallentare; non aggiungiamo un ulteriore livello.
Come si confronta con le integrazioni LLM su /ai/llm?+
Livelli diversi. /ai/llm è rivolto all'utente finale (GPT personalizzati, bot Slack, pulsanti deep-link) — pre-costruito, pronto all'uso. MCP è il protocollo per sviluppatori che sta sotto: ognuna di quelle integrazioni potrebbe essere costruita sopra MCP, e molti client di terze parti fanno esattamente questo.
Posso eseguire il mio fork?+
Sì. Il repository è sotto licenza MIT. I fork comuni aggiungono strumenti personalizzati (es. arricchimento dei metadati specifici del workspace, link interni a Notion/Linear). Se ne pubblichi uno, apri una segnalazione — vogliamo integrare a monte gli strumenti ampiamente utili.
Funziona in ambienti air-gapped?+
Sì per Elido self-hosted. Il server MCP ha solo bisogno di accesso alla rete verso il tuo endpoint api-core; può essere il tuo VPC privato. Elido su cloud pubblico necessita di uscita verso api.elido.app come qualsiasi altro client API.
Qual è il modello di sicurezza per la chiave API?+
Si applica lo standard 'minimi privilegi necessari'. Rilascia una chiave limitata a un singolo workspace, limita per IP se il tuo client gira da un IP noto e ruotala trimestralmente. La compromissione della chiave ha lo stesso raggio d'azione della compromissione di qualsiasi chiave API — limitata al workspace, registrata nell'audit log, revocabile.
Continua a leggere
AI all'interno della dashboard — genera slug, fai domande in linguaggio naturale.
GPT personalizzati, bot Slack, pulsanti deep-link. Il lato pre-configurato di /ai.
Zapier, HubSpot, Slack e il resto. Dove MCP non è lo strumento giusto.
Gli endpoint REST che MCP avvolge. Utile quando hai bisogno di uno strumento che MCP non espone ancora.
Pronto in 30 secondi
Inserisci lo snippet in Claude Desktop o Cursor, riavvia e guarda gli strumenti apparire nel catalogo del tuo agente.