businys

@businys/mcp-server

适用于 Businys 的官方 MCP 服务——面向独立专业人士的一体化平台。

涵盖 26 个专业领域的 221 个工具。 客户、发票、合同、预约、项目、计划等，任何兼容 MCP 的 AI Agent 均可访问。

安装

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "businys": {
      "command": "npx",
      "args": ["@businys/mcp-server"],
      "env": {
        "HIATYS_API_KEY": "your-api-key-here"
      }
    }
  }
}

其他 MCP 客户端

npx @businys/mcp-server

需要设置 HIATYS_API_KEY 环境变量。

获取 API 密钥

1. 登录 businys.app
2. 前往 Settings → API Keys
3. 创建具有所需权限范围的新密钥
4. 将密钥粘贴到 MCP 客户端配置中

访问 API 需要付费套餐（Starter 套餐每月 12 美元起）。

包含内容

工具（共 221 个）

该服务会提供 Businys 账户中所有已启用功能对应的工具：

专业领域	工具
摄影	客户、报价、图库、合同、发票、器材、许可
健身	客户、计划、锻炼、进度跟踪、课程
设计	项目、提案、合同、发票、交付物
品牌	品牌指南、品牌识别系统、交付物
摄像	项目、镜头清单、合同、交付物
瑜伽	课程、会员资格、预约、套餐
人生教练	课程、计划、进度检查、目标
咨询	合作项目、交付物、工时表
辅导	学生、课程、进度、套餐
音乐教学	学生、课程计划、课程、套餐
在线课程	课程、模块、报名、进度
婚礼策划	婚礼、供应商、时间表、预算
社交媒体	客户、营销活动、内容日历
美发沙龙	客户、预约、服务、套餐
美甲	客户、预约、服务、套餐
按摩疗法	客户、登记表、套餐、SOAP 记录
纹身	客户、预约、定金、术后护理
清洁	房产、检查清单、日程安排、开票
园林绿化	房产、服务、日程安排、开票
宠物美容	宠物、客户、预约、服务
新闻简报	订阅者、期刊、赞助、分析
YouTube 创作者	视频、赞助、分析、收入
播客	单集、嘉宾、赞助、分析
文案撰写	客户、项目、简报、交付物
自由职业开发	客户、项目、工时表、发票
AI 咨询	客户、合作项目、提示词库

此外还提供跨专业领域工具：客户、发票、合同、预约、资产、自动化、批量操作等。

资源

• hiatys://context/current — 实时业务上下文快照
• hiatys://data/clients — 活跃客户列表
• hiatys://clients/{id} — 单个客户详情
• hiatys://context/{sections} — 按部分选择上下文
• hiatys://profiles/{slug} — 公开个人资料页面数据

工具发现

使用内置的 get_manifest 工具，查看账户可用的所有工具、分组和资源。

环境变量

变量	必需	默认值	描述
HIATYS_API_KEY	是	—	你的 Businys API 密钥
HIATYS_BASE_URL	否	https://businys.app	用于可自托管或暂存环境的覆盖地址

传输方式

此软件包使用 stdio 传输，适用于 Claude Desktop、Cursor、Cline 及其他本地 MCP 客户端。

如需使用 HTTP/streamable-http 传输，请使用 API 密钥作为 Bearer 令牌，直接连接到 https://businys.app/api/mcp。

数据与隐私

• 所有数据均存储在你的 Businys 账户中
• 服务仅转发 API 调用，MCP 服务进程不会存储任何数据
• 数据驻留在加拿大（ca-central-1），符合 PIPEDA 规范
• 可随时从 Settings 导出全部数据

许可证

MIT — 参见 LICENSE

Links

• Businys
• Documentation
• Issues
• MCP Server Card