AI导哈

QuickBooks在线集成服务器

这是一个用于QuickBooks在线集成的模型上下文协议（MCP）服务器实现，提供客户、账单、供应商等财务管理工具。

  • by Cao-Thanh-Duc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Cao-Thanh-Duc/mcp-quickbooks

使用说明

QuickBooks在线MCP服务器

这是QuickBooks Online集成的模型上下文协议（MCP）服务器实现。

设置

  1. 安装依赖项：
npm install
  1. 创建一个 .env 根目录中的文件，包含以下变量：
QUICKBOOKS_CLIENT_ID=your_client_id
QUICKBOOKS_CLIENT_SECRET=your_client_secret
QUICKBOOKS_ENVIRONMENT=sandbox
  1. 获取您的客户ID和客户密码：
    • 去 Intuit开发者门户
    • 创建新应用程序或选择现有应用程序
    • 从应用程序的密钥部分获取客户端ID和客户端密钥
    • 添加 http://localhost:8000/callback 指向应用程序的重定向URI

认证

有两种方法可以通过QuickBooks Online进行身份验证：

选项1：使用环境变量

如果您已经拥有刷新令牌和领域ID，则可以直接将它们添加到您的 .env 文件：

QUICKBOOKS_REFRESH_TOKEN=your_refresh_token
QUICKBOOKS_REALM_ID=your_realm_id

选项2：使用OAuth流

如果你没有刷新令牌，你可以使用内置的OAuth流：

这将：

  • 启动临时本地服务器
  • 自动打开默认浏览器
  • 将您重定向到QuickBooks进行身份验证
  • 将代币保存到您的 .env 文件一旦通过身份验证
  • 完成后自动关闭

用法

设置身份验证后，您可以使用MCP服务器与QuickBooks Online进行交互。服务器提供各种工具来管理客户、估算、账单等。

可用工具

为以下实体添加了创建、删除、获取、搜索、更新工具：

  • 账户
  • 缴费服务
  • 比尔
  • 客户
  • 员工
  • 估计
  • 发票
  • 物品
  • 日记
  • 购买
  • 供应商

错误处理

如果您看到类似“QuickBooks未连接”的错误消息，请确保：

  1. 检查你的 .env 文件包含所有必需的变量
  2. 验证您的令牌是否有效且未过期

相关 MCP