mcp-vtenext

MCP-сервер для VTENext CRM — предоставляет WebService API в качестве инструментов для Claude и других MCP-совместимых клиентов.

Требования

• Node.js 18+

• Запущенный экземпляр VTENext (самостоятельно развернутый или через Docker — см. ../docker)

Настройка

cd mcp/vtenext/server
npm install
cp .env.example .env

Отредактируйте файл .env:

VTENEXT_URL=http://your-vtenext-instance
VTENEXT_USERNAME=admin
VTENEXT_ACCESS_KEY=your_access_key
READ_ONLY=false

Ключ доступа (Access Key) находится в VTENext в разделе Admin → Users → [пользователь] → Access Key.

Режим «только чтение»

Установите READ_ONLY=true, чтобы предотвратить любые операции записи в VTENext. Если этот режим включен, инструменты create_opportunita, update_opportunita и add_nota_opportunita будут возвращать ошибку вместо записи данных.

Это полезно, когда сервер используется ИИ-ботами или автоматизированными агентами, которым разрешено только чтение данных CRM. Чтобы запустить экземпляр в режиме «только чтение» параллельно с полнофункциональным, передайте переменную через конфигурацию MCP:

{
  "mcpServers": {
    "vtenext-bot": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp/vtenext/server/index.js"],
      "env": {
        "VTENEXT_URL": "http://your-vtenext-instance",
        "VTENEXT_USERNAME": "admin",
        "VTENEXT_ACCESS_KEY": "your_access_key",
        "READ_ONLY": "true"
      }
    }
  }
}

Интеграция с Claude Code

Добавьте в файл .mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "vtenext": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp/vtenext/server/index.js"]
    }
  }
}

Инструменты

Opportunità (Сделки)

Contatti (Контакты)

Attività e note (Действия и заметки)

Utilità (Утилиты)

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

VTENext использует протокол vtiger WebService:

1. GET /webservice.php?operation=getchallenge → токен

2. MD5(токен + accessKey) → хешированный ключ

3. POST /webservice.php с operation=login (form-encoded) → sessionName

Сессии кэшируются на 4 минуты (время жизни токена составляет 5 минут).

Тесты

# Unit tests (no VTENext required)
npm test

# Integration tests (requires live VTENext at VTENEXT_URL)
npm run test:integration

Лицензия

MIT