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. 验证您的令牌是否有效且未过期