Quickbase

🚀 Quickbase MCP コネクタ

Quickbase MCP コネクタは、AI アシスタント（Claude など）を Quickbase の JSON RESTful API と統合するための非公式のクイックスタートガイドです。このプロジェクトは Quickbase 公式のサポートを受けておらず、利用に際しては慎重に操作し、自己責任で行ってください。

🚀 クイックスタート

Claude Desktop を使用する場合

1. MCP サーバーを設定します：

   export MCP_SERVER_PORT=3535
   node src/quickbase/server.js
   

2. ターミナルで以下を実行します：

   mcp-client -p 3535 --action list-apps
   

Claude Code を使用する場合

import {MCPClient} from 'quickbase-mcp';
const client = new MCPClient({
  realm: 'your-realm',
  token: 'your-token'
});
await client.listApps();

✨ 主な機能

ユーザー機能

• データ管理：CRUD 操作（作成、読み取り、更新、削除）をサポートします。
• ファイル処理：ファイルのアップロードとダウンロード機能を提供します。
• レポート実行：Quickbase の事前定義されたレポートを実行できます。

開発者機能

• API カバレッジ：Quickbase の主要な API インターフェースを全面的にカバーしており、データ操作、ファイル管理、レポート実行などが含まれます。
• エラー処理：詳細なエラー分類と診断情報を提供し、開発者が問題を迅速に特定できるようにします。
• パラメータ検証：入力の合法性と有効性を保証します。

📦 インストール

リポジトリをクローンする

git clone https://github.com/your-repository.git
cd your-repository

セットアップスクリプトを実行する

python setup.py

環境変数を設定する

プロジェクトのルートディレクトリに env_config ファイルを作成し、以下の内容を記述します。

QUICKBASE_REALM_HOST=your-realm.quickbase.com
QUICKBASE_USER_TOKEN=your_user_token_here
QUICKBASE_APP_ID=your_app_id_here

📚 ドキュメント

概要

Quickbase MCP コネクタは、モデルコンテキストプロトコル（MCP）を通じて Quickbase のデータとやり取りすることを目的としています。このコネクタは以下の機能をサポートしています。

• データ管理：作成、読み取り、更新、削除操作を含みます。
• ファイル処理：ファイルのアップロードとダウンロード、および添付ファイルの高度な管理をサポートします。
• レポート実行：事前定義された Quickbase レポートを実行できます。

また、このコネクタは大数集に対するサポートも提供しており、大量のデータがあるシナリオでも効率的に動作します。

ツールの種類

接続テスト

• test-connection：サーバーが正常に動作しているかを検証します。

データ操作

• list-apps：すべてのアプリを取得します。
• get-app-details：指定されたアプリの詳細情報を取得します。
• query-data：データクエリを実行します。

ファイル操作

• upload-file：指定されたレコードフィールドにファイルをアップロードします。
• download-file：指定されたレコードフィールドからファイルをダウンロードします。

レポート実行

• run-report：事前定義されたレポートを実行し、結果を取得します。

未実装の機能

現在、以下の機能は未実装です。

• 削除操作：アプリ、フォーム、フィールド、レコードなどの削除を含みます。
• ユーザー管理：ユーザー情報や権限の取得または変更ができません。
• フォーム管理：フォームに関連する操作をサポートしていません。
• ダッシュボード管理：ダッシュボードを管理できません。
• データフロー管理：パイプライン操作をサポートしていません。

開発者ガイド

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

node src/quickbase/server.js

テストを実行する

すべてのテストは tests/ ディレクトリにあります。

python tests/run_tests.py

エラー処理

一般的なエラー

• 認証失敗：トークンが正しいかを確認してください。
• 権限不足：ユーザーがターゲットリソースにアクセスするのに十分な権限を持っていることを確認してください。

詳細ログ

すべての操作は詳細なログに記録され、問題のトラブルシューティングが容易になります。

声明

このプロジェクトは個人またはコミュニティの開発目的のみで作成されており、安定性や互換性は保証されていません。使用する前に関連するドキュメントや条項をよく読んでください。

前提条件

Quickbase MCP コネクタを使用するには、以下の環境が必要です。

• Python 3.6+ および Node.js 14+
• 有効な Quickbase 資格情報を提供する必要があり、以下が含まれます。
  • QUICKBASE_REALM_HOST：あなたの Quickbase インスタンスのアドレス。
  • QUICKBASE_USER_TOKEN：認証に使用するユーザートークン。
  • QUICKBASE_APP_ID：ターゲットアプリの一意の識別子。

まとめ

Quickbase MCP コネクタは、Quickbase のデータとやり取りするための強力なツールセットを提供します。開発者でもデータ管理者でも、このコネクタを通じて効率的にデータを管理および分析することができます。