How do I install MCP Freematica?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Freematica need an API key?

The publisher lists these environment variables: FREEMATICA_AUTH_TOKEN, FREEMATICA_AUTH_COMPANY, FREEMATICA_AUTH_ORGANIZATION, FREEMATICA_AUTH_APP, FREEMATICA_AUTH_SESSION, FREEMATICA_ENABLE_WRITES, FREEMATICA_BASE_URL.

What transport does MCP Freematica use?

MCP Freematica runs locally over stdio.

When was MCP Freematica last checked?

Last checked 2026-11-10. Freemática ERP: invoicing, receivables, suppliers, accounting and HR through 300+ MCP tools

MCP Freematica MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @nubiia/[email protected]

Credentials from the publisher

FREEMATICA_AUTH_TOKEN — Freemática API token (x-auth-token header).
FREEMATICA_AUTH_COMPANY — Freemática company identifier (x-auth-company header).
FREEMATICA_AUTH_ORGANIZATION — Freemática organization identifier (x-auth-organization header).
FREEMATICA_AUTH_APP — Freemática consuming application, e.g. pvss (x-auth-app header).
FREEMATICA_AUTH_SESSION — Freemática active session (x-auth-session header).
FREEMATICA_ENABLE_WRITES — Set to true to register the create/update tools. Read-only by default.
FREEMATICA_BASE_URL — Freemática API base URL. Change only for an alternative host.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1FREEMATICA_AUTH_TOKEN=<secret> FREEMATICA_AUTH_COMPANY=<value> FREEMATICA_AUTH_ORGANIZATION=<value> FREEMATICA_AUTH_APP=<value> FREEMATICA_AUTH_SESSION=<secret> FREEMATICA_ENABLE_WRITES=<value> FREEMATICA_BASE_URL=<value> claude mcp add io.github.nubiia-dev-mcp-freematica -- npx -y @nubiia/mcp-freematica@0.11.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.nubiia-dev-mcp-freematica": {4      "command": "npx",5      "args": [6        "-y",7        "@nubiia/[email protected]"8      ],9      "env": {10        "FREEMATICA_AUTH_TOKEN": "<secret>",11        "FREEMATICA_AUTH_COMPANY": "<value>",12        "FREEMATICA_AUTH_ORGANIZATION": "<value>",13        "FREEMATICA_AUTH_APP": "<value>",14        "FREEMATICA_AUTH_SESSION": "<secret>",15        "FREEMATICA_ENABLE_WRITES": "<value>",16        "FREEMATICA_BASE_URL": "<value>"17      }18    }19  }20}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

From the publisher

Documentation

mcp-freematica

MCP server que expone operaciones del API REST de Freemática (ERP: facturación, cartera, proveedores, contabilidad, personal) para ser consumidas por asistentes de IA como Claude.

Tool	Endpoint Freemática	Descripción
`freematica_list_articulos`	`GET /part/v1/articulos`	Catálogo de artículos/materiales/consumibles (referencias, familias, proveedores)
`freematica_get_articulo`	`GET /part/v1/articulos/{idreg}`	Detalle de un artículo
`freematica_get_precio_articulo`	`GET /pgrl/v1/precio-articulo/{idreg}`	Precios de venta de un artículo (PRECIO_VENTA, DESCUENTO, FACTURABLE)
`freematica_list_materiales_asignados_servicios`	`GET /pvss/v2/contratos-servicios-material`	Lista de material asignado a servicios
`freematica_get_master_data`	(24 endpoints según `catalog`)	Devuelve un catálogo de datos maestros (tipos, geográficos, organizativos, inventario, financiero)
`freematica_list_clientes`	`GET /pgrl/v2/clientes`	Lista paginada de clientes
`freematica_get_cliente`	`GET /pgrl/v2/clientes/{idReg}`	Detalle de un cliente
`freematica_list_contactos_clientes`	`GET /pgrl/v2/contactos-clientes`	Lista paginada de contactos
`freematica_list_oportunidades_negocio`	`GET /pcrm/v2/oportunidades-negocio`	Lista paginada de oportunidades
`freematica_get_oportunidad_negocio`	`GET /pcrm/v2/oportunidades-negocio/{idReg}`	Detalle de oportunidad
`freematica_get_oportunidad_negocio_datos_ampliados`	`GET /pcrm/v2/oportunidades-negocio/{idReg}/datos-ampliados`	Datos ampliados (puede 404)
`freematica_get_ficha_prev_cliente`	`GET /pprl/v2/ficha-prev-cliente`	Ficha PRL de un cliente
`freematica_list_vigilancia_salud`	`GET /pprl/v1/vigilancia-salud`	Lista paginada de registros de Vigilancia de la Salud
`freematica_get_vigilancia_salud`	`GET /pprl/v1/vigilancia-salud/{idreg}`	Detalle de un registro de Vigilancia de la Salud
`freematica_list_personal`	`GET /pers/v1/personal`	Lista paginada de personas (RRHH)
`freematica_get_persona`	`GET /pers/v2/personal/{idreg}`	Detalle de una persona
`freematica_list_calendarios`	`GET /pgrl/v1/calendarios`	Lista paginada de calendarios laborales
`freematica_list_calendario_periodos`	`GET /pgrl/v1/calendarios/{idreg}/periodos`	Periodos de un calendario laboral
`freematica_list_cartera_clientes`	`GET /pcar/v1/cartera-clientes`	Lista paginada de cartera de clientes (cobros, impagados)
`freematica_get_cartera_cliente`	`GET /pcar/v1/cartera-clientes/{idReg}`	Detalle de un documento de cartera
`freematica_list_facturas_cabecera`	`GET /pven/v1/facturas-cabecera`	Lista paginada de facturas de ventas (cabecera)
`freematica_get_factura_cabecera`	`GET /pven/v1/facturas-cabecera/{idReg}`	Detalle de una factura de venta
`freematica_list_factura_lineas`	`GET /pven/v1/facturas-cabecera/{idReg}/lineas`	Líneas de detalle de una factura de venta
`freematica_list_factura_iva`	`GET /pven/v1/facturas-cabecera/{idReg}/iva`	Líneas de IVA de una factura de venta
`freematica_list_factura_vencimientos`	`GET /pven/v1/facturas-cabecera/{idReg}/vencimientos`	Vencimientos de cobro de una factura de venta
`freematica_list_facturas_compras`	`GET /pcom/v1/facturas-cabecera`	Lista paginada de facturas de compras
`freematica_get_factura_compra`	`GET /pcom/v1/facturas-cabecera/{idReg}`	Detalle de una factura de compra
`freematica_list_proveedores`	`GET /pgrl/v2/proveedores`	Lista paginada de proveedores
`freematica_get_proveedor`	`GET /pgrl/v2/proveedores/{idReg}`	Detalle de un proveedor
`freematica_list_localizaciones_cobro_clientes`	`GET /pgrl/v2/localizaciones-cobro-clientes`	Localizaciones de cobro de clientes (SEPA, domiciliaciones)
`freematica_list_localizaciones_pago_proveedores`	`GET /pgrl/v2/localizaciones-pago-proveedores`	Localizaciones de pago de proveedores
`freematica_list_localizaciones_servicio_clientes`	`GET /pgrl/v2/localizaciones-servicio-clientes`	Localizaciones de servicio de clientes
`freematica_list_cuentas_contables`	`GET /pcon/v2/cuentas`	Plan de cuentas contables (COD_CTA, COD_PLAN, etc.)
`freematica_list_cuentas_analiticas`	`GET /pcon/v2/cuentas-analiticas`	Catálogo de cuentas analíticas
`freematica_export_asientos`	`GET /pcon/v2/asientos`	Exporta asientos contables de un período (CSV/JSON)
`freematica_list_pedidos_compra`	`GET /pcmp/v2/pedidos`	Lista paginada de pedidos de compra (filtros nativos + FIQL + estado enum)
`freematica_get_pedido_compra`	`GET /pcmp/v2/pedidos/{idReg}`	Detalle de un pedido de compra (cabecera + proveedor + líneas)
`freematica_list_albaranes_ventas`	`GET /pven/v2/albaranes-ventas`	Lista paginada de albaranes de ventas (filtros todos nativos, empresa requerido)
`freematica_get_albaran_venta`	`GET /pven/v2/albaranes-ventas/{idReg}`	Detalle de un albarán de venta
`freematica_list_albaranes_factura`	`GET /pven/v2/albaranes-facturas`	Lista paginada de vinculaciones albarán↔factura (idReg nativo + FIQL)
`freematica_get_albaran_factura`	`GET /pven/v2/albaranes-facturas/{idReg}`	Detalle de una vinculación albarán-factura
`freematica_list_resultados_facturacion`	`GET /pvss/v1/facturacion-resultados`	Resultados del proceso batch de facturación automática de vigilancia (FIQL)
`freematica_list_contratos`	`GET /pvss/v1/contratos`	Lista paginada de cabeceras de contratos (solo filtros nativos: el API ignora FIQL aquí)
`freematica_get_contrato`	`GET /pvss/v1/contratos` (scan)	Busca un contrato por empresa + código natural (paginación interna + filtrado en cliente)
`freematica_list_servicios_contrato`	`GET /pvss/v1/contratos/{idReg}/servicios`	Servicios de un contrato
`freematica_get_servicio_contrato`	`GET /pvss/v2/contratos-servicios/{idReg}`	Detalle de un servicio de contrato
`freematica_list_contratos_opcionales`	`GET /ppre/v2/contratos/opcionales`	Lista paginada de opcionales de contratos
`freematica_get_contrato_opcionales`	`GET /ppre/v2/contratos/opcionales/{idReg}`	Detalle de un registro de opcionales
`freematica_list_localizaciones_envio_clientes`	`GET /pgrl/v2/localizaciones-envio-clientes`	Localizaciones de envío de clientes
`freematica_list_localizaciones_factura_clientes`	`GET /pgrl/v2/localizaciones-factura-clientes`	Localizaciones de factura de clientes

Tool

Endpoint Freemática

Descripción

freematica_list_articulos

GET /part/v1/articulos

Catálogo de artículos/materiales/consumibles (referencias, familias, proveedores)

freematica_get_articulo

GET /part/v1/articulos/{idreg}

Detalle de un artículo

freematica_get_precio_articulo

GET /pgrl/v1/precio-articulo/{idreg}

Precios de venta de un artículo (PRECIO_VENTA, DESCUENTO, FACTURABLE)

freematica_list_materiales_asignados_servicios

GET /pvss/v2/contratos-servicios-material

Lista de material asignado a servicios

freematica_get_master_data

(24 endpoints según catalog)

Devuelve un catálogo de datos maestros (tipos, geográficos, organizativos, inventario, financiero)

freematica_list_clientes

GET /pgrl/v2/clientes

Lista paginada de clientes

freematica_get_cliente

GET /pgrl/v2/clientes/{idReg}

Detalle de un cliente

freematica_list_contactos_clientes

GET /pgrl/v2/contactos-clientes

Lista paginada de contactos

freematica_list_oportunidades_negocio

GET /pcrm/v2/oportunidades-negocio

Lista paginada de oportunidades

freematica_get_oportunidad_negocio

GET /pcrm/v2/oportunidades-negocio/{idReg}

Detalle de oportunidad

freematica_get_oportunidad_negocio_datos_ampliados

GET /pcrm/v2/oportunidades-negocio/{idReg}/datos-ampliados

Datos ampliados (puede 404)

freematica_get_ficha_prev_cliente

GET /pprl/v2/ficha-prev-cliente

Ficha PRL de un cliente

freematica_list_vigilancia_salud

GET /pprl/v1/vigilancia-salud

Lista paginada de registros de Vigilancia de la Salud

freematica_get_vigilancia_salud

GET /pprl/v1/vigilancia-salud/{idreg}

Detalle de un registro de Vigilancia de la Salud

freematica_list_personal

GET /pers/v1/personal

Lista paginada de personas (RRHH)

freematica_get_persona

GET /pers/v2/personal/{idreg}

Detalle de una persona

freematica_list_calendarios

GET /pgrl/v1/calendarios

Lista paginada de calendarios laborales

freematica_list_calendario_periodos

GET /pgrl/v1/calendarios/{idreg}/periodos

Periodos de un calendario laboral

freematica_list_cartera_clientes

GET /pcar/v1/cartera-clientes

Lista paginada de cartera de clientes (cobros, impagados)

freematica_get_cartera_cliente

GET /pcar/v1/cartera-clientes/{idReg}

Detalle de un documento de cartera

freematica_list_facturas_cabecera

GET /pven/v1/facturas-cabecera

Lista paginada de facturas de ventas (cabecera)

freematica_get_factura_cabecera

GET /pven/v1/facturas-cabecera/{idReg}

Detalle de una factura de venta

freematica_list_factura_lineas

GET /pven/v1/facturas-cabecera/{idReg}/lineas

Líneas de detalle de una factura de venta

freematica_list_factura_iva

GET /pven/v1/facturas-cabecera/{idReg}/iva

Líneas de IVA de una factura de venta

freematica_list_factura_vencimientos

GET /pven/v1/facturas-cabecera/{idReg}/vencimientos

Vencimientos de cobro de una factura de venta

freematica_list_facturas_compras

GET /pcom/v1/facturas-cabecera

Lista paginada de facturas de compras

freematica_get_factura_compra

GET /pcom/v1/facturas-cabecera/{idReg}

Detalle de una factura de compra

freematica_list_proveedores

GET /pgrl/v2/proveedores

Lista paginada de proveedores

freematica_get_proveedor

GET /pgrl/v2/proveedores/{idReg}

Detalle de un proveedor

freematica_list_localizaciones_cobro_clientes

GET /pgrl/v2/localizaciones-cobro-clientes

Localizaciones de cobro de clientes (SEPA, domiciliaciones)

freematica_list_localizaciones_pago_proveedores

GET /pgrl/v2/localizaciones-pago-proveedores

Localizaciones de pago de proveedores

freematica_list_localizaciones_servicio_clientes

GET /pgrl/v2/localizaciones-servicio-clientes

Localizaciones de servicio de clientes

freematica_list_cuentas_contables

GET /pcon/v2/cuentas

Plan de cuentas contables (COD_CTA, COD_PLAN, etc.)

freematica_list_cuentas_analiticas

GET /pcon/v2/cuentas-analiticas

Catálogo de cuentas analíticas

freematica_export_asientos

GET /pcon/v2/asientos

Exporta asientos contables de un período (CSV/JSON)

freematica_list_pedidos_compra

GET /pcmp/v2/pedidos

Lista paginada de pedidos de compra (filtros nativos + FIQL + estado enum)

freematica_get_pedido_compra

GET /pcmp/v2/pedidos/{idReg}

Detalle de un pedido de compra (cabecera + proveedor + líneas)

freematica_list_albaranes_ventas

GET /pven/v2/albaranes-ventas

Lista paginada de albaranes de ventas (filtros todos nativos, empresa requerido)

freematica_get_albaran_venta

GET /pven/v2/albaranes-ventas/{idReg}

Detalle de un albarán de venta

freematica_list_albaranes_factura

GET /pven/v2/albaranes-facturas

Lista paginada de vinculaciones albarán↔factura (idReg nativo + FIQL)

freematica_get_albaran_factura

GET /pven/v2/albaranes-facturas/{idReg}

Detalle de una vinculación albarán-factura

freematica_list_resultados_facturacion

GET /pvss/v1/facturacion-resultados

Resultados del proceso batch de facturación automática de vigilancia (FIQL)

freematica_list_contratos

GET /pvss/v1/contratos

Lista paginada de cabeceras de contratos (solo filtros nativos: el API ignora FIQL aquí)

freematica_get_contrato

GET /pvss/v1/contratos (scan)

Busca un contrato por empresa + código natural (paginación interna + filtrado en cliente)

freematica_list_servicios_contrato

GET /pvss/v1/contratos/{idReg}/servicios

Servicios de un contrato

freematica_get_servicio_contrato

GET /pvss/v2/contratos-servicios/{idReg}

Detalle de un servicio de contrato

freematica_list_contratos_opcionales

GET /ppre/v2/contratos/opcionales

Lista paginada de opcionales de contratos

freematica_get_contrato_opcionales

GET /ppre/v2/contratos/opcionales/{idReg}

Detalle de un registro de opcionales

freematica_list_localizaciones_envio_clientes

GET /pgrl/v2/localizaciones-envio-clientes

Localizaciones de envío de clientes

freematica_list_localizaciones_factura_clientes

GET /pgrl/v2/localizaciones-factura-clientes

Localizaciones de factura de clientes

Tool	Endpoint Freemática	Descripción
`freematica_create_contrato`	`POST /pvss/v2/contratos`	Alta de cabecera de contrato
`freematica_update_contrato`	`PUT /pvss/v2/contratos/{idReg}`	Actualización de cabecera de contrato
`freematica_create_servicio_contrato`	`POST /pvss/v2/contratos/{idReg}/servicios`	Alta de servicio (identificación derivada del idReg)
`freematica_update_servicio_fechas`	`PUT /pvss/v2/contratos/{id}/servicio/{id}`	Fechas inicio/fin del servicio (mecanismo de baja)
`freematica_create_servicio_historico_precios`	`POST /pvss/v2/contratos/{id}/servicios-historico-precios/{id}`	Alta de revisión de precios del servicio
`freematica_update_servicio_historico_precios`	`PUT /pvss/v2/contratos/{id}/servicios-historico-precios/{id}`	Actualización de revisión de precios
`freematica_create_servicio_facturacion_txt`	`POST /pvss/v2/contratos/{id}/servicios-facturacion-txt/{id}`	Alta de línea de texto de facturación
`freematica_update_servicio_facturacion`	`PUT /pvss/v2/contratos/{id}/servicios-facturacion/{id}`	Datos de facturación del servicio (precios hora, forma de pago…)
`freematica_create_contrato_opcionales`	`POST /ppre/v2/contratos/opcionales`	Alta de opcionales de contrato
`freematica_update_contrato_opcionales`	`PUT /ppre/v2/contratos/opcionales/{idReg}`	Actualización de opcionales de contrato
`freematica_create_cliente`	`POST /pgrl/v2/clientes`	Alta de cliente (idReg derivado de grupo+código)
`freematica_update_cliente`	`PUT /pgrl/v2/clientes/{idReg}`	Actualización parcial de cliente (fetch+merge)
`freematica_create_contacto_cliente`	`POST /pgrl/v2/contactos-clientes`	Alta de contacto de cliente
`freematica_update_contacto_cliente`	`PUT /pgrl/v2/contactos-clientes/{idReg}`	Actualización parcial de contacto (fetch+merge)
`freematica_create_localizacion_cliente`	`POST /pgrl/v2/localizaciones-{tipo}-clientes`	Alta de localización (tipo: cobro/envio/factura/servicio)
`freematica_update_localizacion_cliente`	`PUT /pgrl/v2/localizaciones-{tipo}-clientes/{idReg}`	Actualización parcial de localización (fetch+merge)

Modo	Cuándo usar	Comando
`stdio`	Claude Desktop, Claude Code, ejecución local	`mcp-freematica` (default) o `mcp-freematica --transport=stdio`
`http`	Nubiia, deploy como servicio web	`mcp-freematica --transport=http` o `MCP_TRANSPORT=http mcp-freematica`

`catalog`	Endpoint Freemática	Contenido
Tipos / clasificaciones
`tipos-contrato`	`GET /ppre/v2/tipos-contrato`	Tipos de contrato comercial
`tipo-instalacion`	`GET /ppre/v1/tipo-instalacion`	Tipos de instalación física
`clases-servicios`	`GET /pvss/v1/clases-servicios`	Clases de servicio operativas
`tipos-casos`	`GET /pcrm/v2/tipos-casos`	Tipos de caso CRM
`subtipos-casos`	`GET /pcrm/v2/subtipos-casos`	Subtipos de caso CRM
`tipos-oportunidad-negocio`	`GET /pcrm/v2/tipos-oportunidad-negocio`	Tipos de oportunidad comercial
`tipos-impuestos`	`GET /pgrl/v2/tipos-impuestos`	IVA, IRPF, retenciones
`naturalezas-abono`	`GET /pven/v1/naturalezas-abono`	Naturalezas de abono comercial
`incidencecode`	`GET /pvss/v2/incidencecode`	Códigos de incidencia en servicios
`claves-facturacion`	`GET /pvss/v2/claves-facturacion`	Claves de facturación de servicios
Geográficos
`paises`	`GET /pgrl/v1/paises`	Países
`nacionalidades`	`GET /pgrl/v1/nacionalidades`	Nacionalidades
`provincias`	`GET /pgrl/v1/provincias`	Provincias
`poblaciones`	`GET /pgrl/v2/poblaciones`	Municipios
Organizativos
`empresas`	`GET /pgrl/v1/empresas`	Empresas
`delegaciones`	`GET /pgrl/v1/delegaciones/agrupcod`	Delegaciones (listado global)
`lineas-negocio`	`GET /pgrl/v2/lineas-negocio`	Líneas de negocio
`cargos-clientes`	`GET /pgrl/v2/cargos-clientes`	Cargos de contactos
`calendarios`	`GET /pgrl/v1/calendarios`	Calendarios laborales
`series`	`GET /pgrl/v2/series`	Series de numeración de documentos
Inventario
`familias`	`GET /part/v1/familias`	Familias de artículos
`subfamilias`	`GET /part/v1/subfamilias`	Subfamilias
`lineas`	`GET /part/v1/lineas`	Líneas de artículos
Financiero
`bancos`	`GET /pgrl/v2/bancos`	Entidades bancarias

Variable	Descripción
`FREEMATICA_AUTH_TOKEN`	Header `x-auth-token` para autenticar con la API de Freemática.
`FREEMATICA_AUTH_COMPANY`	Header `x-auth-company`. Identifica la empresa dentro del API.
`FREEMATICA_AUTH_ORGANIZATION`	Header `x-auth-organization`. Identifica la organización.
`FREEMATICA_AUTH_APP`	Header `x-auth-app`. Identifica la aplicación que consume (p.ej. `pvss`).
`FREEMATICA_AUTH_SESSION`	Header `x-auth-session`. Identifica la sesión activa.

Variable	Default	Descripción
`FREEMATICA_BASE_URL`	`https://api-p01.clientservicepanel.com/restsat/api`	Base URL del API de Freemática. Cambiar solo si Freemática cambia el host o se usa un entorno alternativo.
`FREEMATICA_TIMEOUT_MS`	`30000`	Timeout por petición en milisegundos. Si el upstream no responde en este tiempo, el request se cancela con `network_error`.
`FREEMATICA_MAX_RETRIES`	`3`	Número máximo de reintentos para errores 5xx y errores de red. Los errores 4xx nunca se reintentan.
`FREEMATICA_CIRCUIT_BREAKER_THRESHOLD`	`5`	Número de operaciones lógicas fallidas consecutivas (post-retry-exhaustion) necesarias para abrir el circuit breaker.
`FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS`	`30000`	Tiempo en ms que el circuit breaker permanece abierto antes de pasar a half-open.
`FREEMATICA_MAX_RESPONSE_SIZE_MB`	`10`	Tamaño máximo de respuesta aceptada del upstream en MB. Respuestas mayores se truncan con aviso en el campo `truncated`.
`FREEMATICA_ENABLE_WRITES`	`false`	Registra las tools de escritura (`freematica_create_` / `freematica_update_`). Sin ella el servidor es de solo lectura. Valores: `true`/`false`/`1`/`0`.
`MCP_TRANSPORT`	`stdio`	Transporte: `stdio` (para Claude Desktop/Code) o `http` (para Nubiia). Equivale al flag `--transport=`.
`MCP_PORT`	`3000`	Puerto TCP donde el servidor MCP expone `/mcp` y `/health`. Ignorado en modo stdio.
`MCP_ALLOWED_ORIGINS`	`*`	CORS: lista de orígenes permitidos separados por coma, o `*` para todos. En producción restringir al dominio de Nubiia. Ignorado en modo stdio.
`LOG_LEVEL`	`info`	Nivel de log para pino: `fatal`, `error`, `warn`, `info`, `debug`, `trace`. En producción usar `info`. En desarrollo usar `debug`.

Método	Path	Descripción
POST	`/mcp`	JSON-RPC del MCP (envía `initialize` la primera vez)
GET	`/mcp`	Stream SSE (requiere `Mcp-Session-Id`)
DELETE	`/mcp`	Terminar sesión
GET	`/health`	Healthcheck

Add this server

Host a copy with our keys and logs.

Server facts

Documentation

mcp-freematica

Stack

Tools expuestas

Tools de escritura (requieren FREEMATICA_ENABLE_WRITES=true)

Filtros tipados (FIQL interno)

Ejemplo

Ventajas del patrón

Más ejemplos

Modos de transporte

Configurar en Claude Desktop (stdio)

Configurar en Claude Code (stdio)

Configurar en Nubiia (HTTP)

Datos maestros disponibles

Paginación

IDs opacos en endpoints de detalle

Configuración

Variables de entorno obligatorias

Configuración avanzada

De dónde salen las credenciales x-auth-*

Configuración en Nubiia (producción)

Configuración local (desarrollo)

Verificación de la configuración

Troubleshooting

invalid_token en todas las llamadas

network_error — upstream Freemática caído

rate_limit_exceeded — throttling de Freemática

Response truncated en freematica_export_asientos

El pre-commit hook falla al hacer git commit

Desarrollo

Testing

Tests unitarios e integración

Testing manual con MCP Inspector

Endpoints HTTP

Seguridad

Cómo añadir una nueva operación

Despliegue

Opción 1 — Instalar como paquete npm (recomendada)

Opción 2 — Docker

Opción 3 — Clone + build

Publicar una nueva versión

Especificaciones y diseño

About Nubiia

Author

Links

Licencia

Tools

Questions

How do I install MCP Freematica?

Does MCP Freematica need an API key?

What transport does MCP Freematica use?

When was MCP Freematica last checked?

Tools de escritura (requieren `FREEMATICA_ENABLE_WRITES=true`)

De dónde salen las credenciales `x-auth-*`

`invalid_token` en todas las llamadas

`network_error` — upstream Freemática caído

`rate_limit_exceeded` — throttling de Freemática

`Response truncated` en `freematica_export_asientos`

El pre-commit hook falla al hacer `git commit`