AI导哈

ERP API代理服务

为Holded ERP提供API代理服务，使LLM（如Claude、GPT等）能够完全访问Holded账户的发票、CRM、项目、团队和会计功能。

  • by cyenis
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cyenis/holded-mcp

使用说明

holded mcp

MCP服务器 抱住 ERP API。让LLM（Claude、GPT等）完全访问您的持有账户——发票、CRM、项目、团队和会计。

设置

1.获取API密钥

首选 持有>设置>API 并复制您的API密钥。 文档

2.安装

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "holded": {
      "command": "npx",
      "args": ["-y", "holded-mcp"],
      "env": {
        "HOLDED_API_KEY": "your-api-key-here"
      }
    }
  }
}

克劳德代码

claude mcp add holded -- npx -y holded-mcp

然后设置环境变量 HOLDED_API_KEY 在你的壳里。

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "holded": {
      "command": "npx",
      "args": ["-y", "holded-mcp"],
      "env": {
        "HOLDED_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具（共136个）

发票（72个工具）

联系人

工具 说明
list_contacts 列出所有联系人（按电话、手机、customId筛选）
create_contact 创建新联系人（客户、供应商、债务人、债权人或潜在客户）
get_contact 通过ID获取联系人
update_contact 更新联系人
delete_contact 删除联系人
list_contact_attachments 列出联系人的附件
get_attachment 获取特定附件

产品

工具 说明
list_products 列出所有产品
create_product 创建新产品
get_product 按ID获取产品
update_product 更新产品
delete_product 删除产品
get_product_image 获取产品的主图像
list_product_images 列出产品的所有图片
get_product_secondary_image 按文件名获取次映像
update_product_stock 更新产品库存水平

服务

工具 说明
list_services 列出所有服务
create_service 创建新服务
get_service 按ID获取服务
update_service 更新服务
delete_service 删除服务

文件

支持10种文档类型： invoice, salesreceipt, creditnote, salesorder, proform, waybill, estimate, purchase, purchaseorder, purchaserefund

工具 说明
list_documents 按类型列出文档（按日期、联系人、付费/计费状态筛选）
create_document 使用行项目创建新文档
get_document 按类型和ID获取文档
update_document 更新文档
delete_document 删除文档
pay_document 为文档注册付款
send_document 通过电子邮件发送文档
get_document_pdf 获取文档的PDF
ship_all_items 运送文档中的所有项目
ship_items_by_line 按行运送特定物品
get_shipped_units 获取文档的发货单位
attach_file_to_document 将文件附加到文档
update_document_tracking 更新跟踪信息
update_document_pipeline 更新文档管道状态
list_payment_methods 列出可用的付款方式

国债

工具 说明
list_treasuries 列出国库账户
create_treasury 创建资金账户
get_treasury 开立国库账户

费用账户

工具 说明
list_expenses_accounts 列出费用账户
create_expenses_account 创建支出账户
get_expenses_account 开立一个支出账户
update_expenses_account 更新费用账户
delete_expenses_account 删除费用账户

编号系列

工具 说明
list_numbering_series 列表编号系列（按文档类型筛选）
create_numbering_series 创建编号系列
update_numbering_series 更新编号系列
delete_numbering_series 删除编号系列

销售渠道

工具 说明
list_sales_channels 列出销售渠道
create_sales_channel 创建销售渠道
get_sales_channel 获得销售渠道
update_sales_channel 更新销售渠道
delete_sales_channel 删除销售渠道

仓库

工具 说明
list_warehouses 列出仓库
create_warehouse 创建仓库
list_products_stock 列出仓库中的产品库存
get_warehouse 找个仓库
update_warehouse 更新仓库
delete_warehouse 删除仓库

支付

工具 说明
list_payments 列出付款
create_payment 创建付款
get_payment 获得付款
update_payment 更新付款
delete_payment 删除付款

税收

工具 说明
get_taxes 获取所有税务配置

联系人组

工具 说明
list_contact_groups 列出联系人组
create_contact_group 创建联系人组
get_contact_group 建立一个联络小组
update_contact_group 更新联系人组
delete_contact_group 删除联系人组

汇款

工具 说明
list_remittances 列出汇款
get_remittance 获得汇款

客户关系管理（29种工具）

漏斗

工具 说明
list_funnels 列出所有销售渠道
create_funnel 创建漏斗
get_funnel 拿个漏斗
update_funnel 更新漏斗
delete_funnel 删除漏斗

潜在客户

工具 说明
list_leads 列出所有潜在客户
create_lead 创建新的潜在客户
get_lead 获取线索
update_lead 更新潜在客户
delete_lead 删除潜在客户
create_lead_note 向潜在客户添加注释
update_lead_note 更新潜在客户说明
create_lead_task 向潜在客户添加任务
update_lead_task 更新潜在客户任务
delete_lead_task 删除潜在客户任务
update_lead_date 更新潜在客户的创建日期
update_lead_stage 将潜在客户移动到不同的管道阶段

事件

工具 说明
list_events 列出所有事件
create_event 创建事件
get_event 举办活动
update_event 更新事件
delete_event 删除事件

预订

工具 说明
list_booking_locations 列出预订地点
get_booking_slots 获取某个位置的可用插槽
list_bookings 列出所有预订
create_booking 创建预订
get_booking 预订
update_booking 更新预订
cancel_booking 取消预订

项目（16个工具）

项目

工具 说明
list_projects 列出所有项目
create_project 创建项目
get_project 获得一个项目
update_project 更新项目
delete_project 删除项目
get_project_summary 获取项目摘要（预算、时间、成本）

任务

工具 说明
list_tasks 列出所有任务
create_task 创建任务
get_task 获取任务
delete_task 删除任务

时间追踪

工具 说明
list_project_times 列出项目的时间条目
create_project_time 记录项目的时间
get_project_time 获取时间条目
update_project_time 更新时间条目
delete_project_time 删除时间条目
list_all_times 列出项目中的所有时间条目

团队（15个工具）

员工

工具 说明
list_employees 列出所有员工（分页，每页500人）
create_employee 创建员工
get_employee 找个员工
update_employee 更新员工
delete_employee 删除员工

时间追踪

工具 说明
list_time_trackings 列出所有时间轨迹
get_time_tracking 获取时间跟踪条目
update_time_tracking 更新时间跟踪条目
delete_time_tracking 删除时间跟踪条目
list_employee_times 列出员工的时间轨迹
create_employee_time 为员工创建时间跟踪
employee_clock_in 员工时钟
employee_clock_out 给员工打卡
employee_pause 暂停员工的时间跟踪
employee_unpause 取消员工的时间跟踪

会计（4种工具）

工具 说明
list_daily_ledger 列出所有日记账条目
create_daily_ledger_entry 创建日记条目
list_accounts 列出会计科目表中的所有科目
create_account 创建新的会计帐户

发展

git clone https://github.com/cyenis/holded-mcp.git
cd holded-mcp
npm install
npm run build

在本地运行：

HOLDED_API_KEY=your-key node dist/index.js

许可证

麻省理工学院

相关 MCP