SolidInvoice MCP Server
Встроенный MCP-сервер SolidInvoice: агент смотрит счета, клиентов и платежи и по разрешению создает новые счета.
- 982 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Права записи дают агенту создавать счета, записывать платежи и рассылать напоминания клиентам от вашего имени.
- Агент видит данные клиентов компании: имена, почту и суммы долга.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/solidinvoice-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Права записи дают агенту создавать счета, записывать платежи и рассылать напоминания клиентам от вашего имени.
- Агент видит данные клиентов компании: имена, почту и суммы долга.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
SolidInvoice — приложение для выставления счетов, и MCP-сервер встроен в него, отдельно ставить нечего. Агент подключается по адресу `/_mcp` вашего экземпляра или облачного `https://solidinvoice.app/_mcp`. Вход идет через OAuth 2.1: при согласии вы выбираете компанию и права, а ключи API нигде не вставляются. Права `mcp:read` хватает для списков счетов, смет, клиентов, налогов и платежей, а также для сводок: выручка за период, долг по клиенту, просроченные счета. Права `mcp:write` включают по желанию, и тогда агент создает счета и сметы, клонирует их, превращает смету в счет, записывает офлайн-платеж и отправляет напоминание. Подключение привязано к одной компании: данные другой компании агенту не видны, даже если вы состоите в обеих. Отозвать доступ можно на странице подключенных приложений профиля.
Для кого. Фрилансерам и малому бизнесу на SolidInvoice, которые хотят спросить агента про долги клиентов вместо того, чтобы листать списки счетов.
Подходит, если
- К концу месяца нужна выручка по неделям и список просроченных счетов одним запросом.
- Постоянному клиенту каждый месяц выставляют счет по той же смете, и его проще клонировать.
- Клиент прислал наличные, и платеж надо записать против нужного счета.
- Одобренную смету превращают в счет без повторного ввода строк.
Не подходит, если
- Приложения на другой системе учета: сервер работает только с SolidInvoice.
- Клиент агента не умеет OAuth с динамической регистрацией: статического ключа API здесь нет.
- Онлайн-оплату надо провести через платежный шлюз: инструмент записывает только офлайн-платежи.
Пример запроса к агенту
Покажи просроченные счета по всем клиентам и общий долг по каждой валюте.MCP
- Транспорт
- http
- Авторизация
- OAuth
Ограничения
Сервер принимает только клиентов с OAuth 2.1 и динамической регистрацией, статического ключа API нет. Самостоятельному экземпляру нужен HTTPS: без него вход через браузер завершится ошибкой. При работе на нескольких узлах хранилище сессий переключают с файлов на кэш. Перед запуском один раз создают ключи подписи командой `bin/console mcp:keys:generate`. Агент действует от имени пользователя и в выбранной компании, а право записи включают отдельной галочкой. Токен доступа живет 24 часа, токен обновления 90 дней.
Как отключить. Отзовите агента на странице `Profile → Connected apps` в SolidInvoice, доступ закроется сразу. Из клиента сервер удаляют командой `claude mcp remove solidinvoice`.
Частые вопросы
Как подключить SolidInvoice к Claude Code?
Выполните `claude mcp add --transport http solidinvoice https://solidinvoice.app/_mcp`, для своего экземпляра замените адрес. Первый вызов откроет браузер с экраном согласия, где выбирают компанию и права.
Нужен ли ключ API?
Нет. Доступ выдается через OAuth 2.1 на экране согласия, а статического ключа в сервере нет намеренно.
Может ли агент удалять данные?
Только при праве `mcp:write`: тогда доступны `delete_resource` для клиентов, контактов и налогов и смена статусов счетов. Если нужно только чтение, не ставьте галочку записи.
Работает ли сервер с облаком и с собственной установкой?
Да, с обоими. Адрес всегда оканчивается на `/_mcp`, а на собственном сервере нужен HTTPS и ключи подписи из `mcp:keys:generate`.
Как отозвать доступ агента?
Откройте `Profile → Connected apps` в SolidInvoice и отзовите агента. Токены перестают действовать сразу, следующий запрос вернет `401 invalid_token`, и понадобится новое согласие.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный локальный MCP-сервер Intuit: агент ищет и создает счета, платежи и контрагентов в QuickBooks Online, строит отчеты
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
MCP-сервер 1С:Фреш на Python
1c-fresh-mcp
MCP-сервер для 1С:Фреш через стандартный OData: счета, продажи, контрагенты, обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента
MCP-сервер для JSON API 1.2 МойСклад: остатки, заказы, отчеты о прибыли и создание документов за двумя уровнями защиты
Коротко о README
Документация сервера лежит в `docs/docs/ai/mcp-server.mdx`: адрес, схема OAuth, настройка для Claude Desktop, Claude Code, Cursor, Codex и Goose, таблицы инструментов чтения и записи. Есть раздел про запуск на своем сервере и разбор типичных ошибок.