CData QuickBooks Time

Accede y gestiona datos de QuickBooks Time a través del CData MCP Server, impulsado por el CData JDBC Driver.

GitHubPrueba este MCPPatrocinado

Documentación

quickbooks-time-mcp-server-by-cdata

Servidor Model Context Protocol (MCP) de CData para QuickBooks Time

:heavy_exclamation_mark: Este proyecto crea un servidor MCP local de solo lectura. Para acceso MCP totalmente remoto, consulte la primera plataforma MCP gestionada: CData Connect AI. Para capacidades completas de lectura, escritura, actualización, eliminación y acciones alojadas localmente, y una configuración simplificada, consulte nuestro Servidor MCP de CData para QuickBooks Time.

Propósito

Creamos este servidor MCP de solo lectura para permitir que los LLM (como Claude Desktop) consulten datos en vivo de QuickBooks Time compatibles con el Controlador JDBC de CData para QuickBooks Time.

El controlador JDBC de CData se conecta a QuickBooks Time exponiéndolos como modelos SQL relacionales.

Este servidor envuelve ese controlador y hace que los datos de QuickBooks Time estén disponibles a través de una interfaz MCP simple, de modo que los LLM puedan recuperar información en vivo haciendo preguntas en lenguaje natural, sin necesidad de SQL.

Guía de configuración

  1. Clone el repositorio: 
    git clone https://github.com/cdatasoftware/quickbooks-time-mcp-server-by-cdata.git
cd quickbooks-time-mcp-server-by-cdata
  2. Compile el servidor: 
    mvn clean install
    Esto crea el archivo JAR: CDataMCP-jar-with-dependencies.jar
  3. Descargue e instale el controlador JDBC de CData para {source}: https://www.cdata.com/drivers/tsheets/download/jdbc
  4. Licencie el controlador JDBC de CData:
    • Navegue hasta la carpeta lib en el directorio de instalación, normalmente:
      • (Windows) C:\Program Files\CData\CData JDBC Driver for QuickBooks Time\
      • (Mac/Linux) /Applications/CData JDBC Driver for QuickBooks Time/
    • Ejecute el comando java -jar cdata.jdbc.tsheets.jar --license
    • Ingrese su nombre, correo electrónico y "TRIAL" (o su clave de licencia).
  5. Configure su conexión a la fuente de datos (Salesforce como ejemplo):

    • Ejecute el comando java -jar cdata.jdbc.tsheets.jar para abrir la utilidad de cadena de conexión.

    • Configure la cadena de conexión y haga clic en "Probar conexión"

      Nota: Si la fuente de datos utiliza OAuth, deberá autenticarse en su navegador.

    • Una vez que sea exitoso, copie la cadena de conexión para usarla más adelante.

  6. Cree un archivo .prp para su conexión JDBC (p. ej., quickbooks-time.prp) utilizando las siguientes propiedades y formato:
    • Prefix - un prefijo que se utilizará para las herramientas expuestas
    • ServerName - un nombre para su servidor
    • ServerVersion - una versión para su servidor
    • DriverPath - la ruta completa al archivo JAR de su controlador JDBC
    • DriverClass - el nombre de la clase del controlador JDBC (p. ej., cdata.jdbc.tsheets.TSheetsDriver)
    • JdbcUrl - la cadena de conexión JDBC que se utilizará con el controlador JDBC de CData para conectarse a sus datos (copiada de arriba)
    • Tables - déjelo en blanco para acceder a todos los datos; de lo contrario, puede declarar explícitamente las tablas a las que desea crear acceso 
      Prefix=tsheets
ServerName=CDataTSheets
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc.tsheets.jar
DriverClass=cdata.jdbc.tsheets.TSheetsDriver
JdbcUrl=jdbc:tsheets:InitiateOAuth=GETANDREFRESH;
Tables=

Uso del servidor con Claude Desktop

  1. Cree el archivo de configuración para Claude Desktop (claude_desktop_config.json) para agregar el nuevo servidor MCP, utilizando el formato a continuación. Si el archivo ya existe, agregue la entrada a mcpServers en el archivo de configuración.

    Windows

    {
  "mcpServers": {
    "{classname_dash}": {
      "command": "PATH\\TO\\java.exe",
      "args": [
        "-jar",
        "PATH\\TO\\CDataMCP-jar-with-dependencies.jar",
        "PATH\\TO\\quickbooks-time.prp"
      ]
    },
    ...
  }
}

    Linux/Mac

    {
  "mcpServers": {
    "{classname_dash}": {
      "command": "/PATH/TO/java",
      "args": [
        "-jar",
        "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
        "/PATH/TO/quickbooks-time.prp"
      ]
    },
    ...
  }
}

    Si es necesario, copie el archivo de configuración al directorio correspondiente (Claude Desktop como ejemplo). Windows

    cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json

    Linux/Mac

    cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'

  2. Ejecute o actualice su cliente (Claude Desktop).

Nota: Es posible que deba salir o cerrar por completo su cliente de Claude Desktop y volver a abrirlo para que aparezcan los servidores MCP.

Ejecución del servidor

  1. Ejecute el siguiente comando para ejecutar el servidor MCP por sí solo 
    java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Note: The server uses stdio so can only be used with clients that run on the same machine as the server.

Usage Details

Once the MCP Server is configured, the AI client will be able to use the built-in tools to read, write, update, and delete the underlying data. In general, you do not need to call the tools explicitly. Simply ask the client to answer questions about the underlying data system. For example:

  • "What is the correlation between my closed won opportunities and the account industry?"
  • "How many open tickets do I have in the SUPPORT project?"
  • "Can you tell me what calendar events I have today?"

The list of tools available and their descriptions follow:

Tools & Descriptions

In the definitions below, {servername} refers to the name of the MCP Server in the config file (e.g. {classname_dash} above).

  • {servername}_get_tables - Retrieves a list of tables available in the data source. Use the {servername}_get_columns tool to list available columns on a table. The output of the tool will be returned in CSV format, with the first line containing column headers.
  • {servername}_get_columns - Retrieves a list of columns for a table. Use the {servername}_get_tables tool to get a list of available tables. The output of the tool will be returned in CSV format, with the first line containing column headers.
  • {servername}_run_query - Execute a SQL SELECT query

JSON-RPC Request Examples

If you are scripting out the requests sent to the MCP Server instead of using an AI Client (e.g. Claude), then you can refer to the JSON payload examples below – following the JSON-RPC 2.0 specification - when calling the available tools.

source_get_tables

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "source_get_tables",
        "arguments": {}
    }
}

source_get_columns

{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "source_get_columns",
        "arguments": {
            "table":  "Account"
        }
    }
}

source_run_query

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
        "name": "source_run_query",
        "arguments": {
            "sql":  "SELECT * FROM [Account] WHERE [IsDeleted] = true"
        }
    }
}

Solución de problemas

  1. Si no puede ver su servidor MCP de CData en Claude Desktop, asegúrese de haber cerrado por completo Claude Desktop (Windows: use el Administrador de tareas, Mac: use el Monitor de actividad)
  2. Si Claude Desktop no puede recuperar datos, asegúrese de haber configurado su conexión correctamente. Use el generador de cadenas de conexión para crear la cadena de conexión (ver arriba) y copie la cadena de conexión en el archivo de propiedades (.prp).
  3. Si tiene problemas para conectarse a su fuente de datos, comuníquese con el equipo de soporte de CData.
  4. Si tiene problemas para usar el servidor MCP o tiene otros comentarios, únase a la comunidad de CData.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.

Todas las fuentes compatibles

AccessAct CRMAct-OnActive Directory
ActiveCampaignAcumaticaAdobe AnalyticsAdobe Commerce
ADPAirtableAlloyDBAmazon Athena
Amazon DynamoDBAmazon MarketplaceAmazon S3Asana
Authorize.NetAvalara AvaTaxAvroAzure Active Directory
Azure Analysis ServicesAzure Data CatalogAzure Data Lake StorageAzure DevOps
Azure SynapseAzure TableBasecampBigCommerce
BigQueryBing AdsBing SearchBitbucket
Blackbaud FE NXTBoxBullhorn CRMCassandra
CertiniaCloudantCockroachDBConfluence
Cosmos DBCouchbaseCouchDBCSV
CventDatabricksDB2DocuSign
DropboxDynamics 365Dynamics 365 Business CentralDynamics CRM
Dynamics GPDynamics NAVeBayeBay Analytics
ElasticsearchEmailEnterpriseDBEpicor Kinetic
Exact OnlineExcelExcel OnlineFacebook
Facebook AdsFHIRFreshdeskFTP
GitHubGmailGoogle Ad ManagerGoogle Ads
Google AnalyticsGoogle CalendarGoogle Campaign Manager 360Google Cloud Storage
Google ContactsGoogle Data CatalogGoogle DirectoryGoogle Drive
Google SearchGoogle SheetsGoogle SpannerGraphQL
GreenhouseGreenplumHarperDBHBase
HCL DominoHDFSHighriseHive
HubDBHubSpotIBM Cloud Data EngineIBM Cloud Object Storage
IBM InformixImpalaInstagramJDBC-ODBC Bridge
JiraJira AssetsJira Service ManagementJSON
KafkaKintoneLDAPLinkedIn
LinkedIn AdsMailChimpMariaDBMarketo
MarkLogicMicrosoft DataverseMicrosoft Entra IDMicrosoft Exchange
Microsoft OneDriveMicrosoft PlannerMicrosoft ProjectMicrosoft Teams
Monday.comMongoDBMYOB AccountRightMySQL
nCinoNeo4JNetSuiteOData
OdooOffice 365OktaOneNote
OracleOracle EloquaOracle Financials CloudOracle HCM Cloud
Oracle SalesOracle SCMOracle Service CloudOutreach.io
ParquetPaylocityPayPalPhoenix
PingOnePinterestPipedrivePostgreSQL
Power BI XMLAPrestoQuickbaseQuickBooks
QuickBooks OnlineQuickBooks TimeRaisers Edge NXTReckon
Reckon Accounts HostedRedisRedshiftREST
RSSSage 200Sage 300Sage 50 UK
Sage Cloud AccountingSage IntacctSalesforceSalesforce Data Cloud
Salesforce Financial Service CloudSalesforce MarketingSalesforce Marketing Cloud Account EngagementSalesforce Pardot
SalesloftSAPSAP Ariba ProcurementSAP Ariba Source
SAP Business OneSAP BusinessObjects BISAP ByDesignSAP Concur
SAP FieldglassSAP HANASAP HANA XS AdvancedSAP Hybris C4C
SAP Netweaver GatewaySAP SuccessFactorsSAS Data SetsSAS xpt
SendGridServiceNowSFTPSharePoint
SharePoint Excel ServicesShipStationShopifySingleStore
SlackSmartsheetSnapchat AdsSnowflake
SparkSplunkSQL Analysis ServicesSQL Server
SquareStripeSugar CRMSuiteCRM
SurveyMonkeySybaseSybase IQTableau CRM Analytics
TallyTaxJarTeradataTier1
TigerGraphTrelloTrinoTwilio
TwitterTwitter AdsVeeva CRMVeeva Vault
Wave FinancialWooCommerceWordPressWorkday
xBaseXeroXMLYouTube Analytics
ZendeskZoho BooksZoho CreatorZoho CRM
Zoho InventoryZoho ProjectsZuora... Docenas Más