MCP Holded

MCP持有

 ](https://www.npmjs.com/package/@iamsamuelfraga/mcp-holded)  

用于持有发票API的模型上下文协议（MCP）服务器。该服务器允许像Claude这样的人工智能助手与Holded的发票、联系人、产品等进行交互。

特性

此MCP服务器提供对完整的保留发票API的访问：

• 文件 （16个工具）：创建、列出、更新、删除发票、估算、贷记单等。还可以付款、发送、获取PDF、运送物品等。
• 联系人 （7个工具）：使用附件管理客户和供应商。
• 产品 （9个工具）：全面的产品管理，包括图片和库存。
• 国债 （3个工具）：管理国库账户。
• 费用账户 （5个工具）：处理费用账户类别。
• 编号系列 （4个工具）：配置文档编号。
• 销售渠道 （5个工具）：管理销售渠道。
• 仓库 （5个工具）：仓库管理。
• 支付 （5个工具）：付款方式配置。
• 税收 （1个工具）：获取可用税款。
• 联系人组 （5个工具）：将联系人分组。
• 汇款 （2个工具）：访问汇款数据。
• 服务 （5个工具）：管理服务。

总计：72个工具

安装

先决条件

• Node.js 22.14或更高版本
• 拥有API访问权限的持有帐户
• 您的Holded API密钥（从Holded Settings>API获取）

从npm安装

npm install -g @iamsamuelfraga/mcp-holded

从源代码安装

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

配置

环境变量

设置您的Holded API密钥：

export HOLDED_API_KEY=your_api_key_here

Claude桌面配置

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "holded": {
      "command": "npx",
      "args": ["-y", "@iamsamuelfraga/mcp-holded"],
      "env": {
        "HOLDED_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者，如果从源代码安装：

{
  "mcpServers": {
    "holded": {
      "command": "node",
      "args": ["/path/to/mcp-holded/dist/index.js"],
      "env": {
        "HOLDED_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用示例

配置后，您可以要求Claude：

文件

• “列出我持有的所有发票”
• “为客户X创建包含2个项目的发票”
• “通过电子邮件将123号发票发送给客户”
• “获取456号发票的PDF”
• “将发票#789标记为已付款”

联系人

• “在Holded中列出我的所有客户”
• “创建一个名为Acme Corp的新客户”
• “更新联系人#123的电子邮件”

产品

• “显示所有产品”
• “创建一个名为Widget的新产品，价格为50欧元”
• “更新产品#123的库存，增加10个单位”

报告

• “得到我所有的税”
• “列出所有国债”
• “给我看看销售渠道”

文档类型

API支持以下文档类型：

API 参考

基础URL

https://api.holded.com/api/invoicing/v1/

认证

所有请求都使用 key 使用API密钥的标头。

分页

列表端点支持通过分页 page 查询参数。

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

隐私政策

数据收集：此MCP服务器需要您的Holded API密钥才能运行。API密钥是从本地环境变量中读取的(HOLDED_API_KEY)并且从不由该服务器存储。所有API请求和响应都是实时传递的，以方便您的人工智能助手与Holded API之间的通信。

数据使用和共享：您的API密钥和通过此服务器处理的所有数据仅用于代表您与Holded API进行交互。服务器充当传递代理，它不存储、记录或保留任何数据。您的Holded API密钥和数据仅传输到Holded的官方API端点（API.Holded.com）。除Holded之外，不会与任何第三方共享任何数据。

您的安全：我们建议以下安全最佳实践：将您的API密钥存储在环境变量中（永远不要将其提交到版本控制），定期更新到最新版本，并在您的AI助手中查看授予此MCP服务器的权限。有关更多信息，请参阅我们的 完整隐私政策.

支持

如有疑问、问题或功能请求：

• GitHub 问题: 报告问题
• 电子邮件: samuel.fraga@nevent.es
• 文档: 持有API文件

许可证

麻省理工学院-参见 许可证 文件以获取详细信息。

作者

塞缪尔·弗拉加

• 领英

链接

• 持有API文件
• MCP规范
• 隐私政策