Norman Finance MCP Server

Official
MIT License
4
  • Linux
  • Apple
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.

Norman Finance MCP-Server

Dieser Model Context Protocol (MCP) -Server ermöglicht der KI die Interaktion mit der Norman Finance API und ermöglicht über ein standardisiertes Protokoll den Zugriff auf Buchhaltung, Rechnungen, Unternehmen, Kunden, Steuern und mehr.

[!NOTIZ]

Der Norman Finance MCP-Server befindet sich derzeit in der Betaphase. Wir freuen uns über Ihr Feedback und bitten Sie, etwaige Fehler hier zu melden.

Merkmale

  • 🔐 Authentifizierung : Sichere Authentifizierung mit dem Norman Finance-Konto
  • 💼 Unternehmensverwaltung : Verwalten Sie Ihre Unternehmensdaten, erhalten Sie Unternehmensbilanz, Mehrwertsteuerabrechnungen usw.
  • 📊 Buchhaltung : Behalten Sie Ihre Transaktionen im Auge, Kategorisierung
  • 📝 (E-)Rechnung : Erstellen, Anzeigen, Senden und Bearbeiten von Rechnungen. Sie können sogar wiederkehrende Rechnungen basierend auf Ihren Verträgen einrichten.
  • 👥 Kundenverwaltung : Erstellen und verwalten Sie Ihre Kunden (CRM)
  • 💰 Steuern : Sehen Sie sich Steuerinformationen und -berichte an, erstellen Sie offizielle PDF-Vorschauen des Finanzamts und reichen Sie Ihre Steuern ein
  • 📄 Dokumente : Anhänge hochladen und verwalten (Quittungen, Rechnungen, Dokumente usw.)

👇 Anwendungsbeispiele mit Claude Desktop – umschalten

Voraussetzungen

Bevor Sie diesen MCP-Server verwenden, müssen Sie:

  1. Erstellen Sie ein Konto bei Norman Finance
  2. Halten Sie Ihre E-Mail-Adresse und Ihr Passwort zur Authentifizierung bereit

Remote-MCP-Server

Norman bietet jetzt einen gehosteten Remote-MCP-Server an unter:

https://mcp.norman.finance/sse

Das Remote-MCP wird empfohlen, da es die OAuth-Authentifizierung verwendet und Ihnen die direkte Anmeldung mit Ihrem Norman-Konto ermöglicht, ohne dass Sie Zugriffstoken manuell erstellen oder verwalten müssen.

Installation

Claude.ai-Integrationen

Hinzufügen des Norman MCP-Servers zu Claude.ai:

Für Claude Max:

  1. Gehen Sie zu Einstellungen > Profil
  2. Suchen Sie den Abschnitt „Integrationen“
  3. Tippen Sie auf „Mehr hinzufügen“
  4. Geben Sie die URL des Norman MCP-Servers ein: https://mcp.norman.finance/sse
  5. Klicken Sie zum Abschluss auf „Hinzufügen“.

Für Claude Enterprise & Teams:

  1. Gehen Sie zu Einstellungen > Integrationen (für Teams) oder Einstellungen > Datenverwaltung (für Enterprise).
  2. Suchen Sie den Abschnitt „Integrationen“
  3. Klicken Sie auf „Mehr hinzufügen“
  4. Geben Sie die URL des Norman MCP-Servers ein: https://mcp.norman.finance/sse
  5. Klicken Sie zum Abschluss auf „Hinzufügen“.

Aktivieren der Norman-Integration:

  1. Starten Sie einen Chat mit Claude.
  2. Öffnen Sie das Menü „Suche und Tools“ .
  3. Klicken Sie auf „Verbinden“, um Ihr Norman-Konto zu verknüpfen.
  4. Verwenden Sie nach dem Herstellen der Verbindung dasselbe Menü, um bestimmte Norman-Tools zu aktivieren.

Hinzufügen zu Claude Desktop

Um den Norman Finance MCP-Server mit Claude Desktop auszuführen, können Sie die obige Anleitung verwenden oder ihn mit den folgenden Schritten manuell hinzufügen:

1. Claude Desktop herunterladen und konfigurieren
  1. Laden Sie Claude Desktop herunter.
  2. Starten Sie Claude und navigieren Sie zu: Einstellungen > Entwickler > Konfiguration bearbeiten.
  3. Aktualisieren Sie Ihre Datei claude_desktop_config.json mit der folgenden Konfiguration:
Remote-MCP
{ "mcpServers": { "norman-mcp-server": { "command": "npx", "args": ["mcp-remote", "https://mcp.norman.finance/sse"] } } }
Lokales MCP
UV installieren

Folgen Sie den Anweisungen hier: Installation von uv

{ "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" } } } }

Konfiguration

Authentifizierungsmethoden

Der Norman MCP-Server unterstützt zwei Authentifizierungsmethoden:

1. OAuth-Authentifizierung (für SSE-Transport)

Wenn Sie den Server mit MCP Inspector, Claude oder anderen SSE-Clients verwenden, verwendet der Server die OAuth 2.0-Authentifizierung:

  1. Starten Sie den Server mit SSE-Transport:
    python -m norman_mcp --transport sse
  2. Wenn Sie sich mit dem Server verbinden, werden Sie auf eine Anmeldeseite weitergeleitet
  3. Geben Sie Ihre Norman Finance-Anmeldeinformationen ein
  4. Sie werden mit Authentifizierungstoken zurück zu Ihrer Anwendung geleitet
2. Umgebungsvariablen (für den Standardtransport)

Wenn Sie den Server mit Claude Desktop oder stdin/stdout-Kommunikation verwenden, geben Sie die Anmeldeinformationen über Umgebungsvariablen an:

# .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

Umgebungsvariablen

Der Server kann mit diesen Umgebungsvariablen konfiguriert werden:

# 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

Entwicklung

Dieser Abschnitt richtet sich an Mitwirkende, die den Norman Finance MCP-Server weiterentwickeln oder erweitern möchten.

Lokale Einrichtung

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

Aktualisieren Sie dann Ihre Datei claude_desktop_config.json, um direkt auf das Python-Modul zu verweisen:

{ "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" } } } }

Haben Sie eine Idee für eine Funktion oder etwas, das Sie gerne sehen würden? Teilen Sie uns Ihren Vorschlag mit


You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

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

Norman Finance ist ein Autopilot für Buchhaltung und Steuererklärungen, der speziell für Unternehmer in Deutschland entwickelt wurde. Der Norman Finance MCP-Server ermöglicht neue Möglichkeiten der Interaktion mit den Buchhaltungs-, Steuer- und Rechnungsservices von Norman Finance. Vereinfachung der Finanzabläufe durch die Integration der Norman Finance API-Funktionen

  1. Merkmale
    1. 👇 Anwendungsbeispiele mit Claude Desktop – umschalten
  2. Voraussetzungen
    1. Remote-MCP-Server
      1. Installation
        1. Claude.ai-Integrationen
        2. Hinzufügen zu Claude Desktop
      2. Konfiguration
        1. Authentifizierungsmethoden
        2. Umgebungsvariablen
      3. Entwicklung
        1. Lokale Einrichtung

      Related MCP Servers

      • 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
        • Apple
      • -
        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
        • Apple
      • 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
      • -
        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

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/norman-finance/norman-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server