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

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-ключ

1. Откройте Dashboard → API Keys → New key.
2. Выберите права (links:read и analytics:read для чтения, плюс links:write для создания ссылок).
3. Скопируйте ключ. Он передаётся в 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.