DVBase MCP Server

MCP Server für Digital Vereinfacht – gibt Claude direkten Zugriff auf das Ninox-Datenmodell der DVBase.

Was macht das?

Claude kann damit:

• Tabellen & Felder eurer Ninox-DB einsehen (Schema)
• Daten abfragen via Ninox-Script (select Rechnungen where Status = "Offen")
• Kontextwissen lesen (Prozessbeschreibungen, Stolperfallen, n8n-Abhängigkeiten)

Installation (auf eurem Server)

1. Dateien auf den Server kopieren

# Archiv hochladen (z.B. per scp)
scp dvbase-mcp-server.tar.gz user@euer-server:~/

# Auf dem Server entpacken
ssh user@euer-server
tar xzf dvbase-mcp-server.tar.gz
cd dvbase-mcp-server

2. Dependencies installieren

npm install

3. Konfiguration (.env)

cp .env.example .env
nano .env

Dann ausfüllen:

# Ninox API Key (Zahnrad → Integrationen → Generate)
NINOX_API_KEY=euer-key-hier

# Aus der Ninox-URL: https://app.ninox.com/#/teams/TEAM_ID/databases/DB_ID
NINOX_TEAM_ID=eure-team-id
NINOX_DATABASE_ID=eure-database-id

# Sicherheits-Token – generieren mit: openssl rand -hex 32
MCP_AUTH_TOKEN=euer-geheimer-token-hier

PORT=3001

4. Bauen & starten

npm run build
npm start

Testen ob's läuft:

curl http://localhost:3001/health
# → {"status":"ok","server":"dvbase-mcp","authEnabled":true, ...}

5. Mit nginx nach außen freigeben (für Claude.ai)

In eurer nginx-Konfig (z.B. /etc/nginx/sites-available/default):

location /mcp {
    proxy_pass http://localhost:3001/mcp;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_http_version 1.1;

    # Wichtig für SSE/Streaming:
    proxy_set_header Connection '';
    proxy_buffering off;
    proxy_cache off;
    chunked_transfer_encoding on;
}

sudo nginx -t && sudo systemctl reload nginx

6. Dauerhaft laufen lassen (pm2)

# pm2 installieren falls noch nicht vorhanden
npm install -g pm2

# Server als Daemon starten
pm2 start dist/index.js --name dvbase-mcp

# Autostart nach Reboot
pm2 save
pm2 startup

Verbindung herstellen

Claude.ai (Browser)

1. Gehe zu claude.ai → Settings → Integrations → MCP
2. Trage ein:
   • URL: https://eure-domain.de/mcp
   • Auth: Bearer Token → euer MCP_AUTH_TOKEN

Claude Desktop App

In ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dvbase": {
      "url": "http://localhost:3001/mcp",
      "headers": {
        "Authorization": "Bearer EUER_MCP_AUTH_TOKEN"
      }
    }
  }
}

Verfügbare Tools

Tool	Beschreibung
list_modules	Zeigt alle Tabellen der DVBase
get_schema	Felder, Typen, Optionen einer Tabelle
get_context	Entwickler-Kontextwissen (braucht Doku-Tabelle)
get_full_module_info	Schema + Kontext kombiniert
query_data	Ninox-Script Abfragen ausführen

Doku-Tabelle (optional)

Für get_context und get_full_module_info braucht ihr eine Tabelle in Ninox mit diesen Feldern:

Feld	Typ	Inhalt
Modul	Text	Modulname (z.B. "Bautagesbericht")
Prozessbeschreibung	Text	Wie das Modul funktioniert
Stolperfallen	Text	Bekannte Probleme & Gotchas
N8N_Abhaengigkeiten	Text	Welche n8n-Workflows damit interagieren
Kundenspezifisch	Text	Kundenspezifische Anpassungen
Tabellen_Mapping	Text	Zugehörige Tabellen-IDs, komma-getrennt (z.B. "A,B,C")

Die Table-ID dieser Tabelle kommt als DOKU_TABLE_ID in die .env.