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

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

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

Related MCP server: Database Tools for Claude AI

📦 Installationsoptionen

Option 1: NPM (empfohlen)

Option 2: Aus der Quelle

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

🔧 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

Erstellen eines neuen Datensatzes

Eine Datei hochladen

🔒 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