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
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
¡Listo! Reinicia Claude Desktop y podrás empezar a usar las herramientas de Quickbase.
Related MCP server: Database Tools for Claude AI
📦 Opciones de instalación
Opción 1: NPM (Recomendado)
Opción 2: Desde la fuente
Para la instalación de origen, utilice esta configuración de Claude Desktop:
🔧 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 correctamentetest_connection- Prueba la conexión a Quickbaseconfigure_cache- Configurar el comportamiento del almacenamiento en caché
Gestión de aplicaciones
create_app- Crea nuevas aplicaciones Quickbaseupdate_app- Actualizar aplicaciones existenteslist_tables- Lista todas las tablas en una aplicación
Operaciones de tabla
create_table- Crea nuevas tablasupdate_table- Actualizar las propiedades de la tablaget_table_fields- Obtener información de campo para una tabla
Gestión de campo
create_field- Crea nuevos campos en tablasupdate_field- Actualizar propiedades de campo
Operaciones de registro
query_records- Consultar registros con filtrado y ordenamientocreate_record- Crea registros individualesupdate_record- Actualizar registros existentesbulk_create_records- Crea múltiples registrosbulk_update_records- Actualizar varios registros
Operaciones con archivos
upload_file- Subir archivos a los campos de adjuntos de archivosdownload_file- Descargar archivos de los registros
Informes
run_report- Ejecutar informes de Quickbase
Ejemplos de uso
Consulta básica de registros
Crear un nuevo registro
Subir un archivo
🔒 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.