QBO MCP Server

QBO MCP服务器（OAuth）

FastAPI+MCP服务器，使用OAuth/OIDC承载JWT对MCP请求进行身份验证，并允许每个用户连接多个QBO公司。

渲染开始命令

uvicorn app.main:app --host 0.0.0.0 --port $PORT

环境变量

必需

• fernetkey
• SQLITE_PATH
• INTUIT_CLIENT_ID
• INTUIT_CLIENT_SECRET
• INTUIT_REDIRECT_URI（必须是https:///直觉/回调）
• OAUTH_ISSUER_DOMAIN（例如您的租户.us.auth0.com）
• OAUTH_AUDINCE（API受众/标识符）

可选的

• INTUIT_SCOPE（默认：com.INTUIT.quickbooks.accounting）
• OAUTH_算法（默认：RS256）

端点

• GET/mcp->200（ChatGPT连接器的探测/健康状况添加流）
• POST/mcp->mcp JSON-RPC（需要授权：承载 )
• 获取/直觉/连接？state=\->Intuit同意重定向
• GET/直觉/回调->令牌交换+在user_id下存储realmId

用户如何连接QBO

1. 使用OAuth在ChatGPT中添加此MCP服务器。
2. 在ChatGPT中，运行MCP工具 qbo_connect_company 打开返回的 connect_url.
3. 批准Intuit同意书（选择正确的客户公司）。
4. 对每个客户公司重复上述步骤。
5. 使用 qbo_list_companies 和 qbo_query_all.