Skip to main content
Glama

mcp-vtenext

MCP-Server für VTENext CRM — stellt die WebService API als Tools für Claude und andere MCP-kompatible Clients bereit.

Anforderungen

  • Node.js 18+

  • Eine laufende VTENext-Instanz (selbst gehostet oder Docker — siehe ../docker)

Related MCP server: nimble-crm-mcp

Einrichtung

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

Bearbeiten Sie .env:

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

Den Zugriffsschlüssel (Access Key) finden Sie in VTENext unter Admin → Benutzer → [Benutzer] → Zugriffsschlüssel.

Schreibgeschützter Modus (Read-only)

Setzen Sie READ_ONLY=true, um jegliche Schreibvorgänge in VTENext zu verhindern. Wenn aktiviert, geben die Tools create_opportunita, update_opportunita und add_nota_opportunita einen Fehler zurück, anstatt Daten zu schreiben.

Dies ist nützlich, wenn der Server von KI-Bots oder automatisierten Agenten verwendet wird, die nur CRM-Daten lesen sollen. Um eine schreibgeschützte Instanz neben einer Instanz mit vollem Zugriff zu betreiben, übergeben Sie die Variable über die MCP-Konfiguration:

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

Fügen Sie dies zu .mcp.json in Ihrem Projektstammverzeichnis hinzu:

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

Tools

Opportunità (Verkaufschancen)

Tool

Beschreibung

list_opportunita

Verkaufschancen mit optionalen Filtern auflisten (Status, Suche, Limit)

get_opportunita

Vollständige Details einer Verkaufschance nach ID abrufen

search_opportunita

Verkaufschancen nach Name suchen

create_opportunita

Eine neue Verkaufschance erstellen (Schreibzugriff — im schreibgeschützten Modus blockiert)

update_opportunita

Status, Betrag oder Notizen einer bestehenden Verkaufschance aktualisieren (Schreibzugriff — im schreibgeschützten Modus blockiert)

Contatti (Kontakte)

Tool

Beschreibung

search_contatti

Kontakte nach Name, E-Mail oder Unternehmen suchen

Attività e note (Aktivitäten und Notizen)

Tool

Beschreibung

add_nota_opportunita

Einen Kommentar/eine Notiz zu einer Verkaufschance hinzufügen (Schreibzugriff — im schreibgeschützten Modus blockiert)

list_attivita_opportunita

Aktivitäten auflisten, die mit einer Verkaufschance verknüpft sind

Utilità (Dienstprogramme)

Tool

Beschreibung

describe_modulo

Verfügbare Felder für jedes VTENext-Modul anzeigen

query_raw

Eine rohe VTQL SELECT-Abfrage ausführen

Authentifizierung

VTENext verwendet das vtiger WebService-Protokoll:

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

  2. MD5(Token + AccessKey) → gehashter Schlüssel

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

Sitzungen werden für 4 Minuten zwischengespeichert (die Token-Lebensdauer beträgt 5 Minuten).

Tests

# Unit tests (no VTENext required)
npm test

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

Lizenz

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