SINCOW ERP · Conector MCP

Conector SINCOW para Claude y otros asistentes de IA

Consulte la información de su empresa en SINCOW con lenguaje natural desde Claude, ChatGPT u otro cliente compatible con MCP. Verá solo lo que sus permisos en SINCOW le permiten ver, y ningún dato se modifica sin que usted lo confirme dentro de SINCOW.

1. Qué es

El conector es un servidor MCP (Model Context Protocol, el estándar abierto para conectar asistentes de IA con sistemas externos). Al agregarlo, su asistente de IA puede consultar en SINCOW cartera, cuentas por pagar, inventario, contabilidad, tesorería y nómina, y buscar en la ayuda del sistema, para responder sus preguntas con los datos reales de su empresa.

URL del servidor https://mcp.sincow.co/mcp

Esta dirección es para el asistente de IA, no para abrirla en el navegador: si la abre directamente verá un mensaje técnico de error. Es normal.

2. Requisitos

Tener un usuario activo en SINCOW.
Que su empresa haya activado las conexiones de IA. Lo hace el administrador de SINCOW en Configuración → Usuarios → Conexiones IA, donde también acepta los términos de uso y decide si se permiten las consultas de nómina y las acciones.
Un cliente de IA compatible con MCP por HTTP: Claude (claude.ai, Claude Desktop o Claude Code), ChatGPT u otro.

3. Conectarlo en Claude (claude.ai y Claude Desktop)

Con esta forma no hay que copiar tokens: usted inicia sesión en SINCOW y autoriza el acceso.

En Claude, abra Configuración → Conectores y elija Agregar conector personalizado.
Escriba un nombre (por ejemplo, SINCOW) y la URL https://mcp.sincow.co/mcp.

Si Claude muestra opciones avanzadas, deje las que detecta solo:

Opción	Valor
Autenticación	Iniciar sesión ahora
Cliente OAuth	Usar la identidad publicada de Claude (también funciona «Registrar automáticamente»)
Encabezados de solicitud	Ninguno
Transporte	HTTP transmisible

Pulse Conectar. Claude abrirá la página de SINCOW (app.sincow.co). Inicie sesión si aún no lo ha hecho.
En la pantalla de autorización revise qué se le concede al asistente (consulta, nómina, acciones), confirme con su contraseña y acepte.
Vuelva a Claude: el conector queda activo y puede empezar a preguntar.

En ChatGPT el procedimiento es el mismo: agregue un conector personalizado con la misma URL y autorice el acceso cuando SINCOW lo pida.

4. Otros clientes: conexión con token personal

Para Claude Code u otros clientes MCP que no ofrecen inicio de sesión, use un token personal:

En SINCOW, abra su Perfil y vaya a la sección de conexiones de IA.
Cree un Nuevo token: póngale un nombre (p. ej. Claude en mi portátil), elija su vigencia (hasta 365 días) y, si quiere, restrinja las direcciones IP desde las que se puede usar.
Copie el token en ese momento: por seguridad no se vuelve a mostrar.
Regístrelo en su cliente. En Claude Code:
```
claude mcp add --transport http sincow https://mcp.sincow.co/mcp --header "Authorization: Bearer sw_…"
```
En otros clientes, registre la URL con transporte HTTP y agregue el encabezado Authorization: Bearer seguido de su token.

Trate el token como una contraseña: quien lo tenga consulta SINCOW con sus permisos. No lo comparta ni lo guarde en documentos o repositorios.

5. Qué puede consultar

Todas las consultas son de solo lectura y respetan sus permisos: si en SINCOW no tiene acceso a una opción, el asistente tampoco.

Módulo	Consulta
Terceros	Buscar un cliente o proveedor por documento o nombre.
Cuentas por cobrar	Cartera de un cliente: documentos con saldo, vencimiento, días de mora y saldos a favor.
Cuentas por pagar	Lo que se le debe a un proveedor (con anticipos girados y disponibles) y el detalle de un documento con sus pagos y notas.
Inventario	Existencia de un artículo por bodega (reservado, disponible, costo promedio, precio), una factura de venta y su estado ante la DIAN, y un pedido de cliente con lo pendiente por entregar.
Materiales	Una orden de compra con lo recibido y lo pendiente por recibir.
Tesorería	Saldo de hoy de cada cuenta bancaria y el detalle de un comprobante de egreso.
Contabilidad	Saldo de una cuenta a una fecha de corte (también por tercero), un asiento con sus partidas y su documento de origen, y el resultado de la última Auditoría de Integridad.
Nómina	Datos de nómina de un empleado: cargo, sueldo, novedades vigentes y su última nómina aprobada. Solo si la empresa permite consultas de nómina y usted las incluyó al autorizar.
Ayuda de SINCOW	Buscar en el manual del sistema, leer una página de ayuda y explicar un mensaje de error.

6. Acciones con confirmación

Si su empresa lo permite y usted lo autoriza, el asistente puede preparar (nunca grabar) estos documentos:

Cotización

Para un cliente, con precios de su lista de precios.

Pedido de cliente

Al confirmarlo reserva la existencia disponible.

Pedido interno

Material para un centro de costos que usted tenga autorizado.

Tercero

Persona o empresa nueva en el maestro de terceros.

Asiento contable

Asiento manual cuadrado, con terceros y centros de costo.

Novedad de nómina

Horas extras, incapacidades, vacaciones, préstamos y otras.

El asistente le entrega un enlace a SINCOW. Allí, con su sesión de SINCOW, usted revisa la propuesta y la confirma o la descarta. Una propuesta sin confirmar vence a los 30 minutos.

La confirmación siempre ocurre en SINCOW y nunca en el chat. Así, una instrucción escondida en un dato de un tercero (una descripción, una observación) no puede grabar nada en su nombre.

El conector no puede anular documentos, enviar documentos a la DIAN, hacer pagos, ejecutar cierres ni cambiar usuarios o permisos.

7. Ejemplos de preguntas

«¿Cuánto me debe el cliente Comercializadora Andina y qué tiene vencido?»
«¿Qué le debo al proveedor con NIT 900123456 y qué anticipos tengo sin aplicar?»
«¿Cuántas unidades disponibles hay del artículo MESA-120 en cada bodega?»
«Muéstrame el asiento del comprobante CE número 1520 y dime si está cuadrado.»
«¿Cuál es el saldo de la cuenta 1105 al 30 de septiembre?»
«¿Qué encontró la última auditoría de integridad?»
«Prepara una cotización para el cliente Ferretería El Roble: 10 unidades de MESA-120.»

En Claude también aparecen indicaciones guiadas: Estado de cartera de un cliente, Qué le debo a un proveedor, Revisar un asiento contable y Existencia de un artículo.

8. Seguridad y privacidad

Sus permisos mandan. El conector actúa como usted: no ve más de lo que usted ve en SINCOW, y su empresa puede restringir aún más lo que se consulta.
Inicio de sesión estándar. La autorización usa OAuth 2.1 con PKCE. Su contraseña se escribe solo en SINCOW y nunca llega al asistente de IA.
Accesos de corta duración. El acceso que recibe el asistente dura una hora y se renueva automáticamente. Si el asistente deja de usar la conexión, la renovación vence a los 30 días, y una autorización dura como máximo un año.
Registro de cada llamada. SINCOW registra cada consulta (usuario, herramienta, fecha y resultado) para auditoría.
Límites de uso. Hay un tope de consultas por minuto por usuario y por empresa, y se bloquean los intentos repetidos con credenciales inválidas.
Qué datos salen de SINCOW. El resultado de cada consulta (por ejemplo, la cartera de un cliente o los datos de un empleado) se envía al asistente de IA que usted conectó y queda sujeto a las políticas de ese proveedor. Conecte solo clientes de IA en los que su empresa confíe.

Para más detalle sobre el tratamiento de datos personales, consulte la política de privacidad de SINCOW.

9. Revocar el acceso

Puede cortar una conexión en cualquier momento:

Desde SINCOW: en su Perfil, en la sección de conexiones de IA, aparecen sus tokens y las autorizaciones de conectores (marcadas como Conector). Revóquela y el asistente pierde el acceso de inmediato; las propuestas que estuvieran pendientes de confirmar quedan anuladas.
Desde Claude: en Configuración → Conectores, desconecte o elimine el conector.
Para toda la empresa: el administrador puede desactivar las conexiones de IA en Configuración → Usuarios → Conexiones IA.

10. Solución de problemas

Al abrir la dirección en el navegador aparece {"error":"not_found"} o «use POST».: Es lo esperado: la dirección es para el asistente de IA, no para el navegador. Verifique que la URL registrada en el conector termine en /mcp.
SINCOW dice que mi empresa no ha activado la conexión con IA.: Pídale al administrador de SINCOW que la active en Configuración → Usuarios → Conexiones IA.
El asistente responde «Falta el token o no es válido».: El token se revocó o venció, o se copió incompleto. Con el conector de Claude, desconéctelo y vuelva a conectarlo; con un token personal, cree uno nuevo en su perfil.
El asistente no encuentra datos de nómina.: La empresa debe permitir las consultas de nómina, usted debe incluirlas al autorizar y debe tener permiso para verlas en SINCOW.
El asistente dice que debo esperar o que hay demasiadas consultas.: Se alcanzó el límite de consultas por minuto. Espere un minuto y vuelva a intentarlo.
La propuesta que preparó el asistente aparece como vencida.: Las propuestas duran 30 minutos. Pídale al asistente que la prepare de nuevo y confírmela en SINCOW.

11. Soporte

Si algo no funciona, escríbanos indicando el cliente de IA que usa, la hora aproximada y el mensaje exacto que vio.

WhatsApp: +57 320 768 0563
Sitio web: sincow.co