Що ви налаштуєте
- API-ключ Elido з потрібними правами.
- Локальний MCP-сервер Elido (
@elido/mcp-server, бета), підключений до Claude Desktop, Cursor або Claude Code через stdio. - П'ять інструментів: створення посилань, список посилань, аналітика, QR-коди та список робочих просторів.
Elido постачає сервер Model Context Protocol (MCP) як локальну програму. Вона працює на вашому комп'ютері, звертається до REST API Elido з вашим API-ключем і спілкується з клієнтом по stdio. Віддаленого MCP-URL та OAuth-конектора немає: URL сервера не можна вставити в екран Connectors у Claude.
Крок 1: зберіть сервер
З копії репозиторію Elido виконайте команди нижче. Вони створять packages/mcp-server/dist/index.js; запам'ятайте абсолютний шлях.
pnpm install
pnpm --filter @elido/mcp-server build
Крок 2: створіть API-ключ
- Відкрийте Dashboard → API Keys → New key.
- Виберіть права (
links:readіanalytics:readдля читання, плюсlinks:writeдля створення посилань). - Скопіюйте ключ. Він передається в API як
Authorization: Bearer ….
Claude Desktop
{
"mcpServers": {
"elido": {
"command": "node",
"args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
"env": {
"ELIDO_API_KEY": "your_api_key",
"ELIDO_WORKSPACE_ID": "42"
}
}
}
}
Змініть ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) або %APPDATA%\Claude\claude_desktop_config.json (Windows) і повністю перезапустіть Claude Desktop.
Cursor
Додайте той самий блок mcpServers у .cursor/mcp.json проєкту (або ~/.cursor/mcp.json для всіх проєктів) і перезапустіть Cursor.
Claude Code
claude mcp add elido --env ELIDO_API_KEY=your_api_key -- \
node /absolute/path/to/packages/mcp-server/dist/index.js
Виконайте claude mcp list, щоб переконатися, що сервер підключено.
Доступні інструменти
| Інструмент | Що робить |
|---|---|
create_link | Скорочує URL із необов'язковими slug, доменом, назвою та тегами |
list_links | Список останніх посилань робочого простору |
query_analytics | Часовий ряд кліків для простору або посилання з урахуванням часового поясу |
generate_qr | QR-код (SVG або PNG) для наявного посилання |
list_workspaces | Робочі простори, доступні API-ключу |
Змінні середовища: ELIDO_API_KEY (обов'язкова), ELIDO_WORKSPACE_ID (необов'язкова, якщо ключ бачить кілька просторів), ELIDO_API_BASE (за замовчуванням https://api.elido.app, змініть для self-host).
Усунення проблем
Клієнт показує сервер як збійний. Перевірте, що шлях в args абсолютний і dist/index.js існує (повторіть збірку). Запустіть ELIDO_API_KEY=test node /absolute/path/to/packages/mcp-server/dist/index.js у терміналі, щоб побачити помилки запуску.
«Unauthorized». Ключ відсутній, з помилкою або відкликаний. Створіть новий у Dashboard → API Keys.
Створення посилання повертає «forbidden». Ключу бракує links:write.