Норман Финанс 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"
      }
    }
  }
}

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

Norman Finance MCP Server