Подключите Elido к любому AI-агенту.
Elido MCP - open-source сервер, который выставляет наши API ссылок, QR и аналитики как MCP-инструменты. Кладётся в Claude Desktop, Cursor или свой агент за 30 секунд.
Что такое MCP?
Model Context Protocol - открытый стандарт от Anthropic, который позволяет AI-агентам структурно общаться с инструментами, файлами и API. Один протокол - много клиентов.
До MCP подключение ИИ-агента к внешнему сервису означало написание кастомных инструкций в промпте, поддержку вручную написанной схемы инструмента и надежду, что модель вызовет её правильно. MCP заменяет это стандартизированным протоколом: сервер объявляет свои инструменты в JSON Schema, клиент обнаруживает их автоматически, и каждый вызов типизирован и подлежит аудиту. Один протокол работает в Claude Desktop, Cursor, Claude Code, Continue.dev и любом другом MCP-aware клиенте.
MCP-сервер Elido запускается локально в вашей среде. Он хранит ваш API-ключ, переводит структурированные вызовы инструментов от агента в REST-запросы к api.elido.app и возвращает структурированные результаты. Агент никогда не видит ваш ключ; api.elido.app никогда не общается напрямую с моделью.
Поток выполнения
От вашего сообщения в чате до Elido API и обратно
Последовательность состоит из четырёх шагов. Каждый быстрый - MCP-уровень добавляет менее 5 мс накладных расходов. REST-вызов к api.elido.app занимает 30–80 мс из ЕС. Вы видите результат в чате до того, как успеете переключиться на браузер.
Как это работает
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. Результат возвращается агенту
Ответ возвращается в виде структурированного результата, который агент может цитировать, резюмировать или использовать для следующего вызова. Ошибки содержат понятные сообщения (о лимитах, правах доступа, отсутствии данных), чтобы агент мог продолжить работу без вашего участия.
Доступные инструменты
Каждый инструмент типизирован по JSON-Schema. Агент видит имена параметров, типы и описания при запуске. Ручной инжиниринг промптов не нужен.
Пример сессии
Как это выглядит после установки
Это реальная сессия Claude Code после добавления MCP-сервера Elido. Агент обнаруживает инструменты при запуске. После этого достаточно обычного языка.
$ 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 loggedВызов инструмента отображается перед выполнением в Claude Desktop и Claude Code. Вы точно видите, какие аргументы передаёт агент. Можно отменить до выполнения вызова.
Что команды создают с этим
Три сценария использования. Выберите тот, который лучше всего подходит вашей команде.
Почему MCP, а не прямые вызовы API?
Все три подхода обращаются к одним и тем же эндпоинтам Elido. Разница проявляется во времени настройки, безопасности и в том, насколько прозрачна логика агента.
| Все возможности, бок о бок | Elido MCP | Direct REST | Browser only |
|---|---|---|---|
| Время настройки | 30 секунд (конфиг + ключ) | Кастомный промпт + описание инструментов (часы) | Ручное копирование (без автоматизации) |
| Каталог инструментов | Автоматическое обнаружение, типизация JSON-Schema | Описано вручную, устаревает при обновлении API | Отсутствует - агенту приходится гадать |
| Работа с API-ключом | Остается в окружении локального сервера | Вставляется прямо в промпты (риск утечки) | Вставляется в дашборде (привязан к cookies) |
| Журнал аудита | Структурированные вызовы инструментов в истории чата | Простой текст - сложно анализировать позже | История браузера; не фиксирует намерения |
| Повторное использование | Один конфиг для множества MCP-клиентов | Нужно заново настраивать промпты для каждого клиента | Состояние привязано к браузеру, нет переносимости |
Проверенные клиенты
Рейтинги стабильности основаны на нашем внутреннем тестовом наборе, который запускается против каждого клиента при каждом релизе. «Стабильный» означает, что полный каталог инструментов проходит. «Beta» означает, что работает, но граничные случаи (потоковые результаты, длинные списки) могут вести себя неожиданно.
Безопасность
Read-only по умолчанию. Ключ остаётся локально.
Модель безопасности следует принципу минимально необходимых прав. Стандартная установка имеет read-only доступ. Каждая мутация логируется. API-ключ никогда не покидает локальный серверный процесс.
Изоляция ключа
ELIDO_API_KEY находится в env сервера - никогда в промпте, никогда не отправляется модели. Модель вызывает инструмент; сервер подписывает запрос. Компрометация разговора с моделью не раскрывает ключ.
Контроль прав доступа
Read-only по умолчанию. Предоставление доступа на запись или удаление требует намеренной настройки в рабочем пространстве. Даже с включённой записью каждая мутация появляется в журнале аудита рабочего пространства с вызывающим ключом.
Открытый исходный код
Сервер имеет лицензию MIT на github.com/elidoapp/mcp-server. Прочитайте исходный код перед развёртыванием. Распространённые форки добавляют обогащение для конкретного рабочего пространства или внутренние вызовы инструментов.
Установка за 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_..." }
}
}
}Тот же сниппет работает для Cursor - поместите его в .cursor/mcp.json. Для Claude Code добавьте в .mcp.json вашего проекта. Выдайте API-ключ в Настройках → API-ключи. Read-only прав достаточно для большинства рабочих процессов.
Частые вопросы
Покидают ли мои данные мой компьютер?+
Только те вызовы, которые вы бы и так сделали к 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 прямо в чате с агентом.