Volkern MCP Server (v2.0.0)

Сервер MCP (Model Context Protocol) для интеграции Volkern CRM с ИИ-агентами, такими как Claude, GPT и другими клиентами, совместимыми с MCP.

Новое в v2.0.0 - Полный коммерческий цикл

Новые модули

• Контакты: Полный CRUD контактов (физические и юридические лица)

• Сделки/Воронка: Создание и просмотр сделок в воронке продаж

• Коммерческие предложения: Создание предложений на основе позиций каталога с учетом цен, скидок и налогов

• Заказы на продажу: Просмотр, запрос и преобразование предложений в заказы на продажу

• Контракты: Преобразование принятых предложений в контракты с условиями оплаты

Полный коммерческий поток через MCP

1. volkern_create_lead → Захват лида

2. volkern_create_deal → Открытие возможности в воронке

3. volkern_create_cotizacion → Генерация предложения из каталога

4. volkern_create_orden_from_cotizacion → Преобразование в заказ на продажу

5. volkern_create_contrato_from_cotizacion → Оформление контракта

Улучшенный каталог (v1.1.0)

• Пользовательские поля: Динамические атрибуты для каждой позиции (м², количество комнат, язык и т.д.)

• Многоуровневые категории: Иерархическая организация (Недвижимость > Офис > Люкс)

• Метки: Теги для быстрой фильтрации (vip, возможность, новый)

• Мультимедийная галерея: Изображения, видео-туры, техническая документация, 360° туры

• Гибкое ценообразование: Разовые, периодические или почасовые платежи со скидками за объем

Related MCP server: Customer Support MCP Server

Установка

Вариант 1: Глобальная установка через NPM (Рекомендуется)

npm install -g volkern-mcp-server

Вариант 2: Использование npx (без установки)

npx volkern-mcp-server

Вариант 3: Из исходного кода

git clone https://github.com/volkern/mcp-server.git
cd mcp-server
npm install
npm run build

Настройка

Сервер требует следующие переменные окружения:

export VOLKERN_API_KEY="tu_api_key_aqui"
export VOLKERN_API_URL="https://volkern.app/api"  # Opcional, usa este valor por defecto

Использование с Claude Desktop

Добавьте следующую конфигурацию в ваш файл claude_desktop_config.json:

Если вы установили через NPM (Рекомендуется)

{
  "mcpServers": {
    "volkern": {
      "command": "volkern-mcp",
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Если вы используете npx

{
  "mcpServers": {
    "volkern": {
      "command": "npx",
      "args": ["volkern-mcp-server"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Если вы установили из исходного кода

macOS/Linux:

{
  "mcpServers": {
    "volkern": {
      "command": "node",
      "args": ["/ruta/a/volkern-mcp-server/dist/index.js"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "volkern": {
      "command": "node",
      "args": ["C:\\ruta\\a\\volkern-mcp-server\\dist\\index.js"],
      "env": {
        "VOLKERN_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

Доступные инструменты (35 инструментов)

Контакты

Управление лидами

Встречи/Appointments

Услуги

Задачи

Обмен сообщениями

Взаимодействия

Заметки

Сделки / Воронка

Коммерческие предложения

Заказы на продажу

Контракты

Примеры использования

Создать лид и назначить встречу

Usuario: Crea un lead para Juan Pérez, email juan@example.com, y agenda una cita para mañana a las 10am

Agente:
1. volkern_create_lead(nombre: "Juan Pérez", email: "juan@example.com")
2. volkern_check_disponibilidad(fecha: "2026-02-09")
3. volkern_create_cita(leadId: "...", fechaHora: "2026-02-09T10:00:00Z", titulo: "Reunión inicial")

Проверить доступность

Usuario: ¿Qué horarios hay disponibles para el lunes?

Agente:
1. volkern_check_disponibilidad(fecha: "2026-02-10")

Создать задачу для отслеживания

Usuario: Crea un recordatorio para llamar a Juan mañana

Agente:
1. volkern_list_leads(search: "Juan")
2. volkern_create_task(leadId: "...", tipo: "llamada", titulo: "Llamar a Juan", fechaVencimiento: "2026-02-09T09:00:00Z")

Разработка

# Ejecutar en modo desarrollo
npm run dev

# Compilar
npm run build

# Ejecutar compilado
npm start

Устранение неполадок

Ошибка: VOLKERN_API_KEY not set

Убедитесь, что вы настроили переменную окружения перед запуском сервера.

Ошибка 401: Не авторизован

Проверьте, что ваш API-ключ имеет необходимые разрешения в Volkern (Настройки → API Keys).

Ошибка 409: Конфликт времени

Запрошенный слот уже занят. Проверьте доступность с помощью volkern_check_disponibilidad.

Лицензия

MIT