fattureincloud-mcp — MCP-сервер для Claude Code: обзор и запуск
Подключает итальянский сервис FattureInCloud к AI-агентам для работы со счетами, отправки данных в систему SDI и учёта клиентов.
claude mcp add --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> --transport stdio fattureincloud-mcp -- uvx fattureincloud-mcpЧто делает fattureincloud-mcp
Сервер добавляет 23 инструмента для ведения бухгалтерии в FattureInCloud. Через чат с моделью можно собирать черновики счетов, дублировать акты за прошлые месяцы и проверять сплошную нумерацию. Инструмент отправляет готовые документы в государственную систему SDI или пересылает копии клиентам по почте.
Помимо выписки счетов поддерживается работа с входящими расходами поставщиков. Документы можно разносить по центрам затрат и запрашивать сводку с расчётом маржи. Список контрагентов кэшируется на сутки локально, чтобы не нагружать сеть повторными запросами.
Отметить счёт оплаченным через этот MCP-сервер не получится — API требует обязательного платёжного аккаунта, поэтому статусы оплат разработчик оставил только в веб-интерфейсе сервиса. Для подключения понадобятся числовой идентификатор компании и токен доступа из настроек FattureInCloud.
Какие задачи решает
- Сформировать черновик счёта с нужным центром выручки
- Отправить готовую фактуру в государственную систему SDI
- Проверить непрерывность нумерации выписанных документов
- Занести расходы поставщика с привязкой к центру затрат
Примеры запросов агенту
- Найди клиента Acme Srl и создай черновик счёта на 1500 евро без учёта НДС с оплатой через 30 дней
- Продублируй все октябрьские счета для Recurring Customer Co на ноябрь с теми же условиями
- Покажи финансовую сводку по доходам и расходам за 2025 год
Как установить fattureincloud-mcp
Командой платформы
claude mcp add --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> --transport stdio fattureincloud-mcp -- uvx fattureincloud-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fattureincloud-mcp <команда>
Командой платформы
codex mcp add fattureincloud-mcp --env FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> --env FIC_COMPANY_ID=<FIC_COMPANY_ID> --env FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> -- uvx fattureincloud-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fattureincloud-mcp <команда>
Файл настроек
{
"mcpServers": {
"fattureincloud-mcp": {
"command": "uvx",
"args": [
"fattureincloud-mcp"
],
"env": {
"FIC_ACCESS_TOKEN": "<FIC_ACCESS_TOKEN>",
"FIC_COMPANY_ID": "<FIC_COMPANY_ID>",
"FIC_SENDER_EMAIL": "<FIC_SENDER_EMAIL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fattureincloud-mcp <команда>
Файл настроек
{
"servers": {
"fattureincloud-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fattureincloud-mcp"
],
"env": {
"FIC_ACCESS_TOKEN": "<FIC_ACCESS_TOKEN>",
"FIC_COMPANY_ID": "<FIC_COMPANY_ID>",
"FIC_SENDER_EMAIL": "<FIC_SENDER_EMAIL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fattureincloud-mcp <команда>
Командой платформы
gemini mcp add -e FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> -e FIC_COMPANY_ID=<FIC_COMPANY_ID> -e FIC_SENDER_EMAIL=<FIC_SENDER_EMAIL> fattureincloud-mcp uvx fattureincloud-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from fattureincloud-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fattureincloud-mcp
Как установить fattureincloud-mcp в Claude Code?
Выполните команду в терминале: claude mcp add fattureincloud-mcp -e FIC_ACCESS_TOKEN=<FIC_ACCESS_TOKEN> -e FIC_COMPANY_ID=<FIC_COMPANY_ID> -- uvx fattureincloud-mcp.
Что делает этот MCP-сервер?
Он связывает модель с API FattureInCloud, позволяя управлять итальянскими электронными счетами, контрагентами и расходами на естественном языке.
Почему через сервер нельзя отметить счёт оплаченным?
API сервиса требует конкретный платёжный счёт, который трудно безошибочно выбрать автоматически, поэтому отметку о платеже нужно ставить вручную в веб-панели.
