Enables sending WhatsApp messages and managing conversations through the Volkern CRM platform.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Volkern MCP ServerCreate a lead for Alice Smith and check available times for a call on Friday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Volkern MCP Server
Servidor MCP (Model Context Protocol) para integrar Volkern CRM con agentes de IA como Claude, GPT, y otros clientes compatibles con MCP.
Instalación
Opción 1: Instalación global desde NPM (Recomendado)
npm install -g volkern-mcp-serverOpción 2: Usando npx (sin instalación)
npx volkern-mcp-serverOpción 3: Desde código fuente
git clone https://github.com/volkern/mcp-server.git
cd mcp-server
npm install
npm run buildConfiguració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 defectoUso 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 |
| Listar leads con filtros opcionales |
| Obtener detalles de un lead por ID |
| Crear un nuevo lead |
| Actualizar un lead existente |
Citas/Appointments
Herramienta | Descripción |
| Consultar horarios disponibles |
| Listar citas con filtros |
| Crear una nueva cita |
| Actualizar una cita |
| Confirmar, cancelar o reprogramar |
Servicios
Herramienta | Descripción |
| Listar servicios del catálogo |
| Obtener detalles de un servicio |
Tareas
Herramienta | Descripción |
| Crear tarea de seguimiento |
| Listar tareas de un lead |
| Marcar tarea como completada |
Mensajería
Herramienta | Descripción |
| Enviar mensaje de WhatsApp |
| Listar conversaciones |
Interacciones
Herramienta | Descripción |
| Listar interacciones de un lead |
| Registrar llamada, email, reunión |
Notas
Herramienta | Descripción |
| Listar notas de un lead |
| 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 startTroubleshooting
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