RebundleRebundle Stack
Claude Code Hub

SAP Business One

Conecta SAP Business One a Claude Code

Pega un prompt. Claude te pregunta qué necesitas, elige entre el API oficial y un servidor MCP y te guía paso a paso.

Hazlo en un ordenador que llegue al servidor de SAP (dentro de la red de la empresa o conectado a la VPN). Claude empieza en modo solo lectura y nunca te pedirá que pegues una contraseña en el chat.
1

Abre Claude Code

Tú haces esto
  1. 1En un ordenador de la red de la empresa o con la VPN, abre Claude Desktop
  2. 2Haz clic en la pestaña Claude Code
  3. 3Elige una carpeta vacía, por ejemplo sap-b1-claude
2

Pega este prompt

Claude Code

Claude te hará unas preguntas, revisará tu ordenador y te dirá exactamente qué pedir o configurar en SAP. Solo tienes que seguirle.

dile esto a claude
Quiero conectar SAP Business One a Claude Code para que puedas consultar los datos de mi empresa. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir. CONTEXTO PARA TI - SAP no tiene un conector de IA oficial para Business One: su Joule y sus MCP oficiales cubren solo el suite enterprise (S/4HANA, HANA Cloud, Commerce Cloud, ABAP). Para B1, lo oficial es el API de integración y la capa de IA se monta encima. - Hay dos vías: 1. Service Layer (la oficial y la recomendada): el API REST oficial de B1 (OData v4, JSON). Respeta los permisos y validaciones de SAP. La URL suele ser https://<host-sap>:50000/b1s/v1/. Hace falta el código de la empresa (CompanyDB), un usuario B1 dedicado con su contraseña (una cuenta de servicio, no el login de una persona), una licencia SAP para ese usuario (cada login consume una sesión) y, para solo leer, autorizaciones de solo lectura en SAP (General Authorizations). Login con POST /Login, que devuelve una cookie B1SESSION que se reutiliza en las consultas. Objetos como Orders, Items, BusinessPartners e Invoices, con filtros, $select, paginación y orden. No sirve para SQL complejo ni transacciones largas (eso es la DI API, .NET y solo Windows). 2. Servidor MCP de terceros (no oficial, sin soporte de SAP): CData MCP for SAP Business One (hoy en Windows, macOS en camino), que usa drivers JDBC y es de solo lectura en su versión gratis; el CRUD completo exige su plataforma de pago Connect AI. También hay servidores comunitarios que envuelven el Service Layer. Se registra con "claude mcp add". Si conecta directo a la base de datos (HANA o SQL Server) y no al Service Layer, se salta los permisos de SAP y hay que limitar ese usuario con GRANT SELECT. Las credenciales pasan por el servidor MCP. - B1 suele estar on-prem: quien se conecta necesita llegar al servidor (red de la empresa o VPN), con el puerto abierto y un certificado TLS de confianza, a menudo autofirmado. QUÉ QUIERO QUE HAGAS 1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero conseguir (consultas e informes, o también crear o modificar pedidos, facturas o clientes), si es un piloto rápido o algo recurrente para el equipo, si este ordenador está en la red de la empresa o en la VPN, y si ya tengo un usuario B1 dedicado o alguien que administre SAP pueda crearlo. 2. RECOMENDAR: dime en dos frases qué vía encaja y por qué. Por defecto, el Service Layer con una skill de solo lectura, que es la oficial y te da control sobre lo que consultas. Propón el MCP de CData solo si quiero un piloto rápido o consultas sueltas en lenguaje natural, y avísame de que es de un tercero, de que la versión gratis solo lee y de que hoy funciona en Windows. 3. REVISAR: comprueba tú mismo lo que puedas (sistema operativo, si tienes las herramientas para llamar a un API REST y si desde aquí se llega a la URL del Service Layer). Instala lo que falte pidiéndome permiso antes. 4. GUIARME EN SAP: dime exactamente qué tengo que pedir o configurar (el usuario dedicado, su licencia, las autorizaciones de solo lectura, la URL y el CompanyDB), un paso cada vez. Si algo no coincide con lo que veo, pídeme una captura de pantalla. 5. DATOS DE ACCESO: la URL, el CompanyDB y el usuario me los puedes preguntar normal; la contraseña nunca me la pidas en el chat, basta con que la copie. Hazlo así, un dato cada vez: dime exactamente qué copiar y de dónde; cuando te diga «OK», léelo tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows) y guárdalo directamente donde toque, sin mostrarlo, repetirlo ni escribirlo en el chat. Comprueba solo que no está vacío y después vacía el portapapeles. Guarda los cuatro como variables de entorno de usuario (en Mac, una línea export en ~/.zshrc; en Windows, [Environment]::SetEnvironmentVariable con ámbito User): SAPB1_URL, SAPB1_DB, SAPB1_USER y SAPB1_PASS, y léelos desde ahí. Nunca los pongas en un fichero que vaya a git. 6. PROBAR: haz login y una consulta pequeña de solo lectura (por ejemplo, los últimos 5 pedidos con DocNum, DocDate, CardName y DocTotal) y enséñame el resultado para confirmar que funciona. 7. RECORDAR: crea una skill personal con cómo hacer login, las consultas de solo lectura permitidas (para no improvisar) y la regla de que es solo lectura, sin credenciales dentro. Así la próxima vez me basta con preguntarte, y se puede compartir con el resto de la empresa. Reglas: nada de escribir ni modificar datos en SAP salvo que yo lo pida de forma explícita, y en ese caso enséñame antes exactamente qué vas a cambiar y espera a que te lo confirme. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo. CÓMO TRABAJAR CONMIGO - Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano. - Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción. - Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo. - Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado. - Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones. - Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill. - La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill. - Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle): hooks: Stop: - hooks: - type: command once: true command: | grep -q '"stop_hook_active":true' && exit 0 echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'

Después, prueba con estos

Cuando Claude confirme que está conectado, pídele cosas como:

¿Qué pedidos de venta entraron esta semana y por qué importe?

Hazme un resumen de facturación de este mes comparado con el anterior

¿Cuáles son mis 10 clientes con más facturación este año?

Lista los artículos que no aparecen en ningún pedido del último trimestre

Las dos vías en detalle

Lo que el prompt sopesa por ti, para quien prefiera montarlo a mano.

SAP no tiene un conector de IA oficial para Business One. Su apuesta de Joule + MCP oficiales (2026) cubre solo el suite enterprise (S/4HANA, HANA Cloud, Commerce Cloud, ABAP); B1 queda fuera. Para B1, lo *oficial* es el API de integración; la capa de IA la montas encima. Abajo, las dos vías reales.
Oficial · soportado por SAP

Service Layer (API REST / OData)

El API REST oficial de SAP B1. Claude lo llama directo desde una skill, sin servidor extra.

El Service Layer es el API REST oficial de SAP Business One (OData v4, JSON). Corre sobre la misma lógica de negocio que el cliente de escritorio, así que respeta los permisos y validaciones de SAP. Todo lo demás (MCP, conectores) termina llamando aquí.

Qué necesitas
  • URL del Service Layer — normalmente https://:50000/b1s/v1/, alcanzable desde donde corre la skill.
  • Company database (CompanyDB) — el código de tu empresa en SAP.
  • Usuario B1 dedicado + contraseña — una cuenta de servicio, no el login de una persona.
  • Una licencia SAP para ese usuario — cada login consume una sesión; valora una licencia named/de integración.
  • Autorizaciones read-only en SAP (General Authorizations) si solo quieres leer — el Service Layer las respeta.
  • Acceso de red + TLS — puerto abierto y certificado confiado (a menudo self-signed). B1 suele ser on-prem, así que la skill corre dentro de la red/VPN.
Capacidades
  • Lectura y escritura (CRUD) — según los permisos del usuario.
  • Objetos legibles: Orders, Items, BusinessPartners, Invoices...
  • Consultas OData: filtros, $select, paginación, orden.
  • Multi-hilo, sin middleware que instalar.
Limitaciones
  • Sin SQL complejo ni transacciones largas (para eso, la DI API).
  • Algunas operaciones avanzadas solo están en la DI API (.NET, solo Windows).
  • Consume una licencia por sesión.
Riesgos
  • Guarda la contraseña en variables de entorno / la config de la skill — nunca en el chat ni en git.
  • Si das permisos de escritura, la skill puede modificar datos reales — empieza en solo lectura.
  • SAP on-prem implica que quien ejecuta necesita línea de visión al servidor (VPN), no una máquina cloud cualquiera.
Conviértelo en una skill para toda la empresa
  1. 1Crea una carpeta de skill .claude/skills/sap-b1/ con un SKILL.md que documente el login + las consultas read-only permitidas (para que Claude no improvise).
  2. 2Pon las credenciales en variables de entorno (SAPB1_URL, SAPB1_DB, SAPB1_USER, SAPB1_PASS), no en el SKILL.md.
  3. 3Login una vez: POST /Login devuelve una cookie B1SESSION. Reúsala para las consultas.
  4. 4Sube la skill al repo de la empresa (o compártela) para que todos tengan el mismo acceso revisado y de solo lectura.
# 1. Login -> session cookie (credentials from env vars)
curl -sk -c cookie.txt -X POST "$SAPB1_URL/Login" \
-H "Content-Type: application/json" \
-d "{\"CompanyDB\":\"$SAPB1_DB\",\"UserName\":\"$SAPB1_USER\",\"Password\":\"$SAPB1_PASS\"}"

# 2. Read with the session cookie (OData query, read-only)
curl -sk -b cookie.txt \
"$SAPB1_URL/Orders?\$select=DocNum,DocDate,CardName,DocTotal&\$top=20"
No oficial · terceros

Servidor MCP (CData / comunitario)

Un servidor MCP expone B1 como herramientas para Claude. Cero código, pero dependes de un tercero.

No hay MCP oficial de SAP para B1. Los que existen son de terceros — CData (read-only vía drivers JDBC, CRUD completo solo en su plataforma de pago Connect AI) o servidores comunitarios que envuelven el Service Layer. Claude se conecta al MCP y consulta en lenguaje natural.

Qué necesitas
  • El servidor MCP instalado (ej. CData MCP for SAP Business One; hoy Windows, macOS en camino).
  • Un driver de conexión — CData usa drivers JDBC a los datos de B1.
  • Credenciales — según el MCP: usuario B1 + company DB (estilo Service Layer) o usuario de BD read-only (HANA / SQL Server).
  • Registrar el MCP en Claude — claude mcp add ... (Claude Code) o la config de Claude Desktop.
  • Para CRUD completo, CData requiere su plataforma de pago (Connect AI); el MCP gratis es read-only.
  • Mismo acceso de red + TLS que la vía del API.
Capacidades
  • Consulta en lenguaje natural sin escribir queries.
  • Reutilizable: una vez montado, cualquiera con acceso al MCP lo usa.
  • El servidor gratis de CData es read-only out of the box — bueno para reporting.
Limitaciones
  • No oficial — sin soporte de SAP.
  • El tier gratis suele ser read-only; CRUD = plataforma de pago.
  • Menos control fino sobre qué consulta Claude (es una herramienta genérica).
  • Dependes del mantenimiento del tercero.
Riesgos
  • Revisa la madurez y seguridad del MCP de un tercero antes de darle datos reales.
  • Si conecta a la BD directa (no al Service Layer), se salta los permisos de SAP — contrólalo con GRANT SELECT solo.
  • Las credenciales pasan por el servidor MCP — confía en dónde corre.

Cara a cara

Service Layer (API REST / OData)Servidor MCP (CData / comunitario)
Soporte SAPOficialNinguno (terceros)
MontajeUna skill + credencialesInstalar un servidor MCP
Lectura / escrituraCRUD según permisosRead-only (gratis); CRUD de pago
Control sobre ClaudeAlto — tú defines las queriesMedio — herramienta genérica
Respeta permisos de SAPSí (vía usuario B1)Service Layer: sí · BD directa: no
CosteLicencia SAPLicencia SAP + posible licencia CData
MantenimientoTu skillTercero
Mejor paraSkills a medida, control, producciónPiloto rápido, consulta ad-hoc

Recomendación

Para producción y control, gana el método oficial: está soportado por SAP, respeta tus permisos de SAP, te da control total sobre lo que hace Claude y no depende de terceros. El MCP no oficial es ideal para un piloto rápido o consulta ad-hoc en lenguaje natural. En ambos casos: empieza en solo lectura, usa una cuenta de servicio dedicada y guarda las credenciales en variables de entorno, nunca en el chat ni en git.

Rebundle · 2026