Haokuaiji Finance

---
name: haokuaiji-finance
display_name: 用友好会计财务查询
display_name_en: Yonyou HaoKuaiJi Finance Query
description: 通过用友好会计官方 MCP 查询已授权账套的财务数据、凭证与报表，完成财务问数与只读分析。
description_zh: 连接用友好会计，查询授权账套的收入、利润、费用、应收应付、凭证与财务报表，进行财务问数与只读分析。
description_en: Query financial data, vouchers and reports from authorized Yonyou HaoKuaiJi accounting books via its official MCP service.
version: 1.0.0
author: 畅捷通
---

# 用友好会计连接器使用说明

本技能用于指导 AI 通过「好会计 MCP 官方」服务（由畅捷通提供）完成财务数据查询与分析。默认场景为只读问数。

## 何时使用本技能

- 用户询问财务或账务数据：收入、成本、费用、利润、资产负债、应收应付、现金流等。
- 用户要求查询凭证、总账、明细账或财务报表（资产负债表、利润表、现金流量表等）。
- 用户要求基于账套数据做财务分析、汇总、期间对比或生成经营摘要。

## 服务与认证前置

- MCP 服务地址：`https://mcphub.chanapp.chanjet.com/138/mcp`（Streamable HTTP，HTTPS）。
- 认证方式：MCP 标准 OAuth 2.1，由 WorkBuddy 内置 OAuth 管理器自动完成（未携带凭证时服务返回 401 并提供 OAuth 发现元数据）。
- 配置中不写入任何密钥；也不要向用户索要或记录 Token。
- 授权失效（401/403）时：提示用户在连接器管理中重新连接授权，不要反复重试，更不要伪造调用结果。

## 调用流程（必须遵守）

1. **initialize 握手**：首次连接先完成 MCP `initialize` 建立会话。它是协议握手步骤，不是业务查询工具，不要向用户承诺"initialize 能查数据"。
2. **工具发现**：通过 `tools/list` 读取服务实际暴露的工具名称、参数 Schema 与描述。所有调用必须以返回的真实工具为准，不得编造工具名或参数。
3. **账套选择**：
   - 用户未指定账套：调用"获取账套列表"类工具，识别并使用默认账套。
   - 用户指定账套：按名称对账套列表做模糊自然语言匹配。
   - 匹配到多个账套时：列出候选让用户确认后再查询。
   - 不得跨账套混用数据，不得猜测或推断未授权账套。
4. **查询执行**：按工具 Schema 传参（注意日期格式、期间范围、分页参数），一次查询失败可修正参数重试一次，仍失败则如实报告。

## 典型意图与处理

| 用户意图 | 处理方式 |
| --- | --- |
| 查询本月收入/利润/费用 | 确定统计期间 → 选定账套 → 调用对应报表或科目查询工具 |
| 查看应收/应付情况 | 调用科目余额或往来查询类工具，说明余额截止日期 |
| 查某日期的记账凭证 | 调用凭证查询类工具，按日期/凭证号/摘要过滤 |
| 生成财务分析或经营摘要 | 基于真实返回数据归纳，区分"数据事实"与"分析推断" |

如所需能力未出现在 `tools/list` 中，明确告知用户当前不支持，不得模拟调用成功。

## 输出要求

- 说明统计期间、账套名称、金额单位（元/万元）与数据口径。
- 只呈现工具真实返回的数据；分析结论须与原始数据明确区分。
- 数据缺失、口径不一致或工具返回异常时，如实说明而不是编造数字。

## 错误处理

| 场景 | 处理 |
| --- | --- |
| 401/授权失效 | 引导用户重新连接授权，终止本次查询 |
| 账套不存在或无权限 | 停止查询，向用户解释原因 |
| 参数错误 | 按 Schema 修正参数重试一次，仍失败则报告原始错误信息 |
| 多账套匹配不唯一 | 列出候选账套请用户选择 |

## 安全与高风险操作

- 仅访问用户已授权的账套；不泄露 Token、客户敏感信息与账套数据到无关上下文。
- 默认只读查询。对新增、修改、删除、审核、结账、报税、付款等可能产生业务影响的动作，必须在调用前核对工具能力、权限与影响范围，并取得用户明确确认。
- 不得将分析推断伪装成账套真实返回的数据。