Devart MCP Server for QuickBooks Online (ADO.NET)

版本 1.1.0

新增内容 · 更新日志

Devart MCP Server for QuickBooks Online

Devart MCP Server for QuickBooks Online 可让 AI 客户端通过运行于您环境中的安全服务与您的数据交互。它将普通的 AI 聊天转变为处理真实业务数据的实用方式，而且速度快于传统的数据导出或手动查询。

主要优势

Devart MCP Server for QuickBooks Online 可帮助您：

• 通过自然语言直观地处理数据。
• 在几分钟内检索所需数据以供分析。
• 借助 AI 助手更快地生成数据报告。
• 最大限度地减少手动数据处理和集成维护工作。

工作原理

Devart MCP Server for QuickBooks Online 可帮助 AI 客户端使用自然语言提示词直接与 QuickBooks Online 数据库通信。它会将 AI 请求转换为结构化查询，通过 Devart 连接驱动程序执行查询，并返回清晰、结构化的结果，实现无缝的 AI 驱动数据访问。

快速开始

若要开始使用 Devart MCP Server for QuickBooks Online：

1. 下载并安装 Devart ODBC Driver for QuickBooks Online。

2. 下载并安装 Devart MCP Server for QuickBooks Online。

3. 在 Devart MCP Server for QuickBooks Online 中，配置数据连接和集成设置。

4. 运行您的第一个自然语言查询。

手动安装和配置

先决条件

在构建和运行 Devart MCP Server for QuickBooks Online 之前，请确保已安装以下组件：

• .NET 8 SDK
• ADO.NET 连接 — Devart.AI.McpServer.AdoNet.QuickBooks.csproj Devart dotConnect for QuickBooks Online（在构建期间通过 NuGet 自动安装）
• ODBC 连接 — Devart.AI.McpServer.Odbc.QuickBooks.csproj Devart ODBC Driver for QuickBooks Online（需要手动下载并安装）

步骤 1：克隆仓库

克隆项目仓库并导航至项目目录：

1. 打开 命令提示符。

2. 输入以下命令：

git clone https://github.com/devart-ai-connectivity/devart-mcp-server-quickbooks-online.git
cd devart-mcp-server-quickbooks-online

步骤 2：从源代码构建 MCP Server

您可以使用以下任一受支持的数据库连接技术从源代码构建 Devart MCP Server for QuickBooks Online：ADO.NET 或 ODBC。

• 若要使用 ADO.NET 构建 MCP 服务，请运行以下命令：

dotnet publish Devart.AI.McpServer.AdoNet/Devart.AI.McpServer.AdoNet.QuickBooks/Devart.AI.McpServer.AdoNet.QuickBooks.csproj -c ReleaseQuickBooks /p:TargetFramework=net8.0

Devart dotConnect for QuickBooks Online NuGet 包会自动下载并还原。

• 若要使用 ODBC 构建 MCP 服务，请根据数据源的位数选择命令。

对于 64 位数据源，请运行以下命令：

dotnet publish Devart.AI.McpServer.Odbc/Devart.AI.McpServer.Odbc.QuickBooks/Devart.AI.McpServer.Odbc.QuickBooks.csproj -c ReleaseQuickBooks -r "win-x64" /p:TargetFramework=net8.0

对于 32 位数据源，请运行以下命令：

dotnet publish Devart.AI.McpServer.Odbc/Devart.AI.McpServer.Odbc.QuickBooks/Devart.AI.McpServer.Odbc.QuickBooks.csproj -c ReleaseQuickBooks -r "win-x86" /p:TargetFramework=net8.0

注意

目标平台的位数必须与 ODBC 数据源的位数一致。

步骤 3：为 MCP Server 配置数据库连接 1. 在已构建的 MCP 服务可执行文件所在目录中创建 mcpserver.json 配置文件。

2. 在文件中配置数据库连接。

• 配置 ADO.NET 连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_quickbooks",
      "ConnectionString": "Authentication Type=OAuthInteractive;Company Id=your_company_id;License Key=your_license_key;",
      "ProtocolType": "stdio"
    }
  ]
}

• 配置 ODBC 连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_quickbooks",
      "DsnName": "your_dsn_name",
      "ProtocolType": "stdio"
    }
  ]
}

• 使用连接字符串配置 ODBC 连接。

将以下配置添加到 mcpserver.json 文件中：

{
  "Connections": [
    {
      "Name": "my_quickbooks",
      "ConnectionString": "Driver={Devart ODBC Driver for QuickBooks Online};Server=localhost;User ID=quickbooks;Password=your_password;Database=your_database;",
      "ProtocolType": "stdio"
    }
  ]
}

其中：

• Name — 连接名称。

• ConnectionString（适用于 ADO.NET）— 用于建立与目标数据库连接的数据库专用连接字符串。

• DsnName（适用于 ODBC）— 数据源名称。

• ProtocolType — 传输协议。可选值为：stdio 或 http。

• HttpPort（当 ProtocolType 设置为 http 时为必填项）— http 协议的端口号。

步骤 4：运行 MCP 服务

配置 MCP 服务后，即可启动它。

注意

仅当 ProtocolType 配置为 http 时，才需要执行此步骤。如果使用 stdio 传输协议，AI 客户端会自动启动服务。

• 要使用 ADO.NET 启动服务，请运行以下命令：

Devart.AI.McpServer.AdoNet.QuickBooks.exe run my_quickbooks

• 要使用 ODBC 启动服务，请运行以下命令：

Devart.AI.McpServer.Odbc.QuickBooks.exe run my_quickbooks

其中，my_quickbooks 是 ODBC 连接的名称。

步骤 5：与 Claude Desktop 集成

1. 打开 Claude 配置文件 claude_desktop_config.json。

提示

如果找不到配置文件，可能是因为它尚不存在。要创建该文件，请打开 Claude Desktop，然后依次转到 File > Settings > Developer，再点击 Edit Config。随后会打开包含 claude_desktop_config.json 文件的文件夹。

2. 根据 MCP 服务使用的传输协议，添加以下对象之一：

• STDIO

{
  "mcpServers": {
    "devart": {
      "command": "C:\\path\\to\\Devart.AI.McpServer.AdoNet.QuickBooks.exe",
      "args": [
        "run",
        "my_quickbooks"
      ]
    }
  }
}

其中：

• devart 是将在 Claude Desktop 中显示的连接器名称。

• C:\\path\\to\\Devart.AI.McpServer.AdoNet.QuickBooks.exe 是可执行文件的路径。对于 ODBC 连接，请使用 Devart.AI.McpServer.Odbc.QuickBooks.exe。

• my_quickbooks 是 mcpserver.json 配置文件中指定的连接名称。

• HTTP

    "mcpServers": {
      "devart": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "http://localhost:5000/sse"
        ]
      }
    }
  

  其中：

  • devart 是将在 Claude Desktop 中显示的连接器名称。
  • 5000 是 MCP 服务的侦听端口。

3. 保存文件。

4. 重启 Claude Desktop。

Devart MCP Server for QuickBooks Online 现已与 Claude 集成，devart 会显示在 Claude Desktop 应用的 Customize > Connectors 中。

你还可以将 Devart MCP Server for QuickBooks Online 集成到其他 AI 客户端，例如 Cline、Codex、Cursor、Visual Studio Code、Windsurf 和 Zed。

支持的客户端

Devart MCP Server for QuickBooks Online 支持与以下 AI 客户端集成：

• Claude Desktop
• Visual Studio Code
• Cursor
• Codex
• Windsurf
• Cline
• Zed
• ……以及其他兼容 MCP 的 AI 客户端

典型用例

Devart MCP Server for QuickBooks Online 非常适合将 QuickBooks Online 作为主要数据源的团队。

• 现金流和流动性分析
  询问存储在 QuickBooks Online 中的当前现金状况、未结发票、即将到期的付款和银行余额。

• 费用跟踪和成本分析
  按供应商、类别、时间段和项目分析费用，了解成本趋势并发现优化机会。

• 应收账款和发票状态
  让企业主和会计师查看 QuickBooks 中的逾期发票、客户付款历史记录和未收应收账款。

• 损益报告
  根据 QuickBooks Online 财务数据，按需生成损益摘要、收入明细和费用对比。

• 税务准备数据访问
  从 QuickBooks 获取分类交易数据、费用摘要和收入记录，以支持税务准备和审核。

• 工资和承包商付款历史记录
  查询 QuickBooks Online 工资记录中的工资发放、承包商付款和劳动力成本数据。

许可与激活

Devart MCP Server for QuickBooks Online 以免费的单一源代码 MCP 服务形式分发。

要连接到 QuickBooks Online，服务需要相应的 Devart ODBC Driver for QuickBooks Online，这是一款付费产品。

Devart ODBC Driver for QuickBooks Online 提供 30 天免费试用。

请参阅产品页面和文档，了解最新的安装和激活详情。

支持

• 文档
• 提交请求
• 建议功能
• 加入我们的论坛

其他 Devart 连接解决方案

• MCP Server Universal
• ODBC Driver for QuickBooks Online
• dotConnect ADO.NET Provider for QuickBooks Online