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: einvoice-mcp

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.

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers

Tools

• categorize_transactionB
• create_attachmentB
• create_clientB
• create_invoiceA
• create_recurring_invoiceA
• create_transactionB
• delete_clientC
• generate_finanzamt_previewC