Skip to main content
Glama
danielbushman

Quickbase MCP Server

クイックベース 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ファイルを参照してください。

🔗 リンク

Available Tools

1 tool
check_configurationC

Check if Quickbase configuration is properly set up

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It implies a read-only check but doesn't disclose behavioral traits like what happens if configuration is invalid, whether it requires authentication, or what the output indicates. This leaves significant gaps in understanding the tool's operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no wasted words, making it efficient and front-loaded. However, it could be more structured by including key details like output format or usage context, slightly reducing its completeness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (a configuration check with no parameters) and lack of annotations or output schema, the description is incomplete. It doesn't explain what 'properly set up' means, what the check entails, or what results to expect, leaving the agent with insufficient context for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and schema description coverage is 100%, so no parameter documentation is needed. The description doesn't add parameter details, which is appropriate, but it could have mentioned implicit inputs like environment settings. Baseline is 4 due to the lack of parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the tool's purpose as checking Quickbase configuration setup, which is clear but vague about what 'properly set up' entails. It uses a specific verb ('check') and resource ('Quickbase configuration'), but lacks detail on scope or criteria for proper setup, making it moderately informative.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool, such as before other operations or in troubleshooting scenarios. With no sibling tools, differentiation isn't needed, but the description doesn't offer any usage context or prerequisites, leaving it as a basic statement.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • Changedcheck_configuration1 field changed
      • removedInput schema / additionalProperties
        Removed value: -false
  2. 1 tool update
    • First observedcheck_configuration

TDQS

C2.9/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'check_configuration' has a single, clear purpose that cannot be confused with any other tool in the set.

Naming Consistency5/5

The tool name 'check_configuration' follows a consistent verb_noun pattern. Since there is only one tool, there is no inconsistency in naming conventions to evaluate.

Tool Count2/5

A single tool is too few for a server named 'Quickbase MCP Server', which implies broader functionality for interacting with Quickbase (e.g., CRUD operations on records, tables, or apps). This minimal set feels incomplete and under-scoped for the apparent domain.

Completeness1/5

The tool set is severely incomplete for a Quickbase integration server. It only provides a configuration check, lacking any operations to create, read, update, or delete data, manage tables or apps, or perform other core Quickbase workflows, leaving significant gaps that will cause agent failures.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    This read-only MCP Server allows you to connect to Quickbase data from Claude Desktop through CData JDBC Drivers. Free (beta) read/write servers available at https://www.cdata.com/solutions/mcp
    2
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Bridges Claude Code to the Rowan Rose CRM, translating MCP tool calls into REST API requests for contacts, cases, documents, and more.
    -
  • A
    license
    C
    quality
    D
    maintenance
    Provides complete QuickBooks Online API integration for Claude Code and other MCP-compatible clients, enabling full CRUD operations on 29 entity types and 11 financial reports.
    100
    Apache 2.0
  • A
    license
    B
    quality
    D
    maintenance
    Enables Claude to interact with FileMaker databases through the FileMaker Data API, supporting multi-database connections, CRUD operations, script execution, and metadata discovery.
    11
    11
    MIT