MCP Freematica

Name: MCP Freematica
Author: nubiia-dev

โดย nubiia-devรุ่น 0.11.2i★ –iรันบนเครื่อง

ชื่อใน registryio.github.nubiia-dev/mcp-freematica

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Freemática ERP: invoicing, receivables, suppliers, accounting and HR through 300+ MCP tools

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: บัญชี การเงิน และภาษี
ต้องใส่ค่าเหล่านี้: FREEMATICA_AUTH_TOKEN, FREEMATICA_AUTH_COMPANY, FREEMATICA_AUTH_ORGANIZATION, FREEMATICA_AUTH_APP, FREEMATICA_AUTH_SESSION

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: FREEMATICA_AUTH_TOKEN, FREEMATICA_AUTH_COMPANY, FREEMATICA_AUTH_ORGANIZATION, FREEMATICA_AUTH_APP, FREEMATICA_AUTH_SESSION, FREEMATICA_ENABLE_WRITES, FREEMATICA_BASE_URL

ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต

ต้องเตรียมก่อน

npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "freematica": {
      "command": "npx",
      "args": [
        "-y",
        "@nubiia/mcp-freematica"
      ],
      "env": {
        "FREEMATICA_AUTH_TOKEN": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_COMPANY": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_ORGANIZATION": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_APP": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_SESSION": "ใส่ค่าของคุณ",
        "FREEMATICA_ENABLE_WRITES": "ใส่ค่าของคุณ",
        "FREEMATICA_BASE_URL": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add freematica --env FREEMATICA_AUTH_TOKEN='ใส่ค่าของคุณ' --env FREEMATICA_AUTH_COMPANY='ใส่ค่าของคุณ' --env FREEMATICA_AUTH_ORGANIZATION='ใส่ค่าของคุณ' --env FREEMATICA_AUTH_APP='ใส่ค่าของคุณ' --env FREEMATICA_AUTH_SESSION='ใส่ค่าของคุณ' --env FREEMATICA_ENABLE_WRITES='ใส่ค่าของคุณ' --env FREEMATICA_BASE_URL='ใส่ค่าของคุณ' -- npx -y @nubiia/mcp-freematica

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "freematica": {
      "command": "npx",
      "args": [
        "-y",
        "@nubiia/mcp-freematica"
      ],
      "env": {
        "FREEMATICA_AUTH_TOKEN": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_COMPANY": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_ORGANIZATION": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_APP": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_SESSION": "ใส่ค่าของคุณ",
        "FREEMATICA_ENABLE_WRITES": "ใส่ค่าของคุณ",
        "FREEMATICA_BASE_URL": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "freematica": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nubiia/mcp-freematica"
      ],
      "env": {
        "FREEMATICA_AUTH_TOKEN": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_COMPANY": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_ORGANIZATION": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_APP": "ใส่ค่าของคุณ",
        "FREEMATICA_AUTH_SESSION": "ใส่ค่าของคุณ",
        "FREEMATICA_ENABLE_WRITES": "ใส่ค่าของคุณ",
        "FREEMATICA_BASE_URL": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

FREEMATICA_AUTH_TOKEN ความลับ จำเป็น env
Freemática API token (x-auth-token header).
FREEMATICA_AUTH_COMPANY จำเป็น env
Freemática company identifier (x-auth-company header).
FREEMATICA_AUTH_ORGANIZATION จำเป็น env
Freemática organization identifier (x-auth-organization header).
FREEMATICA_AUTH_APP จำเป็น env
Freemática consuming application, e.g. pvss (x-auth-app header).
FREEMATICA_AUTH_SESSION ความลับ จำเป็น env
Freemática active session (x-auth-session header).
FREEMATICA_ENABLE_WRITES env
Set to true to register the create/update tools. Read-only by default.
FREEMATICA_BASE_URL env
Freemática API base URL. Change only for an alternative host.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 6 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub nubiia-dev ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

ดาวมากกว่า 0% ของอีก 1720 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 71% ของอีก 1720 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1720 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

MCP Freematica ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: FREEMATICA_AUTH_TOKEN, FREEMATICA_AUTH_COMPANY, FREEMATICA_AUTH_ORGANIZATION, FREEMATICA_AUTH_APP, FREEMATICA_AUTH_SESSION

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.11.2) เข้า registry 15 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Finance Toolkit, SolidInvoice, Korea Tax Calculator

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Finance Toolkit

โดย JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

บนเครื่องหรือคลาวด์★ 5,496MITอัปเดต เมื่อวาน

ติดตั้ง

SolidInvoice

โดย SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

รันบนคลาวด์★ 981MITอัปเดต 7 วันที่ผ่านมา

ติดตั้ง

Korea Tax Calculator

โดย UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

รันบนเครื่อง★ 97MITอัปเดต วันนี้

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

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.

Built and maintained by [Nubiia](https://nubiia.es) — automatización e integraciones con IA para negocios (MCP, Holded, Pipedrive y más). ¿Quieres algo así para tu empresa? Escríbenos en [nubiia.es](https://nubiia.es).

Stack

TypeScript + Node.js ≥20
@modelcontextprotocol/sdk (stdio + Streamable HTTP transports)
Express + axios + zod
pino (logging estructurado)
Vitest + nock para tests

Tools expuestas

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_localiza

ตัดมาแค่ช่วงต้น อ่านต่อใน repo

MCP Freematica

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README จากผู้ทำ

mcp-freematica

Stack

Tools expuestas