Deja de sufrir y comienza a Fluir

Goujana Software ERP — Conector para Claude

Image description 

# Goujana Software ERP — Conector para Claude

Conecta tu ERP **Goujana Software** con **Claude** para consultar y operar tu
negocio en lenguaje natural, de forma segura. Consulta ventas y contabilidad,
busca registros, crea facturas y registra operaciones sin salir del chat.

---

## ¿Qué puedes hacer?

- **Consultar tus finanzas:** resúmenes de ventas, ingresos y gastos por mes o
  año.
- **Buscar y leer registros** de cualquier módulo (clientes, productos,
  facturas, inventario, contabilidad) con filtros avanzados.
- **Emitir facturas de venta** con envío directo a la **DIAN**.
- **Crear, actualizar y eliminar registros** del ERP. Las acciones que
  modifican datos piden confirmación antes de ejecutarse.

Es **multi-empresa y multi-usuario**: cada persona se autentica con su propio
token y solo accede a los datos de su organización.

---

## Cómo conectarlo en Claude

1. Abre **Claude** y ve a **Settings → Connectors**.
2. Haz clic en **Agregar conector personalizado** (*Add custom connector*).
3. Completa los campos:
   - **URL del servidor MCP remoto:** `https://mcp.sofisis.com/mcp`
   - **OAuth Client ID / Secret:** déjalos **vacíos** (el servidor registra el
     cliente automáticamente).
4. Haz clic en **Conectar**. Se abrirá el inicio de sesión.

---

## Cómo autenticarte (tu API Token)

Al conectar, Claude te pedirá iniciar sesión. Ahí debes ingresar tu
**API Token** del ERP.

Para obtener tu token:

1. Ingresa al ERP con tu usuario.
2. Ve a **`/admin/database_router_s/user/`**.
3. Copia tu **API Token** y pégalo en el formulario de login de Claude.

> Tu token es personal: con él Claude accede únicamente a los datos de tu
> organización y según tus permisos en el ERP.

---

## Ejemplos de lo que puedes pedirle a Claude

**Consultar desempeño financiero**
> "¿Cuánto vendimos en mayo de 2026 y cómo se compara con abril?"
> "Dame el total de ingresos y gastos de la empresa este año."

**Buscar registros**
> "Muéstrame las facturas de venta del cliente con NIT 900123456 emitidas este
> trimestre."
> "Lista los productos cuyo stock esté por debajo de 10 unidades."

**Emitir una factura de venta**
> "Crea una factura para el cliente Juan Pérez por 5 unidades del producto
> 'Asesoría mensual' a $200.000 c/u, pago en efectivo, y envíala a la DIAN."

**Registrar o actualizar información**
> "Registra un nuevo cliente: María Gómez, NIT 1019283746, correo
> maria@correo.com."
> "Actualiza el precio del producto 'Asesoría mensual' a $250.000."

---

## Solución de problemas

- **No me deja conectar / error de autenticación:** verifica que copiaste el
  **API Token** completo desde `/admin/database_router_s/user/`, sin espacios.
- **No veo mis datos / faltan registros:** revisa que tu usuario tenga permisos
  sobre ese módulo y empresa en el ERP.
- **No encuentra una empresa, sucursal o producto:** pídele a Claude que primero
  liste las opciones disponibles (p. ej. "lista mis empresas") y confirma cuál
  usar.
- **Una acción de escritura pide confirmación:** es el comportamiento esperado.
  Las operaciones que crean, actualizan o eliminan datos siempre piden tu
  confirmación antes de ejecutarse.

---

## Privacidad

Consulta nuestra política de privacidad y términos:
<https://goujana.co/terminos-y-legal>

Los datos viajan cifrados (HTTPS/TLS) y el conector solo accede a la información
que solicitas. No se almacenan datos más allá de lo necesario para la sesión.

---

## Soporte

¿Necesitas ayuda? Escríbenos a **soporte@goujana.co**.
Whatsapp