Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/extraScripts/claudeCodePlugin/docs/mcp-prompts.md

50 lines
3.8 KiB
Markdown

# Hesabix MCP prompts and resource
This file transcribes the prompt/resource interface currently implemented by `hesabixAPI/app/services/ai/ai_mcp_service.py`. Recheck that source when updating the plugin.
## Prompts exposed by `prompts/list`
| Name | Current description | User argument |
|---|---|---|
| `business_summary` | تهیهٔ خلاصه مدیریتی از وضعیت کسب‌وکار با ابزارهای مجاز. | Optional `request` string, maximum 2,000 characters. |
| `sales_review` | بررسی روند فروش و نکات قابل پیگیری در کسب‌وکار جاری. | Optional `request` string, maximum 2,000 characters. |
| `inventory_review` | مرور وضعیت موجودی و شناسایی موارد نیازمند توجه. | Optional `request` string, maximum 2,000 characters. |
## Prompt body behavior
`prompts/get` uses these Persian titles:
- `business_summary`: «خلاصه مدیریتی کسب‌وکار»
- `sales_review`: «مرور فروش»
- `inventory_review`: «مرور موجودی»
The generated user message asks Claude to prepare the requested review for the business pinned to this MCP connection, use only available Hesabix tools, avoid requesting data from another business, explicitly disclose unavailable data, and not execute a modifying operation unless the user explicitly asks in the same conversation and the relevant tool is authorized. A non-empty `request` argument is appended as the user's additional request.
## Resource exposed by `resources/list`
| URI | Name | Description | MIME |
|---|---|---|---|
| `hesabix://business/overview` | نمای کلی کسب‌وکار | اطلاعات پایه کسب‌وکاری که این اتصال به آن محدود است. | `application/json` |
The resource currently returns the connected business's name, type, and field. It is tenant-pinned and should be treated as business-sensitive data.
## Server-provided tool
The server always adds `ask_hesabix_agent`, described as a multi-step question to the Hesabix agent, which selects and combines authorized, read-only tools for the connected business. Its input is a required `query` string. The agent runs in Analyzer mode; do not treat it as an action/transaction executor.
## Skill and agent mapping
| Plugin component | Prompt/resource/tool to use | Scope of work |
|---|---|---|
| `business-summary` skill | `business_summary`, overview resource, `ask_hesabix_agent` | Business snapshot. It can combine the individual read-only domains but must cite tool evidence. |
| `sales-review` skill | `sales_review` | Sales and invoice analysis only; distinguish invoicing from cash collection. |
| `inventory-review` skill | `inventory_review`, overview resource | Inventory, movement, and valuation analysis. |
| `receivables-review` skill | No dedicated MCP prompt exists | Uses the live authorized read tools; do not claim a `receivables_review` prompt exists. |
| `reports-analysis` skill | No dedicated MCP prompt exists | Uses live report tools and canonical accounting reports. |
| `crm-review` skill | No dedicated MCP prompt exists | Uses read-only CRM tools and current schemas. |
| `workflow-review` skill | No dedicated MCP prompt exists | Reviews workflows; does not run or change them. |
| `integrations-review` skill | No dedicated MCP prompt exists | Reads connected-channel state; generic connectors can still have external side effects. |
| `financial-analyst` agent | `ask_hesabix_agent` and direct read-only MCP tools | Analysis only; never calls a write-scope tool. |
| `accounting-operations` skill / `accounting-guide` agent | No dedicated MCP prompt exists | Explicitly requested write workflows; require specific preview, user confirmation, write grant, and client approval. |
Prompts are guidance, not authorization. The live server and account permissions remain authoritative.