Holded MCP Server 4c322c44

MCPAI代理

提供方 JardiMargalefAgusti

AI代理 未标注 API Key 社区 / 第三方 Claude DesktopClaude

一个基于Model Context Protocol(MCP)的服务,用于集成Holded与Claude Code、Claude Desktop及其他兼容MCP客户端的发票、联系人和产品管理功能。

一句话选型结论

按资料字段整理

Holded MCP Server 4c322c44 属于AI代理类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 25 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量25暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

发票管理TypeScript本地部署联系人管理产品管理MCP集成财务工具

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 25 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 25 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Holded MCP Server 4c322c44当前 25 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JardiMargalefAgusti上游标注的维护方 JardiMargalefAgusti
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.9 KB
来自项目仓库与上游目录的原文,未做删改

holded-mcp-server

Servidor MCP (Model Context Protocol) para integrar Holded con Claude Code, Claude Desktop y cualquier cliente MCP compatible.

Expone 50 herramientas (tools) que cubren: facturas de venta, facturas de compra, presupuestos, contactos y productos de la API de facturación de Holded, el módulo CRM (leads y embudos de venta) y el módulo Equipo (empleados y control horario).

Desarrollado por APOGEA Consultores (Agustí Jardí).

Requisitos previos

  • Node.js >= 18 (descargar)
  • Git (descargar)
  • API Key de Holded (ver Cómo obtener la API Key)
  • Claude Code o Claude Desktop instalado

Instalación

Opción A — Instalador .exe (recomendado, sin requisitos)

Descarga holded-mcp.exe (o genéralo con npm run build:exe) y haz doble clic:

  1. Pide la API key de Holded (y la valida en vivo contra la API).
  2. Instala el ejecutable en C:\Holded-MCP\ (no necesita Node.js: lo lleva embebido).
  3. Te deja elegir dónde registrarlo — Claude Code (~/.claude.json), Claude Desktop (detecta las 3 variantes de Windows: instalador clásico, Local y Microsoft Store) o todos —, con backup previo de cada config y escritura atómica.
  4. Se da de alta en "Agregar o quitar programas" para desinstalarlo desde Windows.

Reinicia Claude (Desktop: salir del todo desde la bandeja del sistema) y listo.

El mismo .exe es también el desinstalador: doble clic → opción [3] Desinstalar (o desde "Agregar o quitar programas"). Elimina las entradas de las configs de Claude (con backup), el registro de Windows y la carpeta C:\Holded-MCP. Si pierdes el exe, consulta MANUAL_UNINSTALL.md.

Otros comandos del exe: holded-mcp.exe status (dónde está registrado), register, install, uninstall.

Opción B — Manual con Node.js```bash

1. Clonar el repositorio

git clone https://github.com/JardiMargalefAgusti/holded-mcp-server.git
cd holded-mcp-server

2. Instalar dependencias

npm install

3. Compilar

npm run build


Tras estos pasos, el servidor estará listo en `build/index.js`.

## Configuración

### Con Claude Code

Añade la siguiente entrada al fichero `.mcp.json` de tu proyecto (o a `~/.claude.json` para que esté disponible en todos los proyectos):```json
{
  "mcpServers": {
    "holded": {
      "command": "node",
      "args": ["/ruta/absoluta/a/holded-mcp-server/build/index.js"],
      "env": {
        "HOLDED_API_KEY": "tu_api_key_aqui"
      }
    }
  }
}

> Windows: usa rutas con doble barra \\, por ejemplo:
> "args": ["C:\\Users\\usuario\\holded-mcp-server\\build\\index.js"]

Reinicia Claude Code y comprueba que funciona con el comando /mcp — el servidor holded debe aparecer como connected.

Con Claude Desktop

Edita el fichero de configuración de Claude Desktop:

Sistema Ruta del fichero
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Añade dentro de "mcpServers":```json
"holded": {
"command": "node",
"args": ["/ruta/absoluta/a/holded-mcp-server/build/index.js"],
"env": {
"HOLDED_API_KEY": "tu_api_key_aqui"
}
}


Reinicia Claude Desktop para que detecte el nuevo servidor.

## Tools disponibles (50)

### Contactos (4)

| Tool | Descripción |
|------|-------------|
| `holded_list_contacts` | Lista todos los contactos (clientes, proveedores, etc.) |
| `holded_get_contact` | Obtiene los detalles de un contacto por su ID |
| `holded_create_contact` | Crea un contacto (cliente, proveedor, lead...) con NIF, dirección, etc. |
| `holded_search_contacts` | Busca contactos por nombre (búsqueda parcial) |

### Productos (2)

| Tool | Descripción |
|------|-------------|
| `holded_list_products` | Lista todos los productos y servicios |
| `holded_get_product` | Obtiene los detalles de un producto por su ID |

### Facturas de Venta (8)

| Tool | Descripción |
|------|-------------|
| `holded_list_invoices` | Lista facturas. Filtros: fecha inicio/fin, contacto |
| `holded_get_invoice` | Detalle completo de una factura |
| `holded_create_invoice` | Crea una nueva factura de venta |
| `holded_update_invoice` | Actualiza una factura existente |
| `holded_delete_invoice` | Elimina una factura |
| `holded_pay_invoice` | Registra un pago en una factura |
| `holded_send_invoice` | Envía una factura por email |
| `holded_get_invoice_pdf` | Obtiene el PDF de la factura (base64) |

### Facturas de Compra (7)

| Tool | Descripción |
|------|-------------|
| `holded_list_purchases` | Lista facturas de compra (gastos) |
| `holded_get_purchase` | Detalle de una factura de compra |
| `holded_create_purchase` | Registra una nueva factura de compra |
| `holded_update_purchase` | Actualiza una factura de compra |
| `holded_delete_purchase` | Elimina una factura de compra |
| `holded_pay_purchase` | Registra un pago a proveedor |
| `holded_get_purchase_pdf` | Descarga el PDF de una factura de compra (base64) |

### Presupuestos (6)

| Tool | Descripción |
|------|-------------|
| `holded_list_estimates` | Lista presupuestos. Filtros: fecha, contacto |
| `holded_get_estimate` | Detalle de un presupuesto |
| `holded_create_estimate` | Crea un nuevo presupuesto |
| `holded_update_estimate` | Actualiza un presupuesto existente |
| `holded_delete_estimate` | Elimina un presupuesto |
| `holded_send_estimate` | Envía un presupuesto por email |

### CRM — Embudos (5)

| Tool | Descripción |
|------|-------------|
| `holded_list_funnels` | Lista los embudos del CRM con sus etapas |
| `holded_get_funnel` | Detalle de un embudo por su ID |
| `holded_create_funnel` | Crea un nuevo embudo |
| `holded_update_funnel` | Actualiza un embudo existente |
| `holded_delete_funnel` | Elimina un embudo |

### CRM — Leads (12)

| Tool | Descripción |
|------|-------------|
| `holded_list_leads` | Lista los leads (oportunidades de venta) |
| `holded_get_lead` | Detalle completo de un lead (notas y tareas incluidas) |
| `holded_create_lead` | Crea un nuevo lead |
| `holded_update_lead` | Actualiza un lead existente |
| `holded_delete_lead` | Elimina un lead |
| `holded_update_lead_stage` | Mueve un lead a otra etapa del embudo |
| `holded_update_lead_dates` | Actualiza las fechas de un lead |
| `holded_create_lead_note` | Añade una nota a un lead |
| `holded_update_lead_note` | Actualiza una nota de un lead |
| `holded_create_lead_task` | Crea una tarea asociada a un lead |
| `holded_update_lead_task` | Actualiza una tarea de un lead |
| `holded_delete_lead_task` | Elimina una tarea de un lead |

### Equipo (6)

| Tool | Descripción |
|------|-------------|
| `holded_list_employees` | Lista los empleados del equipo |
| `holded_get_employee` | Ficha completa de un empleado (contrato, política de ausencias) |
| `holded_get_employee_times` | Fichajes (control horario) de un empleado |
| `holded_create_employee_time` | Crea un registro horario (inicio y fin) |
| `holded_clock_in` | Ficha la entrada de un empleado |
| `holded_clock_out` | Ficha la salida de un empleado |

> **Nota sobre vacaciones**: la API pública de Holded no expone la gestión de ausencias/vacaciones (solo desde la interfaz web). La ficha del empleado sí incluye su política de ausencias (`timeOffPolicyId`) y quién se las supervisa (`timeOffSupervisors`).

## Ejemplos de uso

Una vez conectado, puedes hacer peticiones en lenguaje natural a Claude:

- *"Busca el contacto Empresa ABC en Holded"*
- *"Lista mis facturas de venta del último mes"*
- *"Crea una factura para el cliente X con 2 horas de consultoría a 80 EUR/hora"*
- *"Registra el pago de la factura F-2026-001 por 4.235 EUR"*
- *"Envía el presupuesto P-2026-003 al email cliente@empresa.com"*
- *"Muéstrame las facturas de compra pendientes de pago"*
- *"Crea un lead para Empresa ABC en el embudo Comercial y añade una nota con lo hablado hoy"*
- *"Mueve el lead de Empresa XYZ a la etapa Negociación"*

## Cómo obtener la API Key de Holded

1. Inicia sesión en Holded
2. Ve a **Configuración** (icono engranaje) > **Desarrolladores**
3. Haz click en **Nueva API Key**
4. Copia la clave generada y úsala como `HOLDED_API_KEY`

> **Seguridad**: La API key da acceso a los datos de facturación de tu cuenta de Holded. Guárdala siempre como variable de entorno y nunca la incluyas directamente en el código fuente.

## Desarrollo```bash
npm run dev        # Compilación en modo watch (detecta cambios automáticamente)
npm run build      # Compilación completa
npm test           # Tests del parcheador de configs de Claude (node:test)
npm run build:exe  # Genera dist-exe/holded-mcp.exe (tsc + esbuild + @yao-pkg/pkg)

El .exe es autocontenido (Node 22 embebido, ~80 MB) y actúa como instalador, desinstalador y servidor MCP según cómo se invoque: doble clic → menú; serve (lo que lanza Claude) → servidor por stdio. El binario se instala con nombre versionado (holded-mcp-1.1.0.exe) para que las actualizaciones nunca choquen con un exe en uso por Claude.

Estructura del proyecto```

src/
├── index.ts # Entry point para Node (llama a runServer)
├── server.ts # runServer(): McpServer + registro de tools + stdio
├── main.ts # Entry point del .exe (instalador/desinstalador/serve)
├── claude-config.ts # Parcheo de configs de Claude (testeado)
├── claude-config.test.ts # Tests del parcheador (npm test)
├── holded-client.ts # Cliente HTTP para la API de Holded (retry 429)
├── types/
│ └── holded.ts # Interfaces TypeScript
└── tools/
├── contacts.ts # 4 tools de contactos
├── products.ts # 2 tools de productos
├── invoices.ts # 8 tools de facturas de venta
├── purchases.ts # 7 tools de facturas de compra
├── estimates.ts # 6 tools de presupuestos
├── crm.ts # 17 tools de CRM (leads y embudos)
└── team.ts # 6 tools de equipo (empleados y fichajes)
```

Stack técnico

  • Runtime: Node.js >= 18
  • Lenguaje: TypeScript (strict mode)
  • SDK: @modelcontextprotocol/sdk v1.27+
  • Validación: zod v4
  • Transporte: stdio (JSON-RPC)
  • HTTP: fetch nativo (Node 18+)

Solución de problemas

Problema Solución
El servidor no aparece en /mcp Verifica que la ruta a build/index.js es correcta y absoluta
Error HOLDED_API_KEY is required Añade la variable env.HOLDED_API_KEY en la configuración MCP
Error 401 o 403 de la API La API key es incorrecta o ha expirado. Genera una nueva en Holded
Error 429 (rate limit) El servidor reintenta automáticamente. Si persiste, espera unos segundos
No compila (npm run build falla) Asegúrate de tener Node.js >= 18 y haber ejecutado npm install

Contribuir

Las contribuciones son bienvenidas. Abre un issue o envía un pull request.

Licencia

MIT - APOGEA Consultores

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Holded MCP Server 4c322c44 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Holded MCP Server 4c322c44 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Holded MCP Server 4c322c44 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Holded MCP Server 4c322c44 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Holded MCP Server 4c322c44 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Holded MCP Server 4c322c44 能提供哪些能力?

资料显示约 25 个工具;能力标签包括 发票管理、TypeScript、Claude、产品管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。