English Français العربية

io.github.theYahia/elma365-mcp

السجل الرسمي أخرى

MCP server for ELMA365 API — app items, BPM tasks. 3 tools.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/elma365-mcp
Claude Code 
claude mcp add elma365-mcp -e 'ELMA365_DOMAIN=<your elma365_domain>' -- npx -y @theyahia/elma365-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "elma365-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/elma365-mcp@1.0.0"
            ],
            "env": {
                "ELMA365_DOMAIN": "<your elma365_domain>"
            }
        }
    }
}

متغيرات البيئة

  • ELMA365_DOMAIN إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP-сервер для ELMA365 — BPM-задачи и приложения low-code платформы через ИИ
  2. Установка
  3. Инструменты (9)
  4. Skills (Claude Code)
  5. Примеры
  6. Транспорт
  7. Аутентификация
  8. Разработка
  9. Лицензия

MCP-сервер для ELMA365 — BPM-задачи и приложения low-code платформы через ИИ

Если вы искали, как подключить ELMA365 к нейросети, запускать бизнес-процессы и закрывать BPM-задачи не заходя в веб-интерфейс — это оно. 9 инструментов: элементы приложений, задачи, процессы, пользователи, комментарии. Спрашиваете «мои задачи на сегодня» — получаете список и закрываете их прямо в чате.

Часть серии WWmcp (46 серверов) 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 HTTPnpx @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

Часть WWmcp · Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/elma365-mcp؟

MCP server for ELMA365 API — app items, BPM tasks. 3 tools.

كيف أثبّت io.github.theYahia/elma365-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add elma365-mcp -e 'ELMA365_DOMAIN=<your elma365_domain>' -- npx -y @theyahia/elma365-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/elma365-mcp إلى مفتاح API؟

نعم. يتطلب ELMA365_DOMAIN، وتضبطها في إعداداته.

هل io.github.theYahia/elma365-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/elma365-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.