mcp-vtenext
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 .envEdita .env:
VTENEXT_URL=http://your-vtenext-instance
VTENEXT_USERNAME=admin
VTENEXT_ACCESS_KEY=your_access_key
READ_ONLY=falseLa 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 |
| Lista oportunidades con filtros opcionales (estado, búsqueda, límite) |
| Obtiene los detalles completos de una oportunidad por ID |
| Busca oportunidades por nombre |
| Crea una nueva oportunidad (escritura: bloqueada en modo de solo lectura) |
| Actualiza el estado, importe o notas de una oportunidad existente (escritura: bloqueada en modo de solo lectura) |
Contatti (Contactos)
Herramienta | Descripción |
| Busca contactos por nombre, correo electrónico o empresa |
Attività e note (Actividades y notas)
Herramienta | Descripción |
| Añade un comentario/nota a una oportunidad (escritura: bloqueada en modo de solo lectura) |
| Lista las actividades vinculadas a una oportunidad |
Utilità (Utilidades)
Herramienta | Descripción |
| Muestra los campos disponibles para cualquier módulo de VTENext |
| Ejecuta una consulta SELECT VTQL sin procesar |
Autenticación
VTENext utiliza el protocolo WebService de vtiger:
GET /webservice.php?operation=getchallenge→ tokenMD5(token + accessKey) → clave hash
POST /webservice.phpconoperation=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:integrationLicencia
MIT
Available Tools
10 toolsadd_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
Scored across 10 tools
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).
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.
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.
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
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Vtiger MCP server for ChatGPT, Claude and any AI agent: list contacts, convert contact to deal, list deals, update deal stage, list cases, create case, update case and create contact in your own Vtiger account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Vtiger yourself; Cotlet does not store your password and you need no Vtiger API key. About the official Vtiger API: Yes, Vtiger has a REST API, but its limits table lists 0 requests for One Pilot and 24,000 a day (30 a minute) for One Growth, and Vtiger has no official MCP server (checked 22 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/vtiger-api-mcp-server
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for Getfly CRM — customers, opportunities, orders, tickets and tasks.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Nimble CRM API, enabling management of contacts, deals, notes, tasks, and tags through natural language.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for vtiger CRM that enables AI agents to log timesheets and create/update records in any module via natural language.33 npm1MIT
- AlicenseAqualityDmaintenanceMCP 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.5MIT