remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Requires Node.js 14 or higher as a prerequisite for running the MCP server that connects to the Quickbase API.

クイックベース MCP コネクタ

Quickbase JSON RESTful APIと統合するためのモデルコンテキストプロトコル (MCP)コネクタ。

免責事項：これは非公式の独立プロジェクトであり、Quickbase, Inc. との提携、後援、または承認を受けていません。このコネクタは「現状有姿」で提供され、いかなる保証も付与されず、Quickbase によるサポートも受けません。このコネクタを使用する際は、適用されるすべての法律、規制、およびセキュリティ要件を遵守する責任はユーザーにあります。

概要

このコネクタは、モデルコンテキストプロトコル（MCP）を使用して、ClaudeのようなAIアシスタントがQuickbaseのAPIと連携できるようにします。Quickbaseでアプリ、テーブル、フィールド、レコード、ファイル、レポートを管理するための幅広い操作をサポートします。

特徴

ユーザー向け

AI搭載のクイックベースアクセス：クロードを通じてクイックベースデータに直接アクセス
データ管理:自然言語でアプリ、テーブル、レコードを作成、表示、更新します
ファイル処理: 記録への添付ファイルのアップロードとダウンロード
レポートアクセス: Quickbaseレポートを実行し、チャットで直接結果を取得します
大規模データセットのサポート: 大量のレコードをクエリするときにページ区切りを自動的に処理します

開発者向け

包括的なAPIカバレッジ：コアQuickbase API機能へのアクセス
構造化された応答: 信頼性の高い解析のための一貫した応答フォーマット
バッチ操作: 一括レコード操作の効率的な処理
エラー診断: ステータスコードとトラブルシューティング情報を含む詳細なエラーメッセージ

前提条件

Python 3.8以上
Node.js 14以上
Quickbase API 資格情報 (レルムホスト名、ユーザートークン、アプリ ID)

インストール

リポジトリをクローンします。

git clone https://github.com/danielbushman/Quickbase-MCP-connector.git
cd Quickbase-MCP-connector

環境を設定します。

./setup.sh

Quickbase の資格情報を設定します。

cp .env.example .env
# Edit .env with your credentials

クイックスタート

Claude または Claude Code でこのコネクタを試してみたい方:

依存関係をインストールしてサーバーをセットアップします。

# Run the setup script to install all dependencies
./setup.sh

# Create a .env file with your Quickbase credentials
echo "QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here" > .env

Claude Desktop と併用する (推奨):

Claude Desktop 用の設定ファイルを作成し、サーバーを自動的に起動します。設定ファイルの場所は、オペレーティングシステムによって異なります。

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

次の構成を追加します。

{
  "mcpServers": {
    "quickbase": {
      "command": "/path/to/node",
      "args": [
        "/path/to/Quickbase-MCP-connector/src/quickbase/server.js"
      ],
      "env": {
        "QUICKBASE_REALM": "your-realm",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

Claude Code で使用する場合:

# This single command both registers and starts the MCP server
claude mcp add quickbase node src/quickbase/server.js

Claude セッションで Quickbase ツールを使用できるようになりました。プロンプトの例:「Quickbase コネクタを使用して、Quickbase アプリ内のすべてのテーブルを一覧表示します。」

利用可能なツールカテゴリ

接続ツール

test_connection : Quickbase API接続を確認する
check_auth : 認証ステータスと権限を確認する

アプリツール

get_app : 特定のアプリの詳細を取得する
get_apps : 利用可能なすべてのアプリを一覧表示する
create_app 、 update_app : アプリケーションの作成と更新

テーブルツール

get_table 、 get_tables : テーブル情報を取得する
create_table 、 update_table : テーブルの作成と更新

フィールドツール

get_field 、 get_fields : フィールド情報を取得する
create_field 、 update_field : フィールドの作成と更新

記録ツール

get_record 、 query_records : レコードデータを取得する
create_record 、 update_record : 個々のレコード操作
bulk_create_records 、 bulk_update_records ：効率的なバッチ操作

ファイルツール

upload_file : レコードフィールドにファイルをアップロードする
download_file : レコードフィールドからファイルをダウンロードする
manage_attachments : 高レベルの添付ファイル管理

レポートツール

run_report : Quickbaseレポートを実行する

実装されていません

以下の操作は実装されていません。

削除操作 (delete_app、delete_table、delete_field、delete_record、bulk_delete_records、delete_file)
ユーザー操作 (get_user、get_current_user、get_user_roles、manage_users)
フォーム操作（manage_forms）
ダッシュボードの操作 (manage_dashboards)
パイプライン操作 (manage_pipelines)
FastField フォーム操作 (manage_fast_field_form)

開発者と貢献者向け

MCP サーバーを手動で起動する

サーバーを手動で起動する必要がある場合（開発またはデバッグ用）：

node src/quickbase/server.js

テストの実行

このセクションは主に、変更を検証したり、テストスイートを実行したりしたい貢献者を対象としています。

すべてのテストはtests/ディレクトリにあります。テストランナーを使用して、特定のテストまたはすべてのテストを実行できます。

# Run all tests
python tests/run_tests.py --all

# Run specific tests
python tests/run_tests.py connection pagination file

# Run the comprehensive validation script
python tests/run_tests.py validate

個々のテストスクリプトを直接実行することもできます。

# Test connection
python tests/test_connection.py

# Test file operations
python tests/test_file_operations.py

# Test pagination
python tests/test_pagination.py

テストの詳細については、 tests/README.md を参照してください。

環境変数

次の環境変数を設定する必要がある場合があります。

# Quickbase API Credentials
QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here

# For file operation testing
QUICKBASE_TABLE_ID=your_table_id_here
QUICKBASE_RECORD_ID=your_record_id_here
QUICKBASE_FILE_FIELD_ID=your_file_field_id_here

# MCP Server Settings (optional)
MCP_SERVER_PORT=3535

エラー処理

コネクタは、次のような包括的なエラー処理を提供します。

エラータイプの分類
HTTPステータスコード
Quickbase API からの詳細なエラーメッセージ
提案された解決策
パラメータ検証
JSONデータの検証
APIリクエストエラーの適切な処理

よくあるエラーのシナリオ

必要なパラメータが不足しています
無効なJSONデータ形式
存在しないテーブルまたはフィールドID
無効なWHERE句の構文
認証失敗
権限の問題
ネットワーク接続の問題

すべてのエラー応答には、トラブルシューティングに役立つ診断情報が含まれています。

貢献

リポジトリをフォークする
機能ブランチを作成する
変更をコミットする
ブランチにプッシュする
プルリクエストを作成する

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude やその他の MCP クライアントを通じて Quickbase の JSON RESTful API と対話するための標準化されたインターフェースを提供し、レコードのクエリ、テーブル関係の管理、ファイル添付の処理などの操作をサポートします。

Quickbase MCP Server