convez.ai
MCP ServerIntegração & APIsIntermediário
Castaldo-Solutions

MCP VTENext CRM

Castaldo-Solutions/mcp-vtenext

Integre VTENext CRM ao Claude com acesso completo à API WebService

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a API WebService do VTENext CRM como ferramentas para Claude e outros clientes MCP. Permite listar, buscar, criar e atualizar oportunidades, contatos e atividades diretamente via IA, com suporte a modo somente-leitura para bots seguros.

Instalação

$npx convez-ai Castaldo-Solutions/mcp-vtenext

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 2 dias
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Automatizar gestão de oportunidades e contatos via IA
  • Consultar dados de CRM em assistentes Claude sem código manual
  • Criar fluxos de vendas automatizados com proteção de escrita
  • Executar queries VTQL complexas via linguagem natural

Veredito

Integração bem-estruturada entre VTENext e Claude via MCP com suporte robusto a autenticação, modo read-only para segurança de bots e cobertura ampla de operações CRM. Recomendado para equipes que usam VTENext e querem automação IA nativa.

README

A tradução para o português deste README ainda está na fila.

mcp-vtenext

MCP server for VTENext CRM — exposes the WebService API as tools for Claude and other MCP-compatible clients.

Requirements

  • Node.js 18+
  • A running VTENext instance (self-hosted or Docker — see ../docker)

Setup

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

Edit .env:

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

The access key is in VTENext under Admin → Users → [user] → Access Key.

Read-only mode

Set READ_ONLY=true to prevent any write operation on VTENext. When enabled, the tools create_opportunita, update_opportunita and add_nota_opportunita return an error instead of writing data.

This is useful when the server is used by AI bots or automated agents that should only read CRM data. To run a read-only instance alongside a full-access one, pass the variable via the MCP config:

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

Claude Code integration

Add to .mcp.json in your project root:

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

Tools

Opportunità (Potentials)

ToolDescription
list_opportunitaList opportunities with optional filters (status, search, limit)
get_opportunitaGet full details of an opportunity by ID
search_opportunitaSearch opportunities by name
create_opportunitaCreate a new opportunity (write — blocked in read-only mode)
update_opportunitaUpdate status, amount or notes on an existing opportunity (write — blocked in read-only mode)

Contatti (Contacts)

ToolDescription
search_contattiSearch contacts by name, email or company

Attività e note

ToolDescription
add_nota_opportunitaAdd a comment/note to an opportunity (write — blocked in read-only mode)
list_attivita_opportunitaList activities linked to an opportunity

Utilità

ToolDescription
describe_moduloShow available fields for any VTENext module
query_rawRun a raw VTQL SELECT query

Authentication

VTENext uses the vtiger WebService protocol:

  1. GET /webservice.php?operation=getchallenge → token
  2. MD5(token + accessKey) → hashed key
  3. POST /webservice.php with operation=login (form-encoded) → sessionName

Sessions are cached for 4 minutes (token lifetime is 5 minutes).

Tests

# Unit tests (no VTENext required)
npm test

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

License

MIT

Ver o original no GitHub

Bom para

Relacionados