Norman MCP Server — MCP-сервер для Claude Code: учёт и установка
Связывает Claude Code с учётными данными компании в Norman: агент может готовить счета, разбирать чеки и сверять операции. Пригодится для бухгалтерских задач в Германии и Польше.
claude mcp add --transport http mcp-server https://mcp.norman.finance/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.
Какие задачи решает
- создать счёт с данными компании
- найти транзакции без чека
- сверить бухгалтерские операции
- подготовить предварительный расчёт НДС
- проверить статус польской подачи
Примеры запросов агенту
- Создай черновик счёта за консультацию с брендингом компании.
- Найди транзакции, к которым не прикреплён чек.
- Покажи реестр JPK польской компании и объясни исключённые операции.
Как установить Norman MCP Server
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp-server https://mcp.norman.finance/mcp2Командой платформы
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 <команда>
1Командой платформы: удалённый сервер
codex mcp add norman-mcp-server --url https://mcp.norman.finance/mcp2Командой платформы
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 <команда>
Файл настроек
{
"mcpServers": {
"norman-mcp-server": {
"url": "https://mcp.norman.finance/mcp"
}
}
}{
"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 <команда>
Файл настроек
{
"servers": {
"norman-mcp-server": {
"type": "http",
"url": "https://mcp.norman.finance/mcp"
}
}
}{
"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 <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http norman-mcp-server https://mcp.norman.finance/mcp2Командой платформы
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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Norman MCP Server
Как установить Norman MCP Server в Claude Code?
Добавьте удалённый MCP-сервер командой claude mcp add --transport http mcp-server https://mcp.norman.finance/mcp, затем завершите OAuth-подключение и выберите компанию.
Что делает Norman MCP Server?
Он подключает ассистента к учётным данным Norman: помогает создавать счета, разбирать чеки, сверять операции и готовить налоговые документы.
Можно ли отправить декларацию через Norman MCP Server в Польше?
Сервер позволяет просматривать польские реестры и статус подачи, но не подписывает и не отправляет декларации. Для поддерживаемых немецких форм отправка доступна после предварительной проверки и подтверждения.
