Quickbase MCP Server

Un servidor MCP para Quickbase, que permite una integración fluida con asistentes de IA como Claude Desktop.

GitHub
15
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Quickbase

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

📋 Aviso de Proyecto Comunitario
Esta es una integración desarrollada por la comunidad que no es un producto oficial de Quickbase. Aunque utiliza las APIs públicas de Quickbase, no cuenta con soporte oficial de Quickbase, Inc. Este proyecto se proporciona "tal cual" y es mantenido por la comunidad. Para productos y soporte oficiales de Quickbase, visite quickbase.com.

🚀 Inicio Rápido para Claude Desktop

Verificación de Configuración en 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
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"
      }
    }
  }
}

¡Eso es todo! Reinicie Claude Desktop y podrá comenzar a usar las herramientas de Quickbase.

📦 Opciones de Instalación

Opción 1: NPM (Recomendada)

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

# Or install globally
npm install -g mcp-quickbase

Opción 2: Desde el Código 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 desde el código fuente, use 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 proporcione una configuración adecuada. Use la herramienta check_configuration para verificar su configuración.

Variables de Entorno Requeridas

  • QUICKBASE_REALM_HOST - Su dominio de 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 predeterminado

Configuraciones Opcionales

  • QUICKBASE_CACHE_ENABLED - Habilitar caché (true/false, predeterminado: true)
  • QUICKBASE_CACHE_TTL - Duración de la caché en segundos (predeterminado: 3600)
  • DEBUG - Habilitar registro de depuración (true/false, predeterminado: false)
  • LOG_LEVEL - Nivel de registro (DEBUG/INFO/WARN/ERROR, predeterminado: INFO)

🛠️ Herramientas Disponibles (25)

Conexión y Configuración

  • check_configuration - Verificar si la configuración de Quickbase está correctamente establecida
  • test_connection - Probar la conexión con Quickbase
  • configure_cache - Configurar el comportamiento de la caché

Gestión de Aplicaciones

  • create_app - Crear nuevas aplicaciones de Quickbase
  • update_app - Actualizar aplicaciones existentes
  • list_tables - Listar todas las tablas en una aplicación

Operaciones de Tablas

  • create_table - Crear nuevas tablas
  • update_table - Actualizar propiedades de tablas
  • get_table_fields - Obtener información de campos para una tabla

Gestión de Campos

  • create_field - Crear nuevos campos en tablas
  • get_field - Obtener propiedades de un campo específico
  • update_field - Actualizar propiedades de campos
  • delete_field - Eliminar un campo de una tabla

Operaciones de Registros

  • query_records - Consultar registros con filtrado, ordenamiento y groupBy
  • create_record - Crear registros individuales
  • update_record - Actualizar registros existentes
  • bulk_create_records - Crear múltiples registros
  • bulk_update_records - Actualizar múltiples registros

Operaciones de Archivos

  • upload_file - Subir archivos a campos de adjuntos
  • download_file - Descargar archivos de registros

Gestión de Relaciones

  • get_relationships - Obtener relaciones de tablas
  • create_relationship - Crear una nueva relación de tabla
  • update_relationship - Actualizar una relación existente
  • delete_relationship - Eliminar una relación de tabla

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 de API se manejan de forma segura y nunca se registran
  • Todas las operaciones de archivos están limitadas al directorio de trabajo
  • Admite permisos a nivel de campo y controles de acceso

📋 Requisitos

  • Node.js 18+
  • Cuenta válida de Quickbase con acceso a API
  • Claude Desktop (para integración con MCP)

🤝 Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request).

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulte el archivo LICENSE para más detalles.

🔗 Enlaces