Подключите Elido к любому AI-агенту.
Elido MCP — open-source сервер, который выставляет наши API ссылок, QR и аналитики как MCP-инструменты. Кладётся в Claude Desktop, Cursor или свой агент за 30 секунд.
Что такое MCP?
Model Context Protocol — открытый стандарт от Anthropic, который позволяет AI-агентам структурно общаться с инструментами, файлами и API. Один протокол — много клиентов.
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.
Как это работает
MCP — это легкий протокол связи. Сервер запускается в вашей среде, хранит ваш API-ключ и переводит структурированные вызовы инструментов от агента в REST-запросы к api.elido.app.
- 1. Агент запрашивает инструменты
При запуске MCP-клиент (Claude Desktop, Cursor, ваш собственный агент) запрашивает у сервера Elido каталог инструментов. Сервер возвращает описание каждого инструмента в формате JSON-Schema — названия, параметры, форматы ответов.
- 2. Пользователь делает запрос в чате
Когда вы говорите «сократи этот URL с тегом launch-2026», агент находит подходящий инструмент в каталоге и вызывает create_link со структурированными аргументами. Если ваш клиент это поддерживает (как Claude Desktop), вы увидите вызов инструмента перед выполнением.
- 3. Сервер обращается к api.elido.app
Локальный MCP-сервер подписывает запрос вашим ELIDO_API_KEY и вызывает соответствующий REST-эндпоинт. Задержка в основном зависит от времени ответа api.elido.app — обычно 30–80 мс из ЕС; слой MCP добавляет менее 5 мс.
- 4. Результат возвращается агенту
Ответ возвращается в виде структурированного результата, который агент может цитировать, резюмировать или использовать для следующего вызова. Ошибки содержат понятные сообщения (о лимитах, правах доступа, отсутствии данных), чтобы агент мог продолжить работу без вашего участия.
Доступные инструменты
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.
Что команды создают с этим
Три сценария использования. Выберите тот, который лучше всего подходит вашей команде.
Почему MCP, а не прямые вызовы API?
Все три подхода обращаются к одним и тем же эндпоинтам Elido. Разница проявляется во времени настройки, безопасности и в том, насколько прозрачна логика агента.
| Все возможности, бок о бок | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Время настройки | 30 секунд (конфиг + ключ) | Кастомный промпт + описание инструментов (часы) | Ручное копирование (без автоматизации) |
| Каталог инструментов | Автоматическое обнаружение, типизация JSON-Schema | Описано вручную, устаревает при обновлении API | Отсутствует — агенту приходится гадать |
| Работа с API-ключом | Остается в окружении локального сервера | Вставляется прямо в промпты (риск утечки) | Вставляется в дашборде (привязан к cookies) |
| Журнал аудита | Структурированные вызовы инструментов в истории чата | Простой текст — сложно анализировать позже | История браузера; не фиксирует намерения |
| Повторное использование | Один конфиг для множества MCP-клиентов | Нужно заново настраивать промпты для каждого клиента | Состояние привязано к браузеру, нет переносимости |
Проверенные клиенты
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.
Установка за 30 секунд
Сервер работает локально и аутентифицируется API-ключом воркспейса. Никакие данные не выходят за пределы вашей машины, кроме вызовов api.elido.app, которые вы делали бы и так.
- 1Добавьте сервер в конфиг клиента
- 2Задайте ELIDO_API_KEY (выпустите в Settings → API Keys)
- 3Перезапустите клиент. Инструменты Elido появятся в списке tools агента.
{
"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.
Частые вопросы
Покидают ли мои данные мой компьютер?+
Только те вызовы, которые вы бы и так сделали к api.elido.app. MCP-сервер работает через stdio (по умолчанию) или локальный SSE — он не передает данные на сторонние серверы, не собирает телеметрию, а его исходный код открыт на GitHub для проверки. Действуют те же правила хранения данных в ЕС, что и для дашборда.
Может ли агент случайно удалить мои ссылки?+
Не при стандартной установке. Режим «только чтение» установлен по умолчанию; для разрешения записи или удаления требуется осознанное изменение настроек. Даже при включенной записи каждое изменение фиксируется в журнале аудита с указанием использованного API-ключа.
какие клиенты поддерживаются?+
Claude Desktop, Cursor и Claude Code работают стабильно. Continue.dev находится в стадии бета-тестирования. Подойдет любой клиент, поддерживающий протокол MCP 0.1.0 через stdio или SSE — мы тестируем совместимость с эталонной реализацией.
Какой лимит запросов?+
Такой же, как у API-ключа вашего рабочего пространства — 100 запросов в секунду (постоянно), 200 (пиково). При превышении возвращается ошибка 429 с заголовком Retry-After. MCP-сервер передает ошибку 429 агенту, чтобы тот мог подождать; мы не добавляем собственных ограничений.
Чем это отличается от интеграций с LLM на /ai/llm?+
Это разные уровни. /ai/llm ориентирован на конечных пользователей (кастомные GPT, боты для Slack, кнопки создания ссылок) — готовые решения в один клик. MCP — это протокол для разработчиков, лежащий в основе: любую из этих интеграций можно построить поверх MCP, и многие сторонние клиенты именно так и делают.
Могу ли я создать собственный форк?+
Да. Репозиторий распространяется под лицензией MIT. Часто в форки добавляют специфические инструменты (например, обогащение метаданных для конкретного рабочего пространства, ссылки на внутренние Notion или Linear). Если вы создадите что-то полезное, сообщите нам — мы будем рады добавить популярные инструменты в основную версию.
Работает ли это в изолированных средах (air-gapped)?+
Да, если вы используете self-hosted версию Elido. MCP-серверу нужен только сетевой доступ к вашему эндпоинту api-core; это может быть ваша частная VPC. Облачной версии Elido нужен доступ к api.elido.app, как и любому другому API-клиенту.
Какая модель безопасности используется для API-ключа?+
Применяется стандартный принцип «наименьших привилегий». Выпустите ключ только для одного рабочего пространства, ограничьте доступ по IP (если ваш клиент работает со статического IP) и обновляйте его раз в квартал. В случае компрометации ключа последствия будут такими же, как для любого API-ключа: доступ ограничен рабочим пространством, действия логируются, ключ можно отозвать.
Продолжить чтение
ИИ внутри дашборда — создавайте слаги и задавайте вопросы на обычном языке.
Кастомные GPT, боты для Slack и кнопки создания ссылок. Готовые решения в разделе /ai.
Zapier, HubSpot, Slack и другие. Когда MCP не самый подходящий инструмент.
REST-эндпоинты, которые оборачивает MCP. Полезно, если вам нужен инструмент, который еще не реализован в MCP.
Готов к работе за 30 секунд
Добавьте фрагмент кода в конфиг Claude Desktop или Cursor, перезапустите клиент и используйте инструменты Elido прямо в чате с агентом.