Servidor MCP de Quickbase

Un servidor de Protocolo de contexto de modelo (MCP) basado en TypeScript para Quickbase, diseñado para una integración perfecta con Claude Desktop y otros asistentes de IA.

Aviso del proyecto comunitario
Esta es una integración desarrollada por la comunidad y no es un producto oficial de Quickbase. Si bien utiliza las API públicas de Quickbase, no cuenta con soporte oficial de Quickbase, Inc. Este proyecto se ofrece "tal cual" y es mantenido por la comunidad. Para obtener información sobre los productos y el soporte técnico oficiales de Quickbase, visite quickbase.com .

🚀 Inicio rápido para Claude Desktop

Comprobación de configuración de una línea

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

Configurar Claude Desktop

Agregue esto a su archivo de configuración de Claude Desktop:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas : %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"
      }
    }
  }
}

¡Listo! Reinicia Claude Desktop y podrás empezar a usar las herramientas de Quickbase.

Related MCP server: crm-mcp

📦 Opciones de instalación

Opción 1: NPM (Recomendado)

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

# Or install globally
npm install -g mcp-quickbase

Opción 2: Desde la fuente

# 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

Para la instalación de origen, utilice esta configuración de 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"
      }
    }
  }
}

🔧 Configuración

El servidor puede iniciarse sin variables de entorno configuradas, pero las herramientas no funcionarán hasta que se configure correctamente. Utilice la herramienta check_configuration para verificar la configuración.

Variables de entorno requeridas

• QUICKBASE_REALM_HOST : su dominio Quickbase (por ejemplo, company.quickbase.com )

• QUICKBASE_USER_TOKEN : su token de API de Quickbase ( obtenga uno aquí )

Variables de entorno opcionales

• QUICKBASE_APP_ID - ID de aplicación predeterminada

Configuraciones opcionales

• QUICKBASE_CACHE_ENABLED - Habilitar almacenamiento en caché ( true / false , valor predeterminado: true )

• QUICKBASE_CACHE_TTL : Duración de la caché en segundos (valor predeterminado: 3600 )

• DEBUG - Habilitar el registro de depuración ( true / false , valor predeterminado: false )

• LOG_LEVEL - Nivel de registro ( DEBUG / INFO / WARN / ERROR , predeterminado: INFO )

🛠️ Herramientas disponibles

Conexión y configuración

• check_configuration - Comprueba si la configuración de Quickbase está configurada correctamente

• test_connection - Prueba la conexión a Quickbase

• configure_cache - Configurar el comportamiento del almacenamiento en caché

Gestión de aplicaciones

• create_app - Crea nuevas aplicaciones Quickbase

• update_app - Actualizar aplicaciones existentes

• list_tables - Lista todas las tablas en una aplicación

Operaciones de tabla

• create_table - Crea nuevas tablas

• update_table - Actualizar las propiedades de la tabla

• get_table_fields - Obtener información de campo para una tabla

Gestión de campo

• create_field - Crea nuevos campos en tablas

• update_field - Actualizar propiedades de campo

Operaciones de registro

• query_records - Consultar registros con filtrado y ordenamiento

• create_record - Crea registros individuales

• update_record - Actualizar registros existentes

• bulk_create_records - Crea múltiples registros

• bulk_update_records - Actualizar varios registros

Operaciones con archivos

• upload_file - Subir archivos a los campos de adjuntos de archivos

• download_file - Descargar archivos de los registros

Informes

• run_report - Ejecutar informes de Quickbase

Ejemplos de uso

Consulta básica de registros

Query all customers from the Customers table

Crear un nuevo registro

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

Subir un archivo

Upload invoice.pdf to the Documents field in record 123

🔒 Seguridad

• Los tokens API se manejan de forma segura y nunca se registran

• Todas las operaciones de archivos se almacenan en el directorio de trabajo.

• Admite permisos a nivel de campo y controles de acceso

📋 Requisitos

• Node.js 18 o superior

• Cuenta Quickbase válida con acceso API

• Claude Desktop (para integración con MCP)

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🔗 Enlaces

• Documentación de la API de Quickbase

• Protocolo de contexto modelo

• Escritorio de Claude