Skip to main content

NotERP MCP

Servidor MCP que expone tools para consultar empleados, comprobantes, ingresos, gastos y metadatos SAT de NotERP.

Suscripción requerida

Este MCP requiere una suscripción activa. Obtén tu token de suscripción en https://globalsoft.lat/pages/noterp y configúralo en la variable SUBSCRIPTION_TOKEN. Sin un token válido las tools no se ejecutan.

Tools

Tool Descripción
listar_empleados Lista empleados de NotERP. Params: hoja, all_empleados (0/1), id_empleado, estatus (ACTIVO/INACTIVO).
consultar_comprobantes Consulta comprobantes/facturas. Params: id_comprobante, folio, estatus, concepto, uuid, num_comprobante, tipo_documento, metodo_pago, fecha_timbrado_inicio, fecha_timbrado_fin, hoja, por_pagina.
consultar_gastos Consulta gastos. Params: id_gasto, folio, estatus, concepto, rfc, proyecto, centro_costo, fecha_operacion_inicio, fecha_operacion_fin, monto_min, monto_max, hoja, por_pagina.
consultar_ingresos Consulta ingresos. Params: id_ingreso, folio, estatus, concepto, rfc, cliente, fecha_operacion_inicio, fecha_operacion_fin, fecha_factura_inicio, fecha_factura_fin, monto_min, monto_max, hoja, por_pagina.
consultar_metadata_sat Consulta metadatos SAT de los comprobantes. Params: rfc_emisor, rfc_receptor, uuid, estatus, fecha_emision_inicio, fecha_emision_fin, monto_min, monto_max, hoja, por_pagina.

Requisitos

  • uv (incluye uvx).
  • Datos del sitio NotERP: BASE_URL y, si aplica, TOKEN.
  • Token de suscripción: SUBSCRIPTION_TOKEN (ver arriba).

Instalación rápida

No requiere instalación previa; uvx descarga y ejecuta el paquete:

uvx noterp-mcp==0.1.1

El transporte por defecto es stdio, que es lo que usan los clientes MCP. El servidor lee las credenciales desde variables de entorno.

Variables de entorno

Variable Obligatoria Descripción
BASE_URL Sí URL base del sitio NotERP. Ej: https://noterp.ejemplo.com
TOKEN No Token de autenticación; viaja dentro de la ruta del endpoint.
SUBSCRIPTION_TOKEN Sí Token de suscripción de la plataforma (https://globalsoft.lat/pages/noterp).

Configuración por cliente

Reemplaza <url_noterp>, <token> y <subscription_token> por tus valores.

Claude Code

claude mcp add noterp \
  -e BASE_URL=<url_noterp> \
  -e TOKEN=<token> \
  -e SUBSCRIPTION_TOKEN=<subscription_token> \
  -- uvx noterp-mcp==0.1.1

Codex

CLI:

codex mcp add noterp \
  --env BASE_URL=<url_noterp> \
  --env TOKEN=<token> \
  --env SUBSCRIPTION_TOKEN=<subscription_token> \
  -- uvx noterp-mcp==0.1.1

O en ~/.codex/config.toml (o .codex/config.toml en el proyecto):

[mcp_servers.noterp]
command = "uvx"
args = ["noterp-mcp==0.1.1"]
env = { BASE_URL = "<url_noterp>", TOKEN = "<token>", SUBSCRIPTION_TOKEN = "<subscription_token>" }

Antigravity

En ~/.gemini/config/mcp_config.json (global) o .agents/mcp_config.json (workspace):

{
  "mcpServers": {
    "noterp": {
      "command": "uvx",
      "args": ["noterp-mcp==0.1.1"],
      "env": {
        "BASE_URL": "<url_noterp>",
        "TOKEN": "<token>",
        "SUBSCRIPTION_TOKEN": "<subscription_token>"
      }
    }
  }
}

opencode

En opencode.jsonc (o ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "noterp": {
      "type": "local",
      "command": ["uvx", "noterp-mcp==0.1.1"],
      "environment": {
        "BASE_URL": "<url_noterp>",
        "TOKEN": "<token>",
        "SUBSCRIPTION_TOKEN": "<subscription_token>"
      },
      "enabled": true
    }
  }
}

Otros clientes (formato genérico mcpServers)

Válido para Claude Desktop y otros clientes que usan el formato mcpServers:

{
  "mcpServers": {
    "noterp": {
      "command": "uvx",
      "args": ["noterp-mcp==0.1.1"],
      "env": {
        "BASE_URL": "<url_noterp>",
        "TOKEN": "<token>",
        "SUBSCRIPTION_TOKEN": "<subscription_token>"
      }
    }
  }
}

Troubleshooting

  • Error de configuración: Falta la variable de entorno ...: el proceso no ve las variables requeridas. Verifica que estén definidas en el bloque env/environment del cliente correspondiente (o en un .env si ejecutas desde el repo).

  • Las tools devuelven un JSON de error de suscripción: el SUBSCRIPTION_TOKEN no es válido, está expirado o la póliza no está activa. Obtén/renueva el token en https://globalsoft.lat/pages/glpi. La validación es fail-closed y el resultado válido se cachea 60s.

  • BASE_URL mal formada: debe ser la raíz del sitio NotERP (ej. https://noterp.ejemplo.com) y sin una barra final sobrante.

  • Verificar que el paquete arranca (con las variables ya exportadas en el shell):

    uvx noterp-mcp==0.1.1
    

    Si faltan variables, el proceso termina con SystemExit y el mensaje de configuración; es el comportamiento esperado.

Metadata

Release files for noterp-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for noterp-mcp 0.1.1
File Size Uploaded Provenance Actions
noterp_mcp-0.1.1.tar.gz 11.3 kB Without provenance Details for noterp_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for noterp-mcp 0.1.1
File Interpreter ABI Platform Actions
noterp_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for noterp_mcp-0.1.1-py3-none-any.whl

Total release size: 27.2 kB

Release files / noterp_mcp-0.1.1.tar.gz

Download URL noterp_mcp-0.1.1.tar.gz
Size 11.3 kB
Tags Source
SHA-256 checksum
How to use checksums
81130319b59463a4185f160ae7ebe988d6094b519f4435c67620836df5458911
BLAKE2b-256 checksum
How to use checksums
ec8c2d740ba75a2530321cf02ef3a6575a6c995162209ecf1f054b74b7eb801f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.13

Release files / noterp_mcp-0.1.1-py3-none-any.whl

Download URL noterp_mcp-0.1.1-py3-none-any.whl
Size 15.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
48b95ffd5439ce03fd529e6cdc2547934c44f45a1e80eed0d1b5fb5fbd7a9c4f
BLAKE2b-256 checksum
How to use checksums
7fbc3511e10523e8df315926d02b26fd12c300e3530073b92adabd21c7f7cbb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.13

Security for noterp-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page