Skip to main content
Glama

Volkern MCP Server v1.2.0

Servidor MCP (Model Context Protocol) para integrar Volkern CRM con agentes de IA como Claude, GPT, y otros clientes compatibles con MCP.

Novedades v1.2.0

  • Contactos y Empresas: CRUD completo para gestión de contactos de negocios y empresas

  • Pipeline de Ventas (Deals): Crear, actualizar y mover oportunidades entre etapas

  • Pronóstico de Ventas: Acceso a analíticas y predicciones del pipeline

  • Cotizaciones: Crear, editar y enviar propuestas de precios a clientes

  • Contratos: Generar contratos desde cotizaciones o manualmente, con soporte de firma digital

Instalación

Opción 1: Instalación global desde NPM (Recomendado)

npm install -g volkern-mcp-server

Opción 2: Usando npx (sin instalación)

npx volkern-mcp-server

Opción 3: Desde código fuente

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

Configuración

El servidor requiere las siguientes variables de entorno:

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

Uso con Claude Desktop

Agrega la siguiente configuración a tu archivo claude_desktop_config.json:

Si instalaste con NPM (Recomendado)

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

Si usas npx

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

Si instalaste desde código fuente

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"
      }
    }
  }
}

Herramientas Disponibles

Gestión de Leads

Herramienta

Descripción

volkern_list_leads

Listar leads con filtros opcionales

volkern_get_lead

Obtener detalles de un lead por ID

volkern_create_lead

Crear un nuevo lead

volkern_update_lead

Actualizar un lead existente

Citas/Appointments

Herramienta

Descripción

volkern_check_disponibilidad

Consultar horarios disponibles

volkern_list_citas

Listar citas con filtros

volkern_create_cita

Crear una nueva cita

volkern_update_cita

Actualizar una cita

volkern_cita_accion

Confirmar, cancelar o reprogramar

Servicios

Herramienta

Descripción

volkern_list_servicios

Listar servicios del catálogo

volkern_get_servicio

Obtener detalles de un servicio

Tareas

Herramienta

Descripción

volkern_create_task

Crear tarea de seguimiento

volkern_list_tasks

Listar tareas de un lead

volkern_complete_task

Marcar tarea como completada

Mensajería

Herramienta

Descripción

volkern_send_whatsapp

Enviar mensaje de WhatsApp

volkern_list_conversaciones

Listar conversaciones

Interacciones

Herramienta

Descripción

volkern_list_interactions

Listar interacciones de un lead

volkern_create_interaction

Registrar llamada, email, reunión

Notas

Herramienta

Descripción

volkern_list_notes

Listar notas de un lead

volkern_create_note

Agregar nota a un lead

Ejemplos de Uso

Crear un lead y agendar cita

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")

Consultar disponibilidad

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

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

Crear tarea de seguimiento

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")

Desarrollo

# Ejecutar en modo desarrollo
npm run dev

# Compilar
npm run build

# Ejecutar compilado
npm start

Troubleshooting

Error: VOLKERN_API_KEY not set

Asegúrate de configurar la variable de entorno antes de iniciar el servidor.

Error 401: No autorizado

Verifica que tu API key tenga los permisos necesarios en Volkern (Configuración → API Keys).

Error 409: Conflicto de horario

El slot solicitado ya está ocupado. Consulta disponibilidad con volkern_check_disponibilidad.

Licencia

MIT

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Resources

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DeXpertmx/mcp-volkern'

If you have feedback or need assistance with the MCP directory API, please join our Discord server