Tutorial: un servidor MCP de solo lectura para que un agente consulte tu ERP

Paso a paso en TypeScript: usuario de solo lectura, vistas sin datos personales, una herramienta MCP validada y cómo conectarla a Claude Code.

JZ Jorge Zamarrón 15 nov. 2026 4 min de lectura
Tutorial: un servidor MCP de solo lectura para que un agente consulte tu ERP

Cuando alguien me pregunta cómo conectar un agente de IA a su ERP, mi primera respuesta es: empieza con lectura. Que el agente pueda consultar saldos, pedidos o existencias antes de que pueda modificar cualquier cosa. Este tutorial arma eso con un servidor MCP pequeño en TypeScript.

MCP (Model Context Protocol) es el estándar abierto que usan Claude, Claude Code y cada vez más herramientas para que un modelo llame funciones de un sistema externo. Tú defines qué herramientas existen y qué parámetros aceptan; el modelo solo puede usar esas.

La regla de la que depende todo

El permiso de solo lectura no se pone en el prompt. Se pone en la base de datos. Si el agente se conecta con un usuario que solo puede hacer SELECT sobre unas vistas, no importa qué le pidan: no puede escribir.

El ejemplo usa PostgreSQL porque el patrón se lee fácil. Si tu ERP es SAP Business One sobre HANA o SQL Server, la idea es la misma con su driver: un usuario dedicado, permisos sobre vistas y nada más. También puedes leer por la Service Layer de SAP con un usuario de consulta; lo importante es que el usuario no tenga permisos de escritura.

-- Una vista con solo las columnas que el agente necesita
create view v_facturas_abiertas as
select cliente, folio, fecha, vencimiento, saldo
from facturas
where saldo > 0;

-- Un usuario que solo puede leer esa vista
create role agente_lectura login password 'cambia-esto';
grant select on v_facturas_abiertas to agente_lectura;

Fíjate que la vista no trae el RFC, el teléfono ni el correo del cliente. Si el agente no los necesita para contestar, no tienen por qué pasar por el modelo.

El servidor

Crea un proyecto e instala el SDK oficial, zod para validar parámetros y el driver de Postgres:

npm init -y
npm install @modelcontextprotocol/sdk zod pg
npm install -D typescript @types/node @types/pg

El SDK se publica como módulo ES, así que agrega "type": "module" a tu package.json y, en tsconfig.json, usa "module": "NodeNext", "moduleResolution": "NodeNext", "rootDir": "src" y "outDir": "dist". Luego el servidor, con una sola herramienta, en src/server.ts:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import pg from "pg";

const pool = new pg.Pool({ connectionString: process.env.ERP_READONLY_URL });

const server = new McpServer({ name: "erp-lectura", version: "1.0.0" });

server.tool(
  "facturas_abiertas",
  "Facturas con saldo pendiente de un cliente, ordenadas por vencimiento.",
  { cliente: z.string().regex(/^[A-Z0-9-]{3,20}$/) },
  async ({ cliente }) => {
    const { rows } = await pool.query(
      "select folio, fecha, vencimiento, saldo from v_facturas_abiertas where cliente = $1 order by vencimiento limit 50",
      [cliente]
    );
    return { content: [{ type: "text", text: JSON.stringify(rows) }] };
  }
);

await server.connect(new StdioServerTransport());

Tres detalles que valen más que el código:

  • La consulta usa un parámetro ($1), nunca texto concatenado. El modelo arma el valor de cliente y no debe poder inyectar SQL.
  • El código de cliente se valida con una expresión regular antes de tocar la base. Si llega algo raro, la herramienta falla y el modelo lo ve.
  • El limit 50 evita que una consulta mal planteada le mande diez mil filas al modelo.

Conectarlo a Claude Code

Compila con npx tsc y registra el servidor. La cadena de conexión va como variable de entorno, no en el código:

claude mcp add erp-lectura -e ERP_READONLY_URL=postgres://agente_lectura:...@host/erp -- node dist/server.js

Desde ahí puedes pedirle a Claude que revise las facturas abiertas de un cliente y verás la llamada a la herramienta. Es buena forma de probar antes de conectar el mismo servidor a un agente que atienda clientes.

Lo que sigue después de la lectura

Cuando la lectura funciona y el equipo confía en las respuestas, llega la pregunta de escribir: registrar una promesa de pago, crear un pedido. Ahí cambio el enfoque. Cada escritura es una herramienta aparte, con validaciones del lado del servidor, y casi siempre deja el registro en un estado pendiente que una persona aprueba. Además guardo en una bitácora quién pidió qué y qué contestó la herramienta.

Aprendí a desconfiar de los montos en cero en estas integraciones. En un proyecto con SAP Business One, un documento no se creaba cuando un concepto valía $0.00 y el error se perdía sin que nadie lo viera. Si tu herramienta escribe, que falle en voz alta.

Si quieres conectar tu ERP y no sabes por qué tabla empezar, en integración con SAP Business One cuento cómo lo trabajamos. ¿Qué consulta sería la primera que le darías a un agente en tu empresa?

JZ

Escrito por

Jorge Zamarrón · Fundador y CEO

Fundó Zygnus y lleva quince años haciendo software y consultoría de procesos para empresas. Es consejero de Alcis Corp, un holding de más de diez empresas con ventas conjuntas de más de 12 mil millones de pesos al año, y director de Innovación y Desarrollo de J. García López.

Boletín

Un correo cuando publiquemos algo nuevo

Sin promociones. Solo los artículos.