# Norman MCP Server

Связывает Claude Code с учётными данными компании в Norman: агент может готовить счета, разбирать чеки и сверять операции. Пригодится для бухгалтерских задач в Германии и Польше.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 62
- Автор: norman-finance
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/norman-finance/norman-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/norman-mcp-server

## Что делает

Сервер подключает ИИ-ассистента к данным компании в Norman. Через него можно создавать счета и предложения, распределять чеки, проверять транзакции и готовить налоговые отчёты. Для работы с другой компанией предусмотрены `list_companies` и `switch_company`.

В Германии доступны предварительная подготовка деклараций и отправка поддерживаемых форм после подтверждения. Для Польши сервер показывает реестры и статус подачи, но не подписывает и не отправляет декларации. Это различие важно: польскую подачу через MCP выполнить нельзя.

Для удалённого подключения используется HTTP-адрес `https://mcp.norman.finance/mcp` и OAuth. В Claude Code сервер также можно добавить командой `claude mcp add`; для локального варианта нужны значения `NORMAN_EMAIL`, `NORMAN_PASSWORD` и `NORMAN_ENVIRONMENT`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mcp.norman.finance/mcp`
- Переменные окружения: `NORMAN_EMAIL`, `NORMAN_PASSWORD`, `NORMAN_ENVIRONMENT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp-server https://mcp.norman.finance/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env NORMAN_EMAIL=<NORMAN_EMAIL> --env NORMAN_PASSWORD=<NORMAN_PASSWORD> --env NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> --transport stdio norman-mcp-server -- uvx norman-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from norman-mcp-server <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add norman-mcp-server --url https://mcp.norman.finance/mcp
```

2. **Командой платформы**
```bash
codex mcp add norman-mcp-server --env NORMAN_EMAIL=<NORMAN_EMAIL> --env NORMAN_PASSWORD=<NORMAN_PASSWORD> --env NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> -- uvx norman-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from norman-mcp-server <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "norman-mcp-server": {
            "url": "https://mcp.norman.finance/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "norman-mcp-server": {
            "command": "uvx",
            "args": [
                "norman-mcp-server"
            ],
            "env": {
                "NORMAN_EMAIL": "<NORMAN_EMAIL>",
                "NORMAN_PASSWORD": "<NORMAN_PASSWORD>",
                "NORMAN_ENVIRONMENT": "<NORMAN_ENVIRONMENT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from norman-mcp-server <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "norman-mcp-server": {
            "type": "http",
            "url": "https://mcp.norman.finance/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "norman-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "norman-mcp-server"
            ],
            "env": {
                "NORMAN_EMAIL": "<NORMAN_EMAIL>",
                "NORMAN_PASSWORD": "<NORMAN_PASSWORD>",
                "NORMAN_ENVIRONMENT": "<NORMAN_ENVIRONMENT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from norman-mcp-server <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http norman-mcp-server https://mcp.norman.finance/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e NORMAN_EMAIL=<NORMAN_EMAIL> -e NORMAN_PASSWORD=<NORMAN_PASSWORD> -e NORMAN_ENVIRONMENT=<NORMAN_ENVIRONMENT> norman-mcp-server uvx norman-mcp-server
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from norman-mcp-server <команда>

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

## Примеры запросов агенту
- Создай черновик счёта за консультацию с брендингом компании.
- Найди транзакции, к которым не прикреплён чек.
- Покажи реестр JPK польской компании и объясни исключённые операции.

## Похожие
- [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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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