MCP-сервер

Model Context Protocol - це відкритий стандарт, опублікований Anthropic для того, щоб ШІ-агенти могли викликати інструменти у ваших сервісах. Elido постачається з MCP-сервером, тому будь-який сумісний клієнт - Claude Desktop, Cursor, ChatGPT, Continue, Zed - може скорочувати URL-адреси, переглядати аналітику кліків, керувати QR-кодами та запускати масовий імпорт без копіювання та вставки між вкладками.

Є два способи налаштування:

Хмарний (рекомендовано): спрямуйте свій клієнт на https://mcp.elido.app/v1/ з персональним токеном доступу. Не потребує встановлення, завжди актуальний.
Локальний (self-hosted): запустіть бінарний файл або контейнер локально; корисно для ізольованих (air-gapped) середовищ та офлайн-роботи.

1. Отримайте персональний токен доступу

У панелі керування перейдіть до Settings → API keys → New key. Виберіть область доступу (scope) mcp:full (або mcp:readonly, якщо вам потрібна лише аналітика без змін). Скопіюйте токен - він відображається лише один раз.


ELIDO_MCP_TOKEN="elt_…"

Токен діє в межах робочої області (workspace). Змінюєте робочу область - змінюєте токен.

2. Хмарне налаштування - Claude Desktop

Відкрийте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS (Windows: %APPDATA%\Claude\claude_desktop_config.json) та додайте:


{
  "mcpServers": {
    "elido": {
      "type": "http",
      "url": "https://mcp.elido.app/v1/",
      "headers": {
        "Authorization": "Bearer elt_…"
      }
    }
  }
}

Перезапустіть Claude. Набір інструментів Elido з’явиться у виборі інструментів.

3. Хмарне налаштування - Cursor

Cursor зчитує дані з того самого файлу ~/.cursor/mcp.json:


{
  "mcpServers": {
    "elido": {
      "url": "https://mcp.elido.app/v1/",
      "headers": { "Authorization": "Bearer elt_…" }
    }
  }
}

Перезавантажте вікно Cursor. Виклик @elido працює в панелях чату.

4. Хмарне налаштування - ChatGPT

ChatGPT зчитує MCP-сервери через Settings → Connectors → Add custom connector. Вставте https://mcp.elido.app/v1/ і встановіть заголовок авторизації Bearer elt_…. ChatGPT відобразить інструменти в будь-якій новій розмові.

5. Локальне розміщення (Self-host)

Бінарний файл MCP постачається в тому самому Docker-образі, що й решта self-host пакету:


docker run --rm -p 8765:8765 \
  -e ELIDO_API_BASE=https://api.elido.app \
  -e ELIDO_MCP_TOKEN=elt_… \
  ghcr.io/elidoapp/mcp-server:latest

Або за допомогою npm-обгортки, якщо вам потрібен транспорт stdio (наприклад, для агента, який надає перевагу stdio):


npx -y @elido/mcp-server@latest

Налаштуйте клієнт для запуску локального процесу:


{
  "mcpServers": {
    "elido-local": {
      "command": "npx",
      "args": ["-y", "@elido/mcp-server@latest"],
      "env": { "ELIDO_MCP_TOKEN": "elt_…" }
    }
  }
}

6. Набір інструментів

Сервер надає доступ до 18 інструментів у 5 просторах імен. Найпопулярніші:

Інструмент	Область доступу	Що він робить
`links.create`	`mcp:full`	Скоротити URL з необов’язковим UTM-шаблоном + терміном дії
`links.list`	`mcp:readonly`	Пагінований список посилань із кількістю кліків
`links.update`	`mcp:full`	Оновити цільову сторінку, слаг, правила, теги
`analytics.summary`	`mcp:readonly`	Найпопулярніші країни / реферери / пристрої для посилання або кампанії
`analytics.timeseries`	`mcp:readonly`	Погодинні / поденні інтервали, повертає дані, готові для графіків
`qrs.create`	`mcp:full`	Дизайнерський QR-код із логотипом та кольорами
`bulk.import`	`mcp:full`	Завантажити CSV; повертає статус для кожного рядка
`webhooks.replay`	`mcp:full`	Повторно відправити подію з логу аудиту

Повна схема доступна в довіднику API - кожен MCP-інструмент на 1:1 відповідає публічній REST-кінцевій точці, тому документація до API є документацією і для агента.

7. Безпека

Лише для читання за замовчуванням: вибирайте mcp:readonly, якщо агент лише досліджує дані; переходьте до mcp:full тільки тоді, коли потрібен запис.
Список дозволених інструментів: у панелі керування ви можете обмежити токен певним набором інструментів, наприклад, дозволити links.*, але заборонити bulk.import (який може створити тисячі посилань за один виклик).
Лог аудиту: кожен виклик MCP потрапляє в лог аудиту робочої області з ідентифікатором агента, інструментом та аргументами - так само, як і дії людини в панелі керування.
Rate limit: хмарний сервер обмежений 60 викликами на хвилину на токен; локальний (self-hosted) не має обмежень.

8. Особливі випадки

Тривалі виклики - bulk.import для >5000 рядків виконується асинхронно; інструмент повертає ID завдання, а агент опитує bulk.status до завершення. Жодних таймаутів на стороні клієнта.
Перемикання робочих областей - один токен = одна робоча область. Видайте окремий токен для кожної робочої області; у списку конекторів MCP-клієнта кожна з них відображатиметься як окремий сервер.
Ротація токенів - видайте новий токен, оновіть конфігурацію, а потім анулюйте старий. Не використовуйте токени повторно; лог аудиту покладається на стабільні ID токенів.

Дивіться також

Довідник API - REST + gRPC кінцеві точки
SDKs - обгортки TypeScript / Go / Python для тих самих кінцевих точок
Вебхуки - надсилання подій назовні, тоді як MCP отримує їх запитом