Сервер Quickbase MCP

Сервер Model Context Protocol (MCP) на базе TypeScript для Quickbase, разработанный для бесшовной интеграции с Claude Desktop и другими помощниками на основе искусственного интеллекта.

📋 Уведомление о проекте сообщества
Это интеграция, разработанная сообществом, которая не является официальным продуктом Quickbase. Хотя она использует публичные API Quickbase, она официально не поддерживается Quickbase, Inc. Этот проект предоставляется «как есть» и поддерживается сообществом. Для получения официальных продуктов Quickbase и поддержки посетите quickbase.com .

🚀 Быстрый старт для Claude Desktop

Проверка настройки в одну линию

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

Настроить рабочий стол Клода

Добавьте это в файл конфигурации 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: НПМ (рекомендуется)

# 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 для проверки вашей настройки.

Требуемые переменные среды

• QUICKBASE_REALM_HOST — ваша область Quickbase (например, company.quickbase.com )

• QUICKBASE_USER_TOKEN — ваш токен API Quickbase ( получить его здесь )

Необязательные переменные среды

• QUICKBASE_APP_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 или выше

• Действующая учетная запись Quickbase с доступом к API

• Claude Desktop (для интеграции MCP)

🤝 Вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

📄 Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

🔗 Ссылки

• Документация API Quickbase

• Модель контекстного протокола

• Клод Десктоп