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.
Prima di MCP, collegare un agente AI a un servizio esterno richiedeva la scrittura di istruzioni prompt personalizzate, il mantenimento di uno schema strumento fatto a mano e la speranza che il modello lo chiamasse correttamente. MCP sostituisce tutto ciò con un protocollo standardizzato: il server dichiara i suoi strumenti in JSON Schema, il client li scopre automaticamente e ogni chiamata è tipizzata e auditabile. Un protocollo funziona con Claude Desktop, Cursor, Claude Code, Continue.dev e qualsiasi altro client compatibile MCP.
Il server Elido MCP gira localmente nel tuo ambiente. Mantiene la tua chiave API, traduce le chiamate agli strumenti strutturati dall'agente in richieste REST a api.elido.app e restituisce risultati strutturati. L'agente non vede mai la tua chiave; api.elido.app non parla mai direttamente con il modello.
Flusso runtime
Dal tuo messaggio in chat all'API Elido e ritorno
La sequenza è in quattro passaggi. Ognuno è rapido - il layer MCP aggiunge meno di 5ms di overhead. La chiamata REST a api.elido.app richiede 30–80ms dall'UE. Vedi il risultato in chat prima di poter passare al 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
Ogni strumento è tipizzato con JSON-Schema. L'agente vede nomi dei parametri, tipi e descrizioni all'avvio. Nessuna ingegneria manuale del prompt richiesta.
Sessione di esempio
Come appare dopo l'installazione
Questa è una sessione reale di Claude Code dopo aver aggiunto il server Elido MCP. L'agente scopre gli strumenti all'avvio. Da lì, il linguaggio semplice è sufficiente.
$ 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 loggedLa chiamata allo strumento è visibile prima dell'esecuzione in Claude Desktop e Claude Code. Vedi esattamente quali argomenti l'agente passa. Puoi annullare prima che la chiamata parta.
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
I rating di stabilità si basano sulla nostra suite di test interna che gira su ogni client ad ogni release. 'Stabile' significa che l'intero catalogo di strumenti supera il test. 'Beta' significa che funziona ma i casi limite (risultati in streaming, liste lunghe) potrebbero comportarsi in modo imprevisto.
Sicurezza
Sola lettura di default. La chiave rimane locale.
Il modello di sicurezza segue il principio dei minimi scope necessari. L'installazione predefinita ha accesso in sola lettura. Ogni mutazione è registrata. La chiave API non lascia mai il processo server locale.
Isolamento chiave
ELIDO_API_KEY vive nell'env del server - mai in un prompt, mai inviata al modello. Il modello chiama lo strumento; il server firma la richiesta. La compromissione della conversazione con il modello non espone la chiave.
Controllo scope
La sola lettura è il default. Concedere accesso in scrittura o eliminazione richiede un'impostazione workspace deliberata. Anche con le scritture abilitate, ogni mutazione appare nel log di audit workspace con la chiave chiamante.
Open source
Il server è sotto licenza MIT su github.com/elidoapp/mcp-server. Leggi il codice sorgente prima di distribuire. I fork comuni aggiungono arricchimento specifico del workspace o chiamate a strumenti interni.
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_..." }
}
}
}Lo stesso snippet funziona per Cursor - inseriscilo in .cursor/mcp.json. Per Claude Code, aggiungilo al .mcp.json del tuo progetto. Emetti la chiave API in Impostazioni → Chiavi API. Lo scope di sola lettura è sufficiente per la maggior parte dei workflow.
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; 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.