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: ```bash 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.