Koppel Elido aan elke AI-agent.
Elido MCP is een open-source server die onze link-, QR- en analytics-API's beschikbaar stelt als MCP-tools. Zet hem in 30 seconden in Claude Desktop, Cursor of je eigen agent.
Wat is MCP?
Model Context Protocol is een open standaard van Anthropic waarmee AI-agents op een gestructureerde manier met tools, bestanden en API's kunnen praten. Eén protocol, veel clients.
Vóór MCP betekende het koppelen van een AI-agent aan een externe dienst het schrijven van aangepaste promptinstructies, het onderhouden van een handgemaakt tool-schema en hopen dat het model het correct aanriep. MCP vervangt dat door een gestandaardiseerd protocol: de server verklaart zijn tools in JSON Schema, de client ontdekt ze automatisch en elke aanroep is getypeerd en auditeerbaar. Eén protocol werkt op Claude Desktop, Cursor, Claude Code, Continue.dev en elke andere MCP-compatibele client.
De Elido MCP-server draait lokaal in jouw omgeving. Hij bewaart je API-sleutel, vertaalt gestructureerde tool-calls van de agent naar REST-verzoeken aan api.elido.app en retourneert gestructureerde resultaten. De agent ziet je sleutel nooit; api.elido.app praat nooit rechtstreeks met het model.
Runtime-flow
Van je chatbericht naar de Elido-API en terug
De reeks bestaat uit vier stappen. Elke stap is snel - de MCP-laag voegt minder dan 5ms overhead toe. De REST-aanroep naar api.elido.app duurt 30-80ms vanuit de EU. Je ziet het resultaat in de chat voordat je naar een browser kunt schakelen.
Hoe het werkt
MCP is een dun draadprotocol. De server draait in jouw omgeving, bewaart je API-sleutel en vertaalt gestructureerde tool-calls van de agent naar REST-verzoeken aan api.elido.app.
- 1. Agent vraagt om tools
Bij het opstarten vraagt de MCP-client (Claude Desktop, Cursor, je eigen agent) de Elido-server om zijn toolcatalogus. De server retourneert een JSON-Schema-beschrijving van elke beschikbare tool - namen, parameters, retourvormen.
- 2. Gebruiker doet een verzoek in de chat
Wanneer je zegt 'verkort deze URL met de tag launch-2026', matcht de agent dit met de catalogus en besluit create_link aan te roepen met gestructureerde argumenten. Je ziet de tool-call voordat hij wordt uitgevoerd, als je client dit toont (Claude Desktop doet dit).
- 3. Server bereikt api.elido.app
De lokale MCP-server ondertekent het verzoek met je ELIDO_API_KEY en roept het bijbehorende REST-endpoint aan. De latentie wordt bepaald door de retourreis naar api.elido.app - doorgaans 30-80ms vanuit de EU; de MCP-laag voegt minder dan 5ms toe.
- 4. Resultaat stroomt terug naar de agent
Het antwoord komt terug als een gestructureerd tool-resultaat dat de agent kan citeren, samenvatten of koppelen aan de volgende aanroep. Fouten bevatten bruikbare meldingen (rate-limit-hint, ontbrekend bereik, niet gevonden), zodat de agent kan herstellen zonder naar jou te escaleren.
Beschikbare tools
Elke tool is JSON-Schema-getypeerd. De agent ziet parameternamen, types en beschrijvingen bij het opstarten. Geen handmatige prompt-engineering nodig.
Voorbeeldsessie
Hoe het eruitziet na installatie
Dit is een echte Claude Code-sessie na het toevoegen van de Elido MCP-server. De agent ontdekt de tools bij het opstarten. Vanaf dat moment volstaat gewone taal.
$ 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 loggedDe tool-call is zichtbaar voordat hij wordt uitgevoerd, in Claude Desktop en Claude Code. Je ziet precies welke argumenten de agent meegeeft. Je kunt annuleren voordat de aanroep wordt verstuurd.
Wat teams hiermee bouwen
Drie patronen die we in productie zien. Kies wat past bij hoe jouw team al werkt.
Waarom MCP, en geen directe API-calls?
Alle drie de benaderingen bereiken dezelfde Elido-endpoints. De verschillen zitten in opzettijd, beveiligingspostuur en hoe leesbaar de redenering van de agent is.
| Elke functie, naast elkaar | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Opzettijd | 30 seconden (configuratie + sleutel) | Aangepaste prompt + tool-definities (uren) | Handmatig plakken/scrapen (geen automatisering) |
| Toolcatalogus | Automatisch ontdekt, JSON-Schema-getypeerd | Handgeschreven, raakt uit sync naarmate de API evolueert | Geen - agent moet gokken |
| Omgang met API-sleutel | Blijft in de omgeving van de lokale server | Geplakt in prompts (lekgevoelig) | Geplakt in het dashboard (cookie-gebonden) |
| Audittrail | Gestructureerde tool-calls in chatgeschiedenis | Vrije tekst - later lastig te doorzoeken | Browsergeschiedenis; legt geen intentie vast |
| Hergebruik over meerdere clients | Eén configuratie, N MCP-compatibele clients | Opnieuw prompten per client | Per-browser status, niet overdraagbaar |
Geteste clients
Stabiliteitsbeoordelingen zijn gebaseerd op onze interne testsuite, die bij elke release tegen elke client draait. "Stabiel" betekent dat de volledige toolcatalogus slaagt. "Beta" betekent dat het werkt, maar randgevallen (streamende resultaten, lange lijsten) zich onverwacht kunnen gedragen.
Beveiliging
Standaard alleen-lezen. Sleutel blijft lokaal.
Het beveiligingsmodel volgt het principe van zo min mogelijk rechten. De standaardinstallatie heeft alleen-lezentoegang. Elke wijziging wordt gelogd. De API-sleutel verlaat nooit het lokale serverproces.
Sleutelisolatie
ELIDO_API_KEY leeft in de omgeving van de server - nooit in een prompt, nooit naar het model gestuurd. Het model roept de tool aan; de server ondertekent het verzoek. Een gecompromitteerd modelgesprek stelt de sleutel niet bloot.
Bereikbeperking
Alleen-lezen is standaard. Schrijf- of verwijderrechten toekennen vereist een bewuste workspace-instelling. Zelfs met schrijfrechten ingeschakeld verschijnt elke wijziging in het workspace-auditlog met de aanroepende sleutel.
Open source
De server is MIT-gelicentieerd op github.com/elidoapp/mcp-server. Lees de broncode voordat je hem inzet. Veelvoorkomende forks voegen workspace-specifieke verrijking of interne tool-calls toe.
Installeer in 30 seconden
De server draait lokaal en authenticeert met je workspace-API-sleutel. Er verlaat geen data je machine, behalve de aanroepen naar api.elido.app die je toch al zou doen.
- 1Voeg de server toe aan de configuratie van je client
- 2Stel ELIDO_API_KEY in (maak er een aan bij Instellingen → API-sleutels)
- 3Herstart je client. De Elido-tools verschijnen in de toollijst van de agent.
{
"mcpServers": {
"elido": {
"command": "npx",
"args": ["-y", "@elido/mcp-server"],
"env": { "ELIDO_API_KEY": "elido_pk_..." }
}
}
}Hetzelfde snippet werkt voor Cursor - zet het in .cursor/mcp.json. Voor Claude Code voeg je het toe aan het .mcp.json-bestand van je project. Maak de API-sleutel aan bij Instellingen → API-sleutels. Alleen-lezenbereik volstaat voor de meeste workflows.
Veelgestelde vragen
Verlaat mijn data mijn machine?+
Alleen de aanroepen die je toch al aan api.elido.app zou doen. De MCP-server draait via stdio (standaard) of lokale SSE - hij belt niet naar huis, doet geen telemetrie, en de broncode staat op GitHub als je het zelf wilt verifiëren. Dezelfde EU-residentieregels als het dashboard.
Kan de agent per ongeluk mijn links verwijderen?+
Niet bij standaardinstallatie. Alleen-lezen modus is de standaard; schrijf-/verwijderrechten toekennen vereist een bewuste workspace-instelling. Zelfs met schrijfrechten ingeschakeld verschijnt elke wijziging in het auditlog met de API-sleutel die de aanroep deed.
Welke clients worden ondersteund?+
Claude Desktop, Cursor en Claude Code zijn stabiel. Continue.dev is in beta. Elke client die MCP 0.1.0 spreekt via stdio of SSE werkt - we testen tegen de referentie-clientimplementatie.
Wat is de rate limit?+
Hetzelfde als de API-sleutel van je workspace - 100 req/sec continu, 200 burst, met een 429 en Retry-After als grens. De MCP-server geeft de 429 door als een tool-fout, zodat de agent kan afremmen; we voegen geen extra laag toe.
Hoe verhoudt dit zich tot de LLM-integraties op /ai/llm?+
Andere lagen. /ai/llm is gericht op de eindgebruiker (custom GPT's, Slack-bots, deep-link-knoppen) - kant-en-klaar, klik-en-gebruik. MCP is het ontwikkelaarsprotocol dat eronder ligt: elk van die integraties zou bovenop MCP gebouwd kunnen zijn, en veel externe clients doen precies dat.
Kan ik mijn eigen fork draaien?+
Ja. De repo is MIT-gelicentieerd. Veelvoorkomende forks voegen aangepaste tools toe (bijv. workspace-specifieke metadataverrijking, interne links naar Notion/Linear). Breng je er een uit, open dan een issue - we willen breed bruikbare tools upstream landen.
Werkt het in air-gapped omgevingen?+
Ja, voor self-hosted Elido. De MCP-server heeft alleen netwerktoegang tot je api-core-endpoint nodig; dat kan je eigen private VPC zijn. Public-cloud Elido heeft egress naar api.elido.app nodig, zoals elke andere API-client.
Wat is het beveiligingsmodel voor de API-sleutel?+
Het standaardprincipe 'zo min mogelijk rechten' geldt hier. Geef een sleutel uit die beperkt is tot één workspace, beperk deze op IP als je client vanaf een bekend IP draait, en roteer per kwartaal. Een gecompromitteerde sleutel heeft dezelfde impact als elke andere API-sleutel - workspace-gebonden, geauditeerd, intrekbaar.
Lees verder
AI binnen het dashboard - genereer slugs, stel vragen in gewoon Nederlands.
Custom GPT's, Slack-bots, deep-link-knoppen. De kant-en-klare kant van /ai.
Zapier, HubSpot, Slack en de rest. Waar MCP niet het juiste gereedschap is.
De REST-endpoints die MCP omhult. Handig als je een tool nodig hebt die MCP nog niet blootlegt.
Klaar in 30 seconden
Zet het snippet in Claude Desktop of Cursor, herstart, en zie de tools verschijnen in de catalogus van je agent.