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.

Servidor MCP de Norman Finance

Este servidor de Protocolo de Contexto de Modelo (MCP) permite que la IA interactúe con la API de Norman Finance, lo que permite el acceso a contabilidad, facturas, empresas, clientes, impuestos y más a través de un protocolo estandarizado.

[!NOTA]

El servidor MCP de Norman Finance se encuentra actualmente en fase beta. Agradecemos sus comentarios y le animamos a informar cualquier error abriendo un problema aquí .

Características

  • 🔐 Autenticación : Autenticación segura con la cuenta de Norman Finance
  • 💼 Gestión de la empresa : gestione los datos de su empresa, obtenga el saldo de la empresa, los datos del IVA, etc.
  • 📊 Contabilidad : Vigila tus transacciones, categorización
  • Facturación electrónica : Crea, consulta, envía y gestiona facturas. Incluso puedes configurar facturas recurrentes según tus contratos.
  • 👥 Gestión de clientes : Crea y gestiona tus clientes (CRM)
  • 💰 Impuestos : Consulta información e informes fiscales, genera vistas previas oficiales en PDF de Finanzamt y presenta tus impuestos
  • 📄 Documentos : Sube y gestiona archivos adjuntos (recibos, facturas, documentos, etc.)

👇 Ejemplos de casos de uso con Claude Desktop — alternar

Prerrequisitos

Antes de utilizar este servidor MCP, necesita:

  1. Crea una cuenta en Norman Finance
  2. Tenga a mano su correo electrónico y contraseña para la autenticación.

Servidor MCP remoto

Norman ahora ofrece un servidor MCP remoto alojado en:

https://mcp.norman.finance/sse

Se recomienda el MCP remoto porque utiliza autenticación OAuth, lo que le permite iniciar sesión directamente con su cuenta de Norman sin la necesidad de crear o administrar tokens de acceso manualmente.

Instalación

Integraciones de Claude.ai

Agregar el servidor Norman MCP a Claude.ai:

Para Claude Max:

  1. Dirígete a Configuración > Perfil
  2. Encuentra la sección "Integraciones"
  3. Pulsa "Añadir más"
  4. Ingrese la URL del servidor Norman MCP: https://mcp.norman.finance/sse
  5. Haga clic en "Agregar" para finalizar.

Para Claude Enterprise y Teams:

  1. Vaya a Configuración > Integraciones (para Teams) o Configuración > Gestión de datos (para Enterprise)
  2. Encuentra la sección "Integraciones"
  3. Haz clic en "Añadir más"
  4. Ingrese la URL del servidor Norman MCP: https://mcp.norman.finance/sse
  5. Haga clic en "Agregar" para finalizar.

Habilitación de la integración de Norman:

  1. Inicie un chat con Claude.
  2. Abra el menú Buscar y herramientas .
  3. Haga clic en "Conectar" para vincular su cuenta de Norman.
  4. Después de conectarse, use el mismo menú para activar herramientas Norman específicas.

Añadiendo a Claude Desktop

Para ejecutar el servidor Norman Finance MCP con Claude Desktop, puede utilizar las instrucciones anteriores o agregarlo manualmente siguiendo los siguientes pasos:

1. Descargue y configure Claude Desktop
  1. Descargar Claude Desktop .
  2. Inicie Claude y navegue a: Configuración > Desarrollador > Editar configuración.
  3. Actualice su archivo claude_desktop_config.json con la siguiente configuración:
MCP remoto
{ "mcpServers": { "norman-mcp-server": { "command": "npx", "args": ["mcp-remote", "https://mcp.norman.finance/sse"] } } }
MCP local
Instalar uv

Siga las instrucciones aquí: Instalación de 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" } } } }

Configuración

Métodos de autenticación

El servidor Norman MCP admite dos métodos de autenticación:

1. Autenticación OAuth (para transporte SSE)

Al utilizar el servidor con MCP Inspector, Claude u otros clientes SSE, el servidor utiliza la autenticación OAuth 2.0:

  1. Inicie el servidor con el transporte SSE:
    python -m norman_mcp --transport sse
  2. Al conectarse al servidor, se le dirigirá a una página de inicio de sesión.
  3. Ingrese sus credenciales de Norman Finance
  4. Serás redirigido nuevamente a tu aplicación con tokens de autenticación.
2. Variables de entorno (para el transporte de stdio)

Al utilizar el servidor con Claude Desktop o comunicación stdin/stdout, proporcione las credenciales a través de variables de entorno:

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

Variables de entorno

El servidor se puede configurar utilizando estas variables de entorno:

# 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

Desarrollo

Esta sección es para colaboradores que quieran desarrollar o ampliar el servidor MCP de Norman Finance.

Configuración local

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

Luego actualice su archivo claude_desktop_config.json para que apunte directamente al módulo 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" } } } }

¿Tienes alguna idea o algo que te gustaría ver? Comparte tu sugerencia.


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 es un sistema automatizado de contabilidad y declaración de impuestos diseñado para emprendedores en Alemania. El servidor MCP de Norman Finance facilita nuevas formas de interactuar con los servicios de contabilidad, impuestos y facturación de Norman Finance. Simplifica los flujos de trabajo financieros mediante la integración de las funciones de la API de Norman Finance.

  1. Características
    1. 👇 Ejemplos de casos de uso con Claude Desktop — alternar
  2. Prerrequisitos
    1. Servidor MCP remoto
      1. Instalación
        1. Integraciones de Claude.ai
        2. Añadiendo a Claude Desktop
      2. Configuración
        1. Métodos de autenticación
        2. Variables de entorno
      3. Desarrollo
        1. Configuración local

      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