fortnox — MCP-сервер для Claude Code: счета и бухгалтерия Fortnox
Подключает Fortnox к ИИ-агенту: счета, клиенты, поставщики, проводки и аналитика прямо из чата. Пригодится, если бухгалтерия ведётся в шведской Fortnox.
claude mcp add fortnox -e FORTNOX_CLIENT_ID=<FORTNOX_CLIENT_ID> -e FORTNOX_CLIENT_SECRET=<FORTNOX_CLIENT_SECRET> -e FORTNOX_REFRESH_TOKEN=<FORTNOX_REFRESH_TOKEN> -- npx -y fortnox-mcp-serverЧто делает fortnox
Сервер даёт агенту доступ к Fortnox через MCP. Он умеет вести клиентов и поставщиков, выставлять и править счета, оформлять кредит-ноты, отправлять счета письмом, работать с заказами, счетами поставщиков и планом счетов. Отдельный блок — аналитика: сводка по счетам за период, топ клиентов по выручке, отчёт по неоплаченным, прогноз денежного потока, воронка продаж от предложений до счетов, сравнение периодов и динамика маржи.
Есть два режима. Удалённый — просто адрес https://fortnox-mcp.vercel.app/mcp и авторизация в браузере, своих ключей не нужно. Локальный — для самостоятельного хостинга: понадобятся FORTNOX_CLIENT_ID, FORTNOX_CLIENT_SECRET и FORTNOX_REFRESH_TOKEN из портала разработчиков Fortnox. Транспорт по умолчанию stdio, можно переключить на http и задать PORT.
Локальный запуск идёт через npx -y fortnox-mcp-server. Refresh-токен нужен только на старте: дальше он сохраняется сам, а access-токен обновляется автоматически. Если вы разворачиваете удалённый режим у себя, придётся задать AUTH_MODE=remote, SERVER_URL и JWT_SECRET — без них сервер не поднимется.
Какие задачи решает
- выставить счёт клиенту и отправить его письмом
- найти всех клиентов с неоплаченными счетами
- сделать кредит-ноту по ошибочному счёту
- сверить план счетов и создать ручную проводку
- посчитать выручку по топовым клиентам за квартал
Примеры запросов агенту
- Покажи неоплаченные счета за прошлый месяц
- Создай счёт для клиента и отправь его на почту
- Сравни выручку этого года с прошлым
Как установить fortnox
Командой платформы
claude mcp add fortnox -e FORTNOX_CLIENT_ID=<FORTNOX_CLIENT_ID> -e FORTNOX_CLIENT_SECRET=<FORTNOX_CLIENT_SECRET> -e FORTNOX_REFRESH_TOKEN=<FORTNOX_REFRESH_TOKEN> -- npx -y fortnox-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add fortnox --env FORTNOX_CLIENT_ID=<FORTNOX_CLIENT_ID> --env FORTNOX_CLIENT_SECRET=<FORTNOX_CLIENT_SECRET> --env FORTNOX_REFRESH_TOKEN=<FORTNOX_REFRESH_TOKEN> -- npx -y fortnox-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"fortnox": {
"command": "npx",
"args": [
"-y",
"fortnox-mcp-server"
],
"env": {
"FORTNOX_CLIENT_ID": "<FORTNOX_CLIENT_ID>",
"FORTNOX_CLIENT_SECRET": "<FORTNOX_CLIENT_SECRET>",
"FORTNOX_REFRESH_TOKEN": "<FORTNOX_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"fortnox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fortnox-mcp-server"
],
"env": {
"FORTNOX_CLIENT_ID": "<FORTNOX_CLIENT_ID>",
"FORTNOX_CLIENT_SECRET": "<FORTNOX_CLIENT_SECRET>",
"FORTNOX_REFRESH_TOKEN": "<FORTNOX_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FORTNOX_CLIENT_ID=<FORTNOX_CLIENT_ID> -e FORTNOX_CLIENT_SECRET=<FORTNOX_CLIENT_SECRET> -e FORTNOX_REFRESH_TOKEN=<FORTNOX_REFRESH_TOKEN> fortnox npx -y fortnox-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fortnox
Как установить fortnox в Claude Code?
Выполните `claude mcp add fortnox -e FORTNOX_CLIENT_ID=<FORTNOX_CLIENT_ID> -e FORTNOX_CLIENT_SECRET=<FORTNOX_CLIENT_SECRET> -e FORTNOX_REFRESH_TOKEN=<FORTNOX_REFRESH_TOKEN> -- npx -y fortnox-mcp-server`. Подставьте свои значения из портала разработчиков Fortnox.
Что делает fortnox?
Даёт агенту инструменты Fortnox: клиенты, счета, поставщики, заказы, план счетов, проводки и отчёты. Плюс аналитика вроде прогноза денежного потока и воронки продаж.
Можно обойтись без своих ключей Fortnox?
Да, в удалённом режиме достаточно добавить адрес https://fortnox-mcp.vercel.app/mcp и авторизоваться в браузере. Свои FORTNOX_CLIENT_ID и FORTNOX_CLIENT_SECRET нужны только для локального хостинга.
