mcp-holded — MCP-сервер для Holded: 119 инструментов API v2
Даёт ИИ-ассистенту доступ к Holded: счета, контакты, товары, казна, зарплаты и учёт. Нужен ключ API v2 из настроек Holded.
claude mcp add mcp-holded -e HOLDED_API_KEY=<HOLDED_API_KEY> -- npx -y @nubiia/mcp-holdedЧто делает mcp-holded
Сервер оборачивает Holded API v2 и регистрирует 119 инструментов, как только задан рабочий ключ. Документы (16 инструментов) — создание, правка, удаление, оплата, отправка и PDF по счетам, сметам и кредит-нотам. Контакты, товары, склады, каналы продаж, серии нумерации, налоги и платежи идут отдельными группами. Казна v2 даёт 15 инструментов: банковские счёта, движения, прогноз счетов и сверку.
Учёт и кадры тоже на месте: план счетов и дневной журнал только на чтение, проводки можно создавать, а в HR — 22 инструмента, включая сотрудников, расчётные листы и отметки прихода-ухода. Из-за этого сервер подходит не только бухгалтеру: агент может собрать счёт по данным из чата, а потом проверить, прошёл ли платёж.
Нужен Node.js 22.14 или новее и ключ Holded, который начинается с pat_ или sk_live_. Ключ берётся в разделе Holded → Settings → API и передаётся в переменной HOLDED_API_KEY. Ответ 403 значит, что ключу не хватает прав. Суммы приходят строками с десятичной запятой, поэтому перед арифметикой их надо разбирать своим парсером. Для нескольких компаний заводите пары TENANT_N_NAME и TENANT_N_API_KEY.
Какие задачи решает
- выставить счёт клиенту прямо из диалога с агентом
- найти контакт поставщика вместе с вложениями
- сверить банковское движение с операцией в учёте
- посмотреть остатки товара по складам
- выгрузить проводки за нужный день
Примеры запросов агенту
- Покажи мои счета в Holded за прошлый месяц
- Создай счёт для клиента из этого чата и пришли PDF
- Проверь, прошла ли оплата по последнему счёту
Как установить mcp-holded
Командой платформы
claude mcp add mcp-holded -e HOLDED_API_KEY=<HOLDED_API_KEY> -- npx -y @nubiia/mcp-holdedВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-holded --env HOLDED_API_KEY=<HOLDED_API_KEY> -- npx -y @nubiia/mcp-holdedВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-holded": {
"command": "npx",
"args": [
"-y",
"@nubiia/mcp-holded"
],
"env": {
"HOLDED_API_KEY": "<HOLDED_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-holded": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nubiia/mcp-holded"
],
"env": {
"HOLDED_API_KEY": "<HOLDED_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HOLDED_API_KEY=<HOLDED_API_KEY> mcp-holded npx -y @nubiia/mcp-holdedВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-holded
Как установить mcp-holded в Claude Code?
Выполните claude mcp add mcp-holded -e HOLDED_API_KEY=<HOLDED_API_KEY> -- npx -y @nubiia/mcp-holded. Второй вариант — claude mcp add --env HOLDED_API_KEY=<HOLDED_API_KEY> --transport stdio mcp-holded -- npx -y @nubiia/mcp-holded.
Что делает mcp-holded?
Это MCP-сервер над Holded API v2: он открывает ассистенту 119 инструментов для счетов, контактов, товаров, казны, учёта и кадров.
Какой ключ нужен и что будет при 403?
Ключ API v2 из Holded → Settings → API, начинается с pat_ или sk_live_. Ответ 403 означает, что у ключа нет нужной области доступа.
