Elma365

FreeNot checked

MCP server for ELMA365 API providing tools to manage app items, BPM tasks, processes, users, and comments.

by theYahia

GitHub Embed

About

MCP server for ELMA365 API providing tools to manage app items, BPM tasks, processes, users, and comments.

README

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

npm License: MIT CI

Часть серии 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

from github.com/theYahia/elma365-mcp

Install Elma365 in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install elma365-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add elma365-mcp -- npx -y @theyahia/elma365-mcp

FAQ

Is Elma365 MCP free?

Yes, Elma365 MCP is free — one-click install via Unyly at no cost.

Does Elma365 need an API key?

No, Elma365 runs without API keys or environment variables.

Is Elma365 hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Elma365 in Claude Desktop, Claude Code or Cursor?

Open Elma365 on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.