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)

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)

Contatti (Kontakte)

Attività e note (Aktivitäten und Notizen)

Utilità (Dienstprogramme)

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