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

Related MCP server: Nornir MCP Server

Prerrequisitos

Antes de utilizar este servidor MCP, necesita:

Crea una cuenta en Norman Finance
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:

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

Para Claude Enterprise y Teams:

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

Habilitación de la integración de Norman:

Inicie un chat con Claude.
Abra el menú Buscar y herramientas .
Haga clic en "Conectar" para vincular su cuenta de Norman.
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

Descargar Claude Desktop .
Inicie Claude y navegue a: Configuración > Desarrollador > Editar configuración.
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:

Inicie el servidor con el transporte SSE:
python -m norman_mcp --transport sse
Al conectarse al servidor, se le dirigirá a una página de inicio de sesión.
Ingrese sus credenciales de Norman Finance
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.