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

Related MCP server: Nornir MCP Server

Voraussetzungen

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

Erstellen Sie ein Konto bei Norman Finance
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:

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

Für Claude Enterprise & Teams:

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

Aktivieren der Norman-Integration:

Starten Sie einen Chat mit Claude.
Öffnen Sie das Menü „Suche und Tools“ .
Klicken Sie auf „Verbinden“, um Ihr Norman-Konto zu verknüpfen.
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

Laden Sie Claude Desktop herunter.
Starten Sie Claude und navigieren Sie zu: Einstellungen > Entwickler > Konfiguration bearbeiten.
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:

Starten Sie den Server mit SSE-Transport:
python -m norman_mcp --transport sse
Wenn Sie sich mit dem Server verbinden, werden Sie auf eine Anmeldeseite weitergeleitet
Geben Sie Ihre Norman Finance-Anmeldeinformationen ein
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