Claude te hará unas preguntas, revisará tu ordenador y te dirá exactamente qué pedir o configurar en SAP. Solo tienes que seguirle.
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."}}'