Що ви налаштуєте
- API-токен Elido з точно обмеженими правами для Claude або Cursor — лише читання за замовчуванням,
links:write— за потреби. - MCP-сервер Elido, підключений до Claude Desktop (через інтерфейс налаштувань або
~/.claude.json) або Cursor (через панель MCP). - Доступ до п'яти інструментів Elido: перегляд списку, отримання, створення, оновлення посилань і отримання аналітики — доступні з чату або редактора.
Elido надає сервер Model Context Protocol (MCP) за адресою https://api.elido.app/mcp. Після підключення Claude або Cursor зможуть читати аналітику ваших посилань, скорочувати URL-адреси та переглядати деталі посилань — безпосередньо в чаті або редакторі.
Що дає MCP#
- Запитайте «Скільки кліків отримало
spring-2026цього тижня?» — Claude зробить запит до Elido і відповість реальним числом. - Скажіть «Скороти
https://example.com/very-long-pathз тегом newsletter» — Claude створить посилання та покаже вам коротку URL-адресу. - У Cursor опишіть реліз і попросіть його «створити коротке посилання для допису про реліз у блозі» — він скоротить його прямо в коді.
За замовчуванням доступ лише для читання. Доступ на запис (створення, оновлення посилань) потребує активації під час авторизації.
Крок 1 — Згенеруйте токен Elido API#
- Перейдіть до Dashboard → API Keys → New key.
- Виберіть області доступу (scopes):
links:read analytics:readдля режиму лише читання.- Додайте
links:write, якщо хочете, щоб Claude міг створювати посилання.
- Скопіюйте токен (починається з
ek_).
Підключення в Claude Desktop#
Claude Desktop зберігає конфігурацію MCP-сервера у ~/.claude.json (або в інтерфейсі налаштувань Claude у новіших версіях).
Варіант А — Інтерфейс налаштувань (Claude Desktop 0.10+):
- Відкрийте Claude Desktop → Settings → Connectors → Add connector → Custom MCP server.
- Вставте URL-адресу сервера:
https://api.elido.app/mcp - У розділі Authentication виберіть Bearer token і вставте свій токен Elido API.
- Натисніть Connect. Claude отримає маніфест інструментів (~2 секунди) і покаже доступні інструменти Elido.
Варіант Б — Пряме редагування файлу конфігурації:
Відкрийте ~/.claude.json у текстовому редакторі та додайте запис у розділ mcpServers:
{
"mcpServers": {
"elido": {
"url": "https://api.elido.app/mcp",
"headers": {
"Authorization": "Bearer ek_your_token_here"
}
}
}
}
Збережіть файл. Перезапустіть Claude Desktop. Конектор Elido з’явиться у списку конекторів.
Підключення в Cursor#
- Відкрийте Cursor → Settings → MCP (або
Cmd/Ctrl + ,→ пошук «MCP»). - Натисніть Add MCP server.
- Server URL:
https://api.elido.app/mcp - Auth header:
Authorization: Bearer ek_your_token_here - Натисніть Save. Cursor отримає маніфест. Доступні інструменти з’являться в панелі MCP.
Альтернатива — Claude Code CLI (для користувачів терміналу):
claude mcp add elido https://api.elido.app/mcp \
--header "Authorization: Bearer $ELIDO_TOKEN"
Це додасть сервер до вашого ~/.claude.json через командний рядок. Встановіть ELIDO_TOKEN у профілі вашої оболонки (shell), щоб він був доступний у кожній сесії.
Доступні інструменти#
| Інструмент | Необхідна область | Опис дії |
|---|---|---|
list_links | links:read | Виводить список посилань з можливістю фільтрації (тег, домен, пошук) |
get_link | links:read | Повертає одне посилання за slug або ID |
get_analytics | analytics:read | Повертає кількість кліків + розбивку для посилання |
create_link | links:write | Створює нове коротке посилання |
update_link | links:write | Оновлює цільову адресу, slug, теги або термін дії |
За замовчуванням інструменти працюють лише для читання. Для створення та оновлення посилань потрібна область доступу 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_... (без зайвих пробілів, з правильним префіксом).
Інструменти з’являються, але інструменти запису повертають «forbidden» — Ваш API-токен не має області links:write. Згенеруйте новий токен з цією областю доступу та оновіть заголовок у конфігурації MCP.
Claude Desktop не відображає Elido в конекторах після редагування конфігурації — Повністю перезапустіть Claude Desktop (вийдіть через Quit, а не просто закрийте вікно). На macOS перевірте рядок меню на наявність запущеного екземпляра Claude.
Панель Cursor MCP показує «disconnected» — Cursor повторно отримує маніфест під час кожної сесії. Якщо api.elido.app відповідає повільно, Cursor може перервати з’єднання за тайм-аутом. Спробуйте натиснути Reconnect у панелі MCP. Якщо проблема не зникає, перевірте сторінку статусу Elido.