@theyahia/elma365-mcp

MCP-сервер для ELMA365 API — элементы приложений, BPM-задачи, процессы, пользователи, комментарии. 9 инструментов.

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop

{
  "mcpServers": {
    "elma365": {
      "command": "npx",
      "args": ["-y", "@theyahia/elma365-mcp"],
      "env": {
        "ELMA365_DOMAIN": "mycompany",
        "ELMA365_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add elma365 \
  -e ELMA365_DOMAIN=mycompany \
  -e ELMA365_TOKEN=your-token \
  -- npx -y @theyahia/elma365-mcp

VS Code / Cursor

{
  "servers": {
    "elma365": {
      "command": "npx",
      "args": ["-y", "@theyahia/elma365-mcp"],
      "env": {
        "ELMA365_DOMAIN": "mycompany",
        "ELMA365_TOKEN": "your-token"
      }
    }
  }
}

Streamable HTTP (для веб-клиентов)

ELMA365_DOMAIN=mycompany ELMA365_TOKEN=your-token npx @theyahia/elma365-mcp --http --port 3000

Endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health

Smithery

Используйте smithery.yaml в корне репозитория для деплоя на Smithery.

Требуется ELMA365_DOMAIN (домен или поддомен ELMA365, например mycompany) и ELMA365_TOKEN (Bearer API-токен).

Инструменты (9)

Инструмент	Описание
`get_app_items`	Список элементов приложения по namespace и code
`create_item`	Создание нового элемента в приложении
`get_tasks`	Список BPM-задач
`get_processes`	Список бизнес-процессов
`start_process`	Запуск бизнес-процесса по коду
`get_users`	Список пользователей
`get_user_by_id`	Получение пользователя по ID
`get_comments`	Комментарии к элементу приложения
`add_comment`	Добавить комментарий к элементу

Skills (Claude Code)

Skill	Описание
`/skill-my-tasks`	Мои задачи — показать текущие BPM-задачи
`/skill-start-process`	Запусти бизнес-процесс по коду

Примеры

Покажи элементы приложения deals/crm_deals
Создай новый элемент в приложении hr/candidates
Покажи мои BPM-задачи
Покажи список бизнес-процессов
Запусти процесс approval_flow с параметрами {"amount": 50000}
Покажи пользователей
Покажи комментарии к элементу item-123 в deals/crm_deals
Добавь комментарий "Согласовано" к элементу item-123 в deals/crm_deals

Транспорт

Режим	Команда	Описание
stdio (по умолчанию)	`npx @theyahia/elma365-mcp`	Для Claude Desktop, Claude Code, Cursor
Streamable HTTP	`npx @theyahia/elma365-mcp --http`	Для веб-клиентов, port 3000 по умолчанию
Streamable HTTP (порт)	`npx @theyahia/elma365-mcp --http --port 8080`	Кастомный порт

Аутентификация

ELMA365_DOMAIN — домен ELMA365 (например mycompany для mycompany.elma365.ru, или полный домен mycompany.elma365.ru)
ELMA365_TOKEN — Bearer-токен для ELMA365 API

Базовый URL: https://{domain}.elma365.ru/pub/v1/

Разработка

npm install
npm run build
npm test
npm run dev    # запуск через tsx

Лицензия

MIT

elma365-mcp

Quick Install