Conector MCP de Quickbase

Un conector de Protocolo de Contexto de Modelo (MCP) para la integración con la API RESTful JSON de Quickbase .

AVISO LEGAL: Este es un proyecto no oficial e independiente, no afiliado, patrocinado ni respaldado por Quickbase, Inc. Este conector se proporciona "tal cual", sin garantía de ningún tipo y no cuenta con soporte de Quickbase. Los usuarios son responsables de cumplir con todas las leyes, regulaciones y requisitos de seguridad aplicables al utilizar este conector.

Descripción general

Este conector utiliza el Protocolo de Contexto de Modelo (MCP) para permitir que asistentes de IA como Claude interactúen con la API de Quickbase. Admite una amplia gama de operaciones para gestionar aplicaciones, tablas, campos, registros, archivos e informes con Quickbase.

Características

Para usuarios

• Acceso a Quickbase con tecnología de IA : hable con sus datos de Quickbase directamente a través de Claude
• Gestión de datos : cree, visualice y actualice sus aplicaciones, tablas y registros mediante lenguaje natural
• Manejo de archivos : cargue y descargue archivos adjuntos a sus registros
• Acceso a informes : ejecute sus informes Quickbase y obtenga los resultados directamente en el chat
• Compatibilidad con grandes conjuntos de datos : gestiona la paginación automáticamente al consultar grandes cantidades de registros

Para desarrolladores

• Cobertura completa de API : acceso a la funcionalidad principal de la API de Quickbase
• Respuestas estructuradas : formato de respuesta consistente para un análisis confiable
• Operaciones por lotes : gestión eficiente de operaciones de registros masivos
• Diagnóstico de errores : mensajes de error detallados con códigos de estado e información de solución de problemas

Prerrequisitos

• Python 3.8 o superior
• Node.js 14 o superior
• Credenciales de la API de Quickbase (nombre de host del dominio, token de usuario e ID de la aplicación)

Instalación

1. Clonar el repositorio:

2. Configurar el entorno:

3. Configure sus credenciales de Quickbase:

Inicio rápido

Para aquellos que solo quieran probar este conector con Claude o Claude Code:

1. Instalar dependencias y configurar el servidor:

2. Uso con Claude Desktop (recomendado):

Cree un archivo de configuración para Claude Desktop que inicie automáticamente el servidor. La ubicación del archivo de configuración depende del sistema operativo:

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Ventanas : %APPDATA%\Claude\claude_desktop_config.json
• Linux : ~/.config/Claude/claude_desktop_config.json

Agregue la siguiente configuración:

3. Usando el código de Claude:

¡Ahora puedes usar las herramientas de Quickbase en tu sesión de Claude! Ejemplo de mensaje: "Listar todas las tablas de mi aplicación Quickbase usando el conector Quickbase".

Categorías de herramientas disponibles

Herramientas de conexión

• test_connection : verifica tu conexión a la API de Quickbase
• check_auth : Verifica el estado de autenticación y los permisos

Herramientas de la aplicación

• get_app : Obtener detalles sobre una aplicación específica
• get_apps : Lista todas las aplicaciones disponibles
• create_app , update_app : Crea y actualiza aplicaciones

Herramientas de tabla

• get_table , get_tables : Recuperar información de la tabla
• create_table , update_table : Crea y actualiza tablas

Herramientas de campo

• get_field , get_fields : Recuperar información del campo
• create_field , update_field : Crea y actualiza campos

Herramientas de grabación

• get_record , query_records : Recuperar datos de registros
• create_record , update_record : Operaciones de registros individuales
• bulk_create_records , bulk_update_records : Operaciones por lotes eficientes

Herramientas de archivo

• upload_file : Subir un archivo a un campo de registro
• download_file : Descargar un archivo desde un campo de registro
• manage_attachments : Gestión de archivos adjuntos de alto nivel

Herramientas de informes

• run_report : Ejecutar informes de Quickbase

No implementado

Las siguientes operaciones no están implementadas:

• Operaciones de eliminación (delete_app, delete_table, delete_field, delete_record, bulk_delete_records, delete_file)
• Operaciones de usuario (get_user, get_current_user, get_user_roles, manage_users)
• Operaciones de formulario (manage_forms)
• Operaciones del panel de control (manage_dashboards)
• Operaciones de tuberías (manage_pipelines)
• Operaciones de formulario FastField (manage_fast_field_form)

Para desarrolladores y colaboradores

Iniciar el servidor MCP manualmente

Si necesita iniciar manualmente el servidor (para desarrollo o depuración):

Ejecución de pruebas

Esta sección es principalmente para colaboradores que desean verificar sus cambios o ejecutar el conjunto de pruebas.

Todas las pruebas se encuentran en el directorio tests/ . Puede usar el ejecutor de pruebas para ejecutar pruebas específicas o todas las pruebas:

También se pueden ejecutar directamente scripts de prueba individuales:

Para obtener más información sobre las pruebas, consulte tests/README.md .

Variables de entorno

Es posible que sea necesario configurar las siguientes variables de entorno:

Manejo de errores

El conector proporciona un manejo integral de errores con:

• Clasificación del tipo de error
• Códigos de estado HTTP
• Mensajes de error detallados de la API de Quickbase
• Soluciones sugeridas
• Validación de parámetros
• Validación de datos JSON
• Manejo adecuado de errores de solicitud de API

Escenarios de error comunes

• Faltan parámetros requeridos
• Formato de datos JSON no válido
• ID de tabla o campo inexistentes
• Sintaxis de cláusula WHERE no válida
• Errores de autenticación
• Problemas de permisos
• Problemas de conectividad de red

Todas las respuestas de error incluyen información de diagnóstico útil para ayudar con la solución de problemas.

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Confirme sus cambios
4. Empujar hacia la rama
5. Crear una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles