Skip to main content
Glama

mcp-vtenext

Servidor MCP para VTENext CRM: expone la API WebService como herramientas para Claude y otros clientes compatibles con MCP.

Requisitos

  • Node.js 18+

  • Una instancia de VTENext en ejecución (autoalojada o Docker; ver ../docker)

Related MCP server: nimble-crm-mcp

Configuración

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

Edita .env:

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

La clave de acceso se encuentra en VTENext en Admin → Usuarios → [usuario] → Clave de acceso.

Modo de solo lectura

Establece READ_ONLY=true para evitar cualquier operación de escritura en VTENext. Cuando está habilitado, las herramientas create_opportunita, update_opportunita y add_nota_opportunita devuelven un error en lugar de escribir datos.

Esto es útil cuando el servidor es utilizado por bots de IA o agentes automatizados que solo deben leer datos del CRM. Para ejecutar una instancia de solo lectura junto a una de acceso completo, pasa la variable a través de la configuración de 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"
      }
    }
  }
}

Integración con Claude Code

Añade a .mcp.json en la raíz de tu proyecto:

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

Herramientas

Opportunità (Potenciales)

Herramienta

Descripción

list_opportunita

Lista oportunidades con filtros opcionales (estado, búsqueda, límite)

get_opportunita

Obtiene los detalles completos de una oportunidad por ID

search_opportunita

Busca oportunidades por nombre

create_opportunita

Crea una nueva oportunidad (escritura: bloqueada en modo de solo lectura)

update_opportunita

Actualiza el estado, importe o notas de una oportunidad existente (escritura: bloqueada en modo de solo lectura)

Contatti (Contactos)

Herramienta

Descripción

search_contatti

Busca contactos por nombre, correo electrónico o empresa

Attività e note (Actividades y notas)

Herramienta

Descripción

add_nota_opportunita

Añade un comentario/nota a una oportunidad (escritura: bloqueada en modo de solo lectura)

list_attivita_opportunita

Lista las actividades vinculadas a una oportunidad

Utilità (Utilidades)

Herramienta

Descripción

describe_modulo

Muestra los campos disponibles para cualquier módulo de VTENext

query_raw

Ejecuta una consulta SELECT VTQL sin procesar

Autenticación

VTENext utiliza el protocolo WebService de vtiger:

  1. GET /webservice.php?operation=getchallenge → token

  2. MD5(token + accessKey) → clave hash

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

Las sesiones se almacenan en caché durante 4 minutos (la vida útil del token es de 5 minutos).

Pruebas

# Unit tests (no VTENext required)
npm test

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

Licencia

MIT

Available Tools

10 tools
add_nota_opportunitaC

Aggiunge una nota/commento a un'opportunità

Inputs: opportunita_id (required), testo (required).

create_opportunitaC

Crea una nuova opportunità in VTENext

Inputs: nome (required), stato, importo, data_chiusura, +1 more.

describe_moduloC

Mostra i campi disponibili per un modulo VTENext

Inputs: modulo (required).

get_opportunitaC

Recupera i dettagli completi di un'opportunità tramite ID

Inputs: id (required).

list_attivita_opportunitaC

Elenca le attività associate a un'opportunità

Inputs: opportunita_id (required), limit.

list_opportunitaC

Elenca le opportunità con filtri opzionali

Inputs: limit, stato, search.

query_rawC

Esegue una query VTQL grezza su VTENext (solo lettura)

Inputs: query (required).

search_contattiC

Cerca contatti per nome, email o azienda

Inputs: q (required), limit.

search_opportunitaC

Cerca opportunità per nome

Inputs: q (required), limit.

update_opportunitaC

Aggiorna i dati di un'opportunità esistente

Inputs: id (required), stato, importo, descrizione.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity. For example, list_opportunita retrieves multiple records with filters, get_opportunita fetches a single record by ID, and search_opportunita finds records by name. The tools target different resources (opportunità, contatti, modulo) and actions (create, update, list, search, describe, query).

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case. Verbs like add, create, describe, get, list, query, search, and update are used predictably with corresponding nouns (e.g., add_nota_opportunita, create_opportunita, describe_modulo). There are no deviations in naming conventions.

    Tool Count5/5

    With 10 tools, the count is well-scoped for managing opportunities and related data in VTENext. Each tool serves a clear purpose, such as CRUD operations for opportunities, searching contacts, listing activities, and raw queries. No tool feels redundant or unnecessary for the server's domain.

    Completeness5/5

    The tool set provides complete coverage for the VTENext opportunity management domain. It includes full CRUD (create, get, update, list/search) for opportunities, plus related operations like adding notes, listing activities, searching contacts, describing modules, and raw queries. There are no obvious gaps, and agents can handle typical workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables users to manage CRM leads, opportunities, projects, tasks, and sales records within ERPNext directly through MCP-compatible clients. It supports global searches, timesheet entries, and access to dashboard KPIs using natural language.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Nimble CRM API, enabling management of contacts, deals, notes, tasks, and tags through natural language.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for vtiger CRM that enables AI agents to log timesheets and create/update records in any module via natural language.
      33 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that connects to a sales CRM database, enabling AI agents to search prospects, view pipeline status, manage follow-ups, and update records using natural language commands.
      5
      MIT