AgentHubAgentHub

QuickBooks Online MCP配置与使用教程

MCP ServerMCP Registry官方收录

io.github.Servosity/quickbooks-mcp · v0.1.10

覆盖 QuickBooks Online 会计的全部实体,并附带离线 SQLite 镜像与应收应付账龄。

原文描述:Every QuickBooks Online Accounting entity, plus an offline SQLite mirror and AR/AP aging.

建议先在本页复制安装配置,再到上游核对文档与权限。

产品介绍

覆盖 QuickBooks Online 会计的全部实体,并附带离线 SQLite 镜像与应收应付账龄。 QuickBooks Online MCP 是一个MCP Server,收录自 官方 MCP Registry。支持 stdio 传输。本页提供产品介绍、配置教程、安装命令与适用场景,支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。

适用场景

AgentHub Verified 可用性验证技术测试通过

自动化测试流水线已校验安装命令、传输协议与客户端兼容性

最近校验时间2026-10-04
安装配置格式测试有效CLI 与 mcpServers JSON 语法校验通过
协议连接与握手响应正常支持标准 JSON-RPC 2.0 规格规范
上游数据源存活来源 official-mcp-registry,可正常下载依赖
测试可用客户端Claude Code、Claude Desktop、Cursor 等
安全等级: A+ 级 · 官方认证推荐 (A+)·该工具由官方或知名生态团队维护,源码遵循标准开源许可协议,可安全接入 Cursor / Claude。
暂无自动生成的安装指引,请查看源仓库 README。

常见报错排查与运行避坑 (Troubleshooting)FAQ

针对 QuickBooks Online MCP 在 Cursor、Claude Code 中的常见连接错误与解决办法

在 Cursor / Claude Code 中配置 QuickBooks Online MCP 提示 connection closed 或 exit code 1?

通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤: 1. 确认已安装 Node.js 18+(支持 npx)或 Python 3.10+(支持 uvx); 2. 尝试在终端运行 which npx 或 which uvx,把配置文件中的 "command" 字段改为完整绝对路径; 3. 修改 mcp.json 后,必须完全重载或重启客户端窗口。

Fix Snippet
# 终端测试命令是否存在:
which npx
node -v
提示 spawn npx ENOENT 或 command not found?

这是因为编辑器后台进程未加载完整的终端环境变量(PATH)。解决方案:在全局安装该包(如 npm install -g 包名),或在配置文件中将 command 设置为系统的实际路径(如 Windows 下的 C:\Program Files\nodejs\npx.cmd,Mac 下的 /usr/local/bin/npx)。

提示 Missing required environment variable 或 API 认证失败?

QuickBooks Online MCP 依赖环境变量(如 QUICKBOOKS_ACCESS_TOKEN、QUICKBOOKS_REALM_ID)。请在客户端配置文件的 "env" 对象中填入有效密钥,注意不要包含多余空格或未闭合的双引号。

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "QUICKBOOKS_ACCESS_TOKEN": "your_actual_key_here"
  }
}

免安装模拟调用 (Playground)

仿真环境

QuickBooks Online MCP 核心接口调用仿真 · 无需配置本地环境,直接预览调用参数与返回格式

沙盒就绪 (Virtual Mock)
fn: quickbooks_mcpEvery QuickBooks Online Accounting entity, plus an offline SQLite mirror and AR/AP aging.
请求入参 (Arguments)JSON Schema
{
  "target": "QuickBooks Online MCP",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Agent 在规划任务时会自动生成并传递上述入参
Agent Tool Output

点击上方「模拟运行」按钮

查看该工具在 Agent 内部的返回数据格式

测试环境:AgentHub Virtual SandboxJSON-RPC 2.0

选型与决策建议(为什么选它?)

帮助你快速判断该资源是否契合当前项目,避免盲目折腾

适合什么任务?
  • PR 自动审查
  • 生成 changelog
  • 跨仓库 Issue 检索
什么时候不建议用?
  • 替代人工安全审计
  • 在无授权仓库上操作
推荐工作流搭配:查看完整场景 →

QuickBooks Online MCP + 对应场景 Prompt → 组成标准 Agent 自动化任务

MCP 实战教程:从安装到看见效果

按完整实例走一遍(含期望效果与对比验收)。装完本页资源后,用教程里的提示词核对是否真正生效。

打开教程 →

相关资源

常搭配使用

中文公文写作

v2.0.25

SkillClawHub9.1k

io.clawhub.gongyu0918-debug/chinese-official-writing

用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理,适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论,以及采购、整改、反馈和 AI 算力等场景。

source

继续逛 AgentHub

大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。

收录徽章:把 AgentHub 挂到你的官网

复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链,无需上传文件,链接指向本页,访客可由此直接找到安装方式。

预览AgentHub 已收录:QuickBooks Online MCP
HTML
<a href="https://myagenthub.cn/p/io.github.Servosity/quickbooks-mcp" title="AgentHub 已收录:QuickBooks Online MCP" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.Servosity/quickbooks-mcp" alt="AgentHub 已收录:QuickBooks Online MCP" height="20" style="border:0"/>
</a>
Markdown(GitHub README)
[![AgentHub 已收录:QuickBooks Online MCP](https://myagenthub.cn/badge/io.github.Servosity/quickbooks-mcp)](https://myagenthub.cn/p/io.github.Servosity/quickbooks-mcp)

徽章由 /badge/<资源ID> 动态生成,名称与收录状态变化后自动更新;请保留链接指向,它是收录来源的判定依据。

统一 Manifest

{
  "id": "io.github.Servosity/quickbooks-mcp",
  "type": "mcp-server",
  "version": "0.1.10",
  "displayName": "QuickBooks Online MCP",
  "description": "Every QuickBooks Online Accounting entity, plus an offline SQLite mirror and AR/AP aging.",
  "repository": {
    "url": "https://github.com/servosity/msp-skills",
    "source": "github",
    "subfolder": "skills/quickbooks"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/Servosity/msp-skills/releases/download/quickbooks-v0.1.10/quickbooks-mcp.mcpb",
        "version": "0.1.10",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "QUICKBOOKS_ACCESS_TOKEN",
            "description": "OAuth 2.0 bearer access token (scope com.intuit.quickbooks.accounting). Mint it from the Intuit OAuth 2.0 Playground or `quickbooks-cli auth refresh`.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "QUICKBOOKS_BASE_URL",
            "description": "Full company-scoped API base, e.g. https://quickbooks.api.intuit.com/v3/company/<realm-id>. Leave blank when you set the realm ID and environment above; the CLI builds this from them."
          },
          {
            "name": "QUICKBOOKS_CLIENT_ID",
            "description": "Client ID of your Intuit app (developer.intuit.com > your app > Keys). Set it with the client secret and refresh token so the CLI can mint a fresh access token; leave blank if you paste an access token instead.",
            "isSecret": true
          },
          {
            "name": "QUICKBOOKS_CLIENT_SECRET",
            "description": "Client secret paired with QUICKBOOKS_CLIENT_ID.",
            "isSecret": true
          },
          {
            "name": "QUICKBOOKS_ENVIRONMENT",
            "description": "Which Intuit host the realm lives on: production or sandbox. Combined with the realm ID to build the base URL."
          },
          {
            "name": "QUICKBOOKS_REALM_ID",
            "description": "The QuickBooks company ('realm') ID every call is scoped to. Find it in the Intuit developer dashboard or the sandbox company URL. Without it the CLI cannot build a working base URL.",
            "isRequired": true
          },
          {
            "name": "QUICKBOOKS_REFRESH_TOKEN",
            "description": "OAuth 2.0 refresh token. Refresh tokens live ~100 days and rotate on every refresh, so the CLI writes the new one back to its config.",
            "isSecret": true
          },
          {
            "name": "QUICKBOOKS_TOKEN_URL",
            "description": "Token endpoint the client-credentials exchange posts to. Leave the prefilled default unless your tenant uses a different token endpoint."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Servosity/quickbooks-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Servosity%2Fquickbooks-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}