プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

MCP Freematica

作者:nubiia-devバージョン 0.11.2i★ –iパソコンで動く
レジストリ名io.github.nubiia-dev/mcp-freematica

インストール

概要

作者による説明(英語の原文)

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: 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

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

  • npmNode.jsのインストール(npxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "freematica": {
      "command": "npx",
      "args": [
        "-y",
        "@nubiia/mcp-freematica"
      ],
      "env": {
        "FREEMATICA_AUTH_TOKEN": "your-value",
        "FREEMATICA_AUTH_COMPANY": "your-value",
        "FREEMATICA_AUTH_ORGANIZATION": "your-value",
        "FREEMATICA_AUTH_APP": "your-value",
        "FREEMATICA_AUTH_SESSION": "your-value",
        "FREEMATICA_ENABLE_WRITES": "your-value",
        "FREEMATICA_BASE_URL": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add freematica --env FREEMATICA_AUTH_TOKEN=your-value --env FREEMATICA_AUTH_COMPANY=your-value --env FREEMATICA_AUTH_ORGANIZATION=your-value --env FREEMATICA_AUTH_APP=your-value --env FREEMATICA_AUTH_SESSION=your-value --env FREEMATICA_ENABLE_WRITES=your-value --env FREEMATICA_BASE_URL=your-value -- 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": "your-value",
        "FREEMATICA_AUTH_COMPANY": "your-value",
        "FREEMATICA_AUTH_ORGANIZATION": "your-value",
        "FREEMATICA_AUTH_APP": "your-value",
        "FREEMATICA_AUTH_SESSION": "your-value",
        "FREEMATICA_ENABLE_WRITES": "your-value",
        "FREEMATICA_BASE_URL": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "freematica": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nubiia/mcp-freematica"
      ],
      "env": {
        "FREEMATICA_AUTH_TOKEN": "your-value",
        "FREEMATICA_AUTH_COMPANY": "your-value",
        "FREEMATICA_AUTH_ORGANIZATION": "your-value",
        "FREEMATICA_AUTH_APP": "your-value",
        "FREEMATICA_AUTH_SESSION": "your-value",
        "FREEMATICA_ENABLE_WRITES": "your-value",
        "FREEMATICA_BASE_URL": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

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

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント nubiia-dev で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの1720件のうち0%よりスターが多い
  • このカテゴリのほかの1720件のうち71%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1720件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Freematicaは安全ですか?

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:FREEMATICA_AUTH_TOKEN, FREEMATICA_AUTH_COMPANY, FREEMATICA_AUTH_ORGANIZATION, FREEMATICA_AUTH_APP, FREEMATICA_AUTH_SESSION

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(0.11.2)がレジストリに届いたのは15 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Finance Toolkit, SolidInvoice, Korea Tax Calculator

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

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.

クラウドで動く★ 981MIT7 日前更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。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

ToolEndpoint FreemáticaDescripción
freematica_list_articulosGET /part/v1/articulosCatálogo de artículos/materiales/consumibles (referencias, familias, proveedores)
freematica_get_articuloGET /part/v1/articulos/{idreg}Detalle de un artículo
freematica_get_precio_articuloGET /pgrl/v1/precio-articulo/{idreg}Precios de venta de un artículo (PRECIO_VENTA, DESCUENTO, FACTURABLE)
freematica_list_materiales_asignados_serviciosGET /pvss/v2/contratos-servicios-materialLista 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_clientesGET /pgrl/v2/clientesLista paginada de clientes
freematica_get_clienteGET /pgrl/v2/clientes/{idReg}Detalle de un cliente
freematica_list_contactos_clientesGET /pgrl/v2/contactos-clientesLista paginada de contactos
freematica_list_oportunidades_negocioGET /pcrm/v2/oportunidades-negocioLista paginada de oportunidades
freematica_get_oportunidad_negocioGET /pcrm/v2/oportunidades-negocio/{idReg}Detalle de oportunidad
freematica_get_oportunidad_negocio_datos_ampliadosGET /pcrm/v2/oportunidades-negocio/{idReg}/datos-ampliadosDatos ampliados (puede 404)
freematica_get_ficha_prev_clienteGET /pprl/v2/ficha-prev-clienteFicha PRL de un cliente
freematica_list_vigilancia_saludGET /pprl/v1/vigilancia-saludLista paginada de registros de Vigilancia de la Salud
freematica_get_vigilancia_saludGET /pprl/v1/vigilancia-salud/{idreg}Detalle de un registro de Vigilancia de la Salud
freematica_list_personalGET /pers/v1/personalLista paginada de personas (RRHH)
freematica_get_personaGET /pers/v2/personal/{idreg}Detalle de una persona
freematica_list_calendariosGET /pgrl/v1/calendariosLista paginada de calendarios laborales
freematica_list_calendario_periodosGET /pgrl/v1/calendarios/{idreg}/periodosPeriodos de un calendario laboral
freematica_list_cartera_clientesGET /pcar/v1/cartera-clientesLista paginada de cartera de clientes (cobros, impagados)
freematica_get_cartera_clienteGET /pcar/v1/cartera-clientes/{idReg}Detalle de un documento de cartera
freematica_list_facturas_cabeceraGET /pven/v1/facturas-cabeceraLista paginada de facturas de ventas (cabecera)
freematica_get_factura_cabeceraGET /pven/v1/facturas-cabecera/{idReg}Detalle de una factura de venta
freematica_list_factura_lineasGET /pven/v1/facturas-cabecera/{idReg}/lineasLíneas de detalle de una factura de venta
freematica_list_factura_ivaGET /pven/v1/facturas-cabecera/{idReg}/ivaLíneas de IVA de una factura de venta
freematica_list_factura_vencimientosGET /pven/v1/facturas-cabecera/{idReg}/vencimientosVencimientos de cobro de una factura de venta
freematica_list_facturas_comprasGET /pcom/v1/facturas-cabeceraLista paginada de facturas de compras
freematica_get_factura_compraGET /pcom/v1/facturas-cabecera/{idReg}Detalle de una factura de compra
freematica_list_proveedoresGET /pgrl/v2/proveedoresLista paginada de proveedores
freematica_get_proveedorGET /pgrl/v2/proveedores/{idReg}Detalle de un proveedor
freematica_list_localizaciones_cobro_clientesGET /pgrl/v2/localizaciones-cobro-clientesLocalizaciones de cobro de clientes (SEPA, domiciliaciones)
freematica_list_localizaciones_pago_proveedoresGET /pgrl/v2/localizaciones-pago-proveedoresLocalizaciones de pago de proveedores
freematica_list_localizaciones_servicio_clientesGET /pgrl/v2/localizaciones-servicio-clientesLocalizaciones de servicio de clientes
freematica_list_cuentas_contablesGET /pcon/v2/cuentasPlan de cuentas contables (COD_CTA, COD_PLAN, etc.)
freematica_list_cuentas_analiticasGET /pcon/v2/cuentas-analiticasCatálogo de cuentas analíticas
freematica_export_asientosGET /pcon/v2/asientosExporta asientos contables de un período (CSV/JSON)
freematica_list_pedidos_compraGET /pcmp/v2/pedidosLista paginada de pedidos de compra (filtros nativos + FIQL + estado enum)
freematica_get_pedido_compraGET /pcmp/v2/pedidos/{idReg}Detalle de un pedido de compra (cabecera + proveedor + líneas)
freematica_list_albaranes_ventasGET /pven/v2/albaranes-ventasLista paginada de albaranes de ventas (filtros todos nativos, empresa requerido)
freematica_get_albaran_ventaGET /pven/v2/albaranes-ventas/{idReg}Detalle de un albarán de venta
freematica_list_albaranes_facturaGET /pven/v2/albaranes-facturasLista paginada de vinculaciones albarán↔factura (idReg nativo + FIQL)
freematica_get_albaran_facturaGET /pven/v2/albaranes-facturas/{idReg}Detalle de una vinculación albarán-factura
freematica_list_resultados_facturacionGET /pvss/v1/facturacion-resultadosResultados del proceso batch de facturación automática de vigilancia (FIQL)
freematica_list_contratosGET /pvss/v1/contratosLista paginada de cabeceras de contratos (solo filtros nativos: el API ignora FIQL aquí)
freematica_get_contratoGET /pvss/v1/contratos (scan)Busca un contrato por empresa + código natural (paginación interna + filtrado en cliente)
freematica_list_servicios_contratoGET /pvss/v1/contratos/{idReg}/serviciosServicios de un contrato
freematica_get_servicio_contratoGET /pvss/v2/contratos-servicios/{idReg}Detalle de un servicio de contrato
freematica_list_contratos_opcionalesGET /ppre/v2/contratos/opcionalesLista paginada de opcionales de contratos
freematica_get_contrato_opcionalesGET /ppre/v2/contratos/opcionales/{idReg}Detalle de un registro de opcionales

| `freematica_list_localiza

冒頭だけを表示しています。続きはリポジトリで読めます

PopNxに聞く