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

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

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

Функции

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

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

Related MCP server: Nornir MCP Server

Предпосылки

Перед использованием этого 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" } } } }

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