honeybook

当用户询问 HoneyBook 客户端门户数据时，应使用此技能。触发诸如“检查 HoneyBook”、“签署合同”、“支付发票”、“HoneyBook 供应商”、“未签署的合同”、“开具发票”等短语，或任何涉及婚礼供应商合同、发票、小册子、提案或通过 HoneyBook 付款的请求。

# honeybook-mcp

MCP server for HoneyBook's client portal — 8 tools for viewing contracts and invoices across multiple wedding vendors, with magic-link session capture and deep-link fallback for signing and paying.

## Tools

- `use_magic_link` — Capture a session from a vendor magic-link URL
- `list_active_sessions` — Show currently active portal sessions
- `list_workspace_files` — All files one vendor has shared (filter by type)
- `get_workspace_file` — Full detail for one file
- `get_workspace` — Workspace detail + status flags
- `list_payment_methods` — Saved payment methods
- `sign_contract` — Deep link to sign in portal (requires `confirm:true`)
- `pay_invoice` — Deep link to pay in portal (requires `confirm:true`)

## Workflows

- **First time** → user pastes magic-link URL from vendor email → `use_magic_link` → session captured
- **"What contracts haven't I signed?"** → `list_workspace_files` with `file_type=agreement`, filter by `is_file_accepted=false`
- **"Summarize my HB status with Silk Veil"** → `get_workspace` (status flags) + `list_workspace_files`
- **"Send me a link to sign the photographer's contract"** → `list_workspace_files` → `sign_contract` with `confirm:true`
- **"Which invoices are overdue?"** → `list_workspace_files` with `file_type=invoice`, sort by due date

## Notes

- Each vendor = separate session keyed by portal origin (e.g. `https://acme.hbportal.co`)
- Sessions cached in `~/.honeybook-mcp/sessions.json` (mode 0600)
- Write tools (`sign_contract`, `pay_invoice`) return deep links in v2
- Session expires → re-run `use_magic_link` with a fresh URL from the vendor's email

---

## 中文说明

# honeybook-mcp

面向 HoneyBook 客户端门户的 MCP 服务器 —— 提供 8 个工具，用于跨多个婚礼供应商查看合同与发票，支持 magic-link 会话捕获，并在签署和付款时提供 deep-link 回退方案。

## 工具

- `use_magic_link` —— 从供应商的 magic-link URL 捕获一个会话
- `list_active_sessions` —— 显示当前活跃的门户会话
- `list_workspace_files` —— 某一供应商共享的所有文件（可按类型筛选）
- `get_workspace_file` —— 单个文件的完整详情
- `get_workspace` —— 工作区详情 + 状态标志
- `list_payment_methods` —— 已保存的付款方式
- `sign_contract` —— 在门户中签署的 deep link（需要 `confirm:true`）
- `pay_invoice` —— 在门户中付款的 deep link（需要 `confirm:true`）

## 工作流

- **首次使用** → 用户从供应商邮件中粘贴 magic-link URL → `use_magic_link` → 捕获会话
- **“我有哪些合同还没签？”** → 使用 `list_workspace_files` 并设置 `file_type=agreement`，按 `is_file_accepted=false` 筛选
- **“总结一下我和 Silk Veil 的 HB 状态”** → `get_workspace`（状态标志）+ `list_workspace_files`
- **“给我一个签署摄影师合同的链接”** → `list_workspace_files` → `sign_contract` 并设置 `confirm:true`
- **“哪些发票已逾期？”** → 使用 `list_workspace_files` 并设置 `file_type=invoice`，按到期日排序

## 备注

- 每个供应商 = 以门户来源（origin）为键的独立会话（例如 `https://acme.hbportal.co`）
- 会话缓存在 `~/.honeybook-mcp/sessions.json`（权限模式 0600）
- 写入类工具（`sign_contract`、`pay_invoice`）在 v2 中返回 deep link
- 会话过期 → 用供应商邮件中新的 URL 重新运行 `use_magic_link`