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_URLy, 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 bloqueenv/environmentdel cliente correspondiente (o en un.envsi ejecutas desde el repo). -
Las tools devuelven un JSON de error de suscripción: el
SUBSCRIPTION_TOKENno 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_URLmal 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
SystemExity 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.