クイックベース MCP サーバー

Quickbase 用の TypeScript ベースの Model Context Protocol (MCP) サーバー。Claude Desktop やその他の AI アシスタントとのシームレスな統合を目的として設計されています。

📋 コミュニティプロジェクトのお知らせ
これはコミュニティによって開発された統合機能であり、Quickbaseの公式製品ではありません。Quickbaseの公開APIを使用していますが、Quickbase, Inc.による公式サポートは受けていません。このプロジェクトは「現状有姿」で提供され、コミュニティによって維持されています。Quickbaseの公式製品とサポートについては、 quickbase.comをご覧ください。

🚀 Claude デスクトップのクイックスタート

ワンラインセットアップチェック

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

Claudeデスクトップの設定

Claude Desktop 構成ファイルに以下を追加します。

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"
      }
    }
  }
}

これで完了です。Claude Desktop を再起動すると、Quickbase ツールの使用を開始できます。

Related MCP server: crm-mcp

📦 インストールオプション

オプション 1: NPM (推奨)

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

# Or install globally
npm install -g mcp-quickbase

オプション2: ソースから

# 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

ソース インストールの場合は、次の Claude Desktop 構成を使用します。

{
  "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"
      }
    }
  }
}

🔧 構成

環境変数が設定されていなくてもサーバーcheck_configuration起動できますが、適切な設定が行われるまでツールは機能しません。check_configurationツールを使用して設定を確認してください。

必要な環境変数

• QUICKBASE_REALM_HOST - Quickbase レルム (例: company.quickbase.com )

• QUICKBASE_USER_TOKEN - Quickbase API トークン (こちらから取得)

オプションの環境変数

• QUICKBASE_APP_ID - デフォルトのアプリケーションID

オプション設定

• QUICKBASE_CACHE_ENABLED - キャッシュを有効にする ( true / false 、デフォルト: true )

• QUICKBASE_CACHE_TTL - キャッシュ期間（秒）（デフォルト： 3600 ）

• DEBUG - デバッグログを有効にする（ true / false 、デフォルト： false ）

• LOG_LEVEL - ログレベル（ DEBUG / INFO / WARN / ERROR 、デフォルト: INFO ）

🛠️ 利用可能なツール

接続と構成

• check_configuration - Quickbaseの設定が正しく設定されているか確認する

• test_connection - Quickbaseへの接続をテストする

• configure_cache - キャッシュ動作を設定する

アプリケーション管理

• create_app - 新しい Quickbase アプリケーションを作成する

• update_app - 既存のアプリケーションを更新する

• list_tables - アプリケーション内のすべてのテーブルを一覧表示する

テーブル操作

• create_table - 新しいテーブルを作成する

• update_table - テーブルのプロパティを更新する

• get_table_fields - テーブルのフィールド情報を取得する

フィールド管理

• create_field - テーブルに新しいフィールドを作成する

• update_field - フィールドのプロパティを更新する

レコード操作

• query_records - フィルタリングと並べ替えによるレコードのクエリ

• create_record - 単一のレコードを作成する

• update_record - 既存のレコードを更新する

• bulk_create_records - 複数のレコードを作成する

• bulk_update_records - 複数のレコードを更新する

ファイル操作

• upload_file - ファイル添付フィールドにファイルをアップロードする

• download_file - レコードからファイルをダウンロードする

報告

• run_report - Quickbaseレポートを実行する

📚 使用例

基本レコードクエリ

Query all customers from the Customers table

新しいレコードを作成する

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

ファイルをアップロードする

Upload invoice.pdf to the Documents field in record 123

🔒 セキュリティ

• APIトークンは安全に処理され、ログに記録されることはありません

• すべてのファイル操作は作業ディレクトリにサンドボックス化されます

• フィールドレベルの権限とアクセス制御をサポート

📋 要件

• Node.js 18以上

• APIアクセスが可能な有効なQuickbaseアカウント

• Claude Desktop（MCP統合用）

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🔗 リンク

• Quickbase API ドキュメント

• モデルコンテキストプロトコル

• クロードデスクトップ