# fortnox

Подключает Fortnox к ИИ-агенту: счета, клиенты, поставщики, проводки и аналитика прямо из чата. Пригодится, если бухгалтерия ведётся в шведской Fortnox.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 45
- Автор: erp-mafia
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/erp-mafia/fortnox-mcp
- Обновлён: 2026-04-28
- HTML: https://affpapa.org/nevibecode/mcp/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` — без них сервер не поднимется.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `FORTNOX_CLIENT_ID`, `FORTNOX_CLIENT_SECRET`, `FORTNOX_REFRESH_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- выставить счёт клиенту и отправить его письмом
- найти всех клиентов с неоплаченными счетами
- сделать кредит-ноту по ошибочному счёту
- сверить план счетов и создать ручную проводку
- посчитать выручку по топовым клиентам за квартал

## Примеры запросов агенту
- Покажи неоплаченные счета за прошлый месяц
- Создай счёт для клиента и отправь его на почту
- Сравни выручку этого года с прошлым

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md