Oblio — MCP-сервер для Claude Code: что делает и как установить
Выставляет и отслеживает счета румынских компаний через Oblio API. Помогает контролировать оплату и рассчитывать суммы по правилам ANAF.
MIT ★ 5 обновлён 2026-10-29
claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioЧто делает Oblio
MCP-сервер подключается к сервису Oblio и позволяет управлять фискальными документами прямо из диалога с ассистентом. Через него можно получать списки клиентов, номенклатуру товаров, серии нумерации и актуальные ставки НДС. Сервер формирует счета и проформы, заносит данные об оплатах, а также отменяет или сторнирует документы.
В сервисе нет песочницы: каждый оформленный инвойс реален и сразу забирает следующий номер из рабочей серии. Для безопасности операции изменения фискальных документов требуют обязательного подтверждения от пользователя перед выполнением вызова.
Для запуска нужен Node 22.19 или новее. Конфигурация считывается из файла app.json через переменную окружения OBLIO_CONFIG. В нём обязательно должны быть указаны логин, секретный ключ API и налоговый идентификатор компании (CIF).
Какие задачи решает
- выставить инвойс или проформу клиенту
- проверить список неоплаченных счетов за период
- зафиксировать факт оплаты по номеру счёта
- сторнировать ошибочный фискальный документ
Примеры запросов агенту
- Какие инвойсы за сентябрь всё ещё не оплачены?
- Выстави счёт Client SRL на 8 часов консультаций по ставке 1000 RON в час плюс НДС 21%.
- Зафиксируй сегодняшнюю оплату счёта FCT 0042 банковским переводом на 1000 EUR.
Как установить Oblio
Командой платформы
claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioВместо <…> подставьте свои значения
Командой платформы
codex mcp add oblio --env OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"oblio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OBLIO_CONFIG=<OBLIO_CONFIG> oblio npx -y @foreverworks/mcp-oblioВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об Oblio
Как установить Oblio в Claude Code?
Выполните команду claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblio. Вместо <OBLIO_CONFIG> укажите путь к вашему файлу app.json.
Что делает MCP-сервер Oblio?
Он связывает окружение разработки с API сервиса Oblio для генерации румынских счетов, проверки статусов e-Factura и учёта поступления платежей.
Есть ли у сервера тестовый режим?
Песочница отсутствует. Созданные через сервер документы сразу получают статус официальных фискальных записей в выбранной серии.