Quickbase MCP-Server

Ein TypeScript-basierter Model Context Protocol (MCP)-Server für Quickbase, der für die nahtlose Integration mit Claude Desktop und anderen KI-Assistenten entwickelt wurde.

📋 Hinweis zum Gemeinschaftsprojekt
Dies ist eine von der Community entwickelte Integration und kein offizielles Quickbase-Produkt. Sie nutzt zwar die öffentlichen APIs von Quickbase, wird aber nicht offiziell von Quickbase, Inc. unterstützt. Dieses Projekt wird „im Ist-Zustand“ bereitgestellt und von der Community gepflegt. Offizielle Quickbase-Produkte und Support finden Sie unter quickbase.com .

🚀 Schnellstart für Claude Desktop

Einzeilige Setup-Prüfung

curl -fsSL https://raw.githubusercontent.com/danielbushman/MCP-Quickbase/main/check_dependencies.sh | bash

Claude Desktop konfigurieren

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quickbase": {
      "command": "npx",
      "args": ["-y", "mcp-quickbase"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

Das war's! Starten Sie Claude Desktop neu und Sie können die Quickbase-Tools verwenden.

Related MCP server: crm-mcp

📦 Installationsoptionen

Option 1: NPM (empfohlen)

# Use directly with npx (no installation needed)
npx -y mcp-quickbase

# Or install globally
npm install -g mcp-quickbase

Option 2: Aus der Quelle

# Clone the repository
git clone https://github.com/danielbushman/MCP-Quickbase.git
cd MCP-Quickbase

# Install dependencies
npm install

# Build the project
npm run build

Verwenden Sie für die Quellinstallation diese Claude Desktop-Konfiguration:

{
  "mcpServers": {
    "quickbase": {
      "command": "node",
      "args": ["/path/to/MCP-Quickbase/dist/mcp-stdio-server.js"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

🔧 Konfiguration

Der Server kann ohne konfigurierte Umgebungsvariablen gestartet werden. Die Tools sind jedoch erst nach der korrekten Konfiguration funktionsfähig. Überprüfen Sie Ihre Konfiguration mit dem Tool check_configuration .

Erforderliche Umgebungsvariablen

• QUICKBASE_REALM_HOST – Ihr Quickbase-Realm (z. B. company.quickbase.com )

• QUICKBASE_USER_TOKEN – Ihr Quickbase-API-Token ( Holen Sie sich hier eines )

Optionale Umgebungsvariablen

• QUICKBASE_APP_ID – Standard-Anwendungs-ID

Optionale Einstellungen

• QUICKBASE_CACHE_ENABLED – Caching aktivieren ( true / false , Standard: true )

• QUICKBASE_CACHE_TTL – Cache-Dauer in Sekunden (Standard: 3600 )

• DEBUG - Debug-Protokollierung aktivieren ( true / false , Standard: false )

• LOG_LEVEL – Protokollierungsebene ( DEBUG / INFO / WARN / ERROR , Standard: INFO )

🛠️ Verfügbare Tools

Anschluss & Konfiguration

• check_configuration - Überprüfen Sie, ob die Quickbase-Konfiguration richtig eingerichtet ist

• test_connection – Testen Sie die Verbindung zu Quickbase

• configure_cache - Caching-Verhalten konfigurieren

Anwendungsmanagement

• create_app - Neue Quickbase-Anwendungen erstellen

• update_app - Vorhandene Anwendungen aktualisieren

• list_tables - Alle Tabellen in einer Anwendung auflisten

Tabellenoperationen

• create_table - Neue Tabellen erstellen

• update_table - Tabelleneigenschaften aktualisieren

• get_table_fields - Feldinformationen für eine Tabelle abrufen

Feldverwaltung

• create_field - Neue Felder in Tabellen erstellen

• update_field - Feldeigenschaften aktualisieren

Rekordvorgänge

• query_records - Datensätze abfragen mit Filterung und Sortierung

• create_record - Einzelne Datensätze erstellen

• update_record - Vorhandene Datensätze aktualisieren

• bulk_create_records - Mehrere Datensätze erstellen

• bulk_update_records - Mehrere Datensätze aktualisieren

Dateioperationen

• upload_file - Dateien in Dateianhangfelder hochladen

• download_file - Dateien aus Datensätzen herunterladen

Berichterstattung

• run_report - Quickbase-Berichte ausführen

📚 Anwendungsbeispiele

Grundlegende Datensatzabfrage

Query all customers from the Customers table

Erstellen eines neuen Datensatzes

Create a new customer record with name "Acme Corp" and status "Active"

Eine Datei hochladen

Upload invoice.pdf to the Documents field in record 123

🔒 Sicherheit

• API-Token werden sicher behandelt und niemals protokolliert

• Alle Dateivorgänge werden in einer Sandbox auf das Arbeitsverzeichnis verschoben.

• Unterstützt Berechtigungen und Zugriffskontrollen auf Feldebene

📋 Voraussetzungen

• Node.js 18 oder höher

• Gültiges Quickbase-Konto mit API-Zugriff

• Claude Desktop (für MCP-Integration)

🤝 Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

🔗 Links

• Quickbase API-Dokumentation

• Modellkontextprotokoll

• Claude Desktop