Норман Финанс MCP Сервер

Integrations

Supports configuration through .env files to store and manage Norman Finance credentials and environment settings.
Allows importing receipts from Cloudflare into the Norman Finance system, demonstrated in the Gmail receipts example.
Provides access to installation from source via GitHub repository, with examples linking to attachments hosted on GitHub.

Норман Финанс MCP Сервер

Этот сервер Model Context Protocol (MCP) позволяет ИИ взаимодействовать с API Norman Finance, обеспечивая доступ к бухгалтерскому учету, счетам, компаниям, клиентам, налогам и многому другому через стандартизированный протокол.

[!ПРИМЕЧАНИЕ]
Norman Finance MCP Server в настоящее время находится в стадии бета-тестирования. Мы приветствуем ваши отзывы и призываем вас сообщать о любых ошибках, открывая вопрос здесь .

Функции

🔐 Аутентификация : безопасная аутентификация с помощью учетной записи Norman Finance
💼 Управление компанией : управляйте данными своей компании, получайте баланс компании, налоговые декларации по НДС и т. д.
📊 Бухгалтерский учет : следите за своими транзакциями, категоризация
📝 (e-)Invoicing : Создавайте, просматривайте, отправляйте и обрабатывайте счета. Вы даже можете настроить повторяющиеся счета на основе ваших контрактов
👥 Управление клиентами : создание и управление клиентами (CRM)
💰 Налоги : просматривайте налоговую информацию и отчеты, создавайте официальные предварительные версии PDF-файлов Finanzamt и подавайте налоговые декларации
📄 Документы : загрузка и управление вложениями (квитанции, счета-фактуры, документы и т. д.)

👇 Примеры использования Claude Desktop — переключить

Предпосылки

Перед использованием этого MCP-сервера вам необходимо:

Создайте учетную запись на Norman Finance
Приготовьте свой адрес электронной почты и пароль для аутентификации.

Удаленный MCP-сервер

Теперь Norman предлагает размещенный удаленный сервер MCP по адресу:

https://mcp.norman.finance/sse

Рекомендуется использовать удаленный MCP, поскольку он использует аутентификацию OAuth, что позволяет вам входить в систему напрямую с помощью учетной записи Norman без необходимости вручную создавать или управлять токенами доступа.

Установка

Интеграции Claude.ai

Добавление сервера Norman MCP в Claude.ai:

Для Клода Макса:

Перейдите в Настройки > Профиль.
Найдите раздел «Интеграции»
Нажмите «Добавить еще»
Введите URL-адрес сервера Norman MCP: https://mcp.norman.finance/sse
Нажмите «Добавить», чтобы завершить.

Для Claude Enterprise и команд:

Перейдите в Настройки > Интеграции (для Teams) или Настройки > Управление данными (для Enterprise).
Найдите раздел «Интеграции»
Нажмите «Добавить еще»
Введите URL-адрес сервера Norman MCP: https://mcp.norman.finance/sse
Нажмите «Добавить», чтобы завершить.

Включение интеграции Norman:

Начать чат с Клодом.
Откройте меню «Поиск и инструменты» .
Нажмите «Подключиться», чтобы привязать свою учетную запись Norman.
После подключения используйте то же меню для включения определенных инструментов Norman.

Добавление в Claude Desktop

Чтобы запустить сервер Norman Finance MCP с Claude Desktop, вы можете воспользоваться приведенной выше инструкцией или добавить его вручную, выполнив следующие действия:

1. Загрузите и настройте Claude Desktop

Загрузите Claude Desktop .
Запустите Claude и перейдите в: Настройки > Разработчик > Изменить конфигурацию.
Обновите файл claude_desktop_config.json , указав следующую конфигурацию:

Удаленный MCP

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.norman.finance/sse"]
    }
  }
}

Местный МКП

Установить УФ

Следуйте инструкциям здесь: Установка УФ

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<home_path>/.local/bin/uvx",
      "args": [
        "--from",
        "norman-mcp-server@latest",
        "norman-mcp"
      ],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

Конфигурация

Методы аутентификации

Сервер Norman MCP поддерживает два метода аутентификации:

1. Аутентификация OAuth (для транспорта SSE)

При использовании сервера с MCP Inspector, Claude или другими клиентами SSE сервер использует аутентификацию OAuth 2.0:

Запустите сервер с транспортом SSE:
python -m norman_mcp --transport sse
При подключении к серверу вы будете перенаправлены на страницу входа
Введите свои учетные данные Norman Finance
Вы будете перенаправлены обратно в свое приложение с токенами аутентификации.

2. Переменные среды (для транспорта stdio)

При использовании сервера с Claude Desktop или связью stdin/stdout укажите учетные данные через переменные среды:

# .env
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment
NORMAN_API_TIMEOUT=200  # Request timeout in seconds

Переменные среды

Сервер можно настроить с помощью следующих переменных среды:

# Authentication (for stdio transport)
NORMAN_EMAIL=your-email@example.com
NORMAN_PASSWORD=your-password
NORMAN_ENVIRONMENT=production  # or "sandbox" for the development environment

# Server configuration
NORMAN_MCP_HOST=0.0.0.0  # Host to bind to
NORMAN_MCP_PORT=3001     # Port to bind to
NORMAN_MCP_PUBLIC_URL=http://example.com  # Public URL for OAuth callbacks (important for remote access)
NORMAN_API_TIMEOUT=200   # Request timeout in seconds

Разработка

Этот раздел предназначен для участников, желающих развивать или расширять сервер Norman Finance MCP.

Локальная установка

git clone https://github.com/norman-finance/norman-mcp-server.git
cd norman-mcp-server
pip install -e .

Затем обновите файл claude_desktop_config.json, чтобы он напрямую указывал на модуль Python:

{
  "mcpServers": {
    "norman-mcp-server": {
      "command": "<path_to_your_python>/python",
      "args": ["-m", "norman_mcp"],
      "env": {
        "NORMAN_EMAIL": "your-email@example.com",
        "NORMAN_PASSWORD": "your-password",
        "NORMAN_ENVIRONMENT": "production"
      }
    }
  }
}

У вас есть идея для статьи или что-то, что вы хотели бы увидеть? Поделитесь своим предложением

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Norman Finance — это автопилот для бухгалтерского учета и подачи налоговых деклараций, разработанный для предпринимателей в Германии. Сервер Norman Finance MCP обеспечивает новые способы взаимодействия с бухгалтерскими, налоговыми и счетными услугами Norman Finance. Упрощение финансовых рабочих процессов за счет интеграции возможностей API Norman Finance

Related MCP Servers

AlphaVantage-MCP
berlinbra
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
Last updated -
5
30
Python
MIT License
Ledger MCP Server
mprokopov
-
security
A
license
-
quality
An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.
Last updated -
1
Python
GPL 3.0
Yahoo Finance MCP Server
narumiruna
A
security
A
license
A
quality
A simple MCP server for Yahoo Finance using yfinance. This server provides a set of tools to fetch stock data, news, and other financial information.
Last updated -
10
9
Python
MIT License
mcp-mifosxofficial
openMF
-
security
F
license
-
quality
Integrate the MCP Server for Mifos X an Open Source Core Banking Solution for Financial Institutions. Useful for managing clients, loans, savings, shares, financial transactions and generating financial reports.
Last updated -
7

View all related MCP servers

Norman Finance MCP Server