Использовать Elido в Claude Desktop и Cursor

Elido предоставляет MCP-сервер (Model Context Protocol) по адресу https://api.elido.app/mcp. После подключения Claude или Cursor могут читать аналитику по ссылкам, создавать короткие URL и получать детали ссылок — прямо из чата или редактора.

Что даёт MCP#

• Спроси «Сколько кликов получил spring-2026 за эту неделю?» — Claude обратится к Elido и ответит реальными цифрами.
• Скажи «Сократи https://example.com/very-long-path с тегом newsletter» — Claude создаст ссылку и покажет короткий URL.
• В Cursor опиши релиз и попроси «создай короткую ссылку для поста блога о релизе» — он сократит её прямо в редакторе.

По умолчанию доступ только на чтение. Доступ на запись (создание, обновление ссылок) требует явного подтверждения при авторизации.

Шаг 1 — Создай API-токен Elido#

1. Перейди в Dashboard → API Keys → New key.
2. Выбери scopes:
   • links:read analytics:read для только чтения.
   • Добавь links:write, если хочешь, чтобы Claude мог создавать ссылки.
3. Скопируй токен (начинается с ek_).

Подключение в Claude Desktop#

Claude Desktop хранит конфигурацию MCP-серверов в ~/.claude.json (или в разделе настроек UI на более новых версиях).

Вариант A — через UI настроек (Claude Desktop 0.10+):

1. Открой Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
2. Вставь URL сервера: https://api.elido.app/mcp
3. В разделе Authentication выбери Bearer token и вставь API-токен Elido.
4. Нажми Connect. Claude загрузит манифест инструментов (~2 секунды) и покажет доступные инструменты Elido.

Вариант B — прямое редактирование конфигурационного файла:

Открой ~/.claude.json в текстовом редакторе и добавь запись в mcpServers:

{
  "mcpServers": {
    "elido": {
      "url": "https://api.elido.app/mcp",
      "headers": {
        "Authorization": "Bearer ek_your_token_here"
      }
    }
  }
}

Сохрани файл. Перезапусти Claude Desktop. Коннектор Elido появится в списке коннекторов.

Подключение в Cursor#

1. Открой Cursor → Settings → MCP (или Cmd/Ctrl + , → поиск "MCP").
2. Нажми Add MCP server.
3. Server URL: https://api.elido.app/mcp
4. Auth header: Authorization: Bearer ek_your_token_here
5. Нажми Save. Cursor загрузит манифест. Доступные инструменты появятся в панели MCP.

Альтернатива — Claude Code CLI (для пользователей терминала):

claude mcp add elido https://api.elido.app/mcp \
  --header "Authorization: Bearer $ELIDO_TOKEN"

Это добавит сервер в ~/.claude.json из командной строки. Задай ELIDO_TOKEN в профиле шелла, чтобы он был доступен в каждой сессии.

Доступные инструменты#

Инструмент	Требуемый scope	Что делает
list_links	links:read	Список ссылок с опциональными фильтрами (тег, домен, поиск)
get_link	links:read	Возвращает одну ссылку по слагу или ID
get_analytics	analytics:read	Возвращает количество кликов и детализацию для ссылки
create_link	links:write	Создаёт новую короткую ссылку
update_link	links:write	Обновляет назначение, слаг, теги или срок действия

По умолчанию инструменты доступны только для чтения. Создание и обновление ссылок требует scope links:write в API-токене.

Область доступа#

MCP-сервер выводит данные только из воркспейса, которому принадлежит API-токен. Доступ к другим воркспейсам невозможен. Если у тебя несколько воркспейсов, создай отдельный токен для каждого и добавь несколько записей MCP-сервера с разными именами (elido-workspace-a, elido-workspace-b).

Устранение неполадок#

«Failed to fetch tool manifest» — URL MCP-сервера неверный или недоступен. Проверь, открыв https://api.elido.app/mcp в браузере — должен вернуться JSON-манифест. Если ошибка сертификата — сеть может блокировать TLS к api.elido.app.

«Unauthorized» при вызове инструмента — API-токен отсутствует или неверный в заголовке Authorization. Проверь, что формат точно Authorization: Bearer ek_... (без лишних пробелов, правильный префикс).

Инструменты появились, но write-инструменты возвращают «forbidden» — API-токен не имеет scope links:write. Создай новый токен с этим scope и обнови заголовок в конфигурации MCP.

Claude Desktop не показывает Elido в коннекторах после редактирования конфига — Полностью перезапусти Claude Desktop (Quit, не просто закрой окно). На macOS проверь в строке меню, нет ли запущенного экземпляра Claude.

Cursor MCP panel показывает «disconnected» — Cursor повторно загружает манифест при каждой сессии. Если api.elido.app медленно отвечает, Cursor может выдать таймаут. Попробуй нажать Reconnect в панели MCP. Если проблема сохраняется, проверь страницу статуса Elido.