Saltar al contenido principal
El servidor MCP de Sintropix permite que un asistente de IA compatible con el Model Context Protocol (MCP), como Claude o ChatGPT, lea tus libros. Preguntas en lenguaje natural, por ejemplo “¿Cuánto me deben mis clientes?”, y el asistente responde con tus datos de Sintropix. El servidor lee tus libros. No puede crear, cambiar ni eliminar nada en ellos. Lo único que envía es feedback sobre Sintropix, que no cambia ningún dato.

​
Conéctate

1

Agrega el servidor a tu asistente

En los ajustes de tu asistente, agrega un conector personalizado (o servidor MCP personalizado) y pega la URL del servidor https://mcp.sintropix.com/mcp. El servidor usa OAuth, así que no necesitas una clave de API ni ningún otro secreto.
2

Inicia sesión en Sintropix

El asistente abre Sintropix en tu navegador. Inicia sesión con tu contraseña y tu segundo factor. Si aún no activaste la verificación en dos pasos, Sintropix te pide hacerlo primero.
3

Elige la Organización

Elige la Organización que leerá el asistente (Elige la empresa). Si tienes Membresía en una sola Organización, Sintropix se salta esta pantalla.
4

Aprueba

Revisa la solicitud: el nombre de la app, el dominio al que te devuelve (Te devolverá a), la Organización y el acceso, que es Solo lectura. Haz clic en Permitir. El asistente queda conectado.
Cada conexión lee una Organización, y todas sus empresas (Entidades). Para leer otra Organización, vuelve a aprobar el asistente y elige esa Organización. Cada aprobación aparece como una fila propia en Tu cuenta > Apps conectadas. El asistente se registra en Sintropix la primera vez que te conectas. Un asistente que vuelve a un esquema propio con host, como cursor://, no puede registrarse, así que no puede conectarse. Consulta las URI de redirección que una app puede registrar.

​
Acceso

  • El asistente lee como tú, en la Organización que aprobaste, con tu Rol en ella. Todos los Roles pueden leer, así que los Usuarios staff, client y viewer pueden conectarse.
  • Si pierdes tu Membresía en la Organización, la conexión termina.
  • Revoca la conexión cuando quieras desde Tu cuenta > Apps conectadas en la app de Sintropix. El asistente pierde el acceso de inmediato y te pide iniciar sesión otra vez la próxima vez que necesite Sintropix.
  • El token de acceso dura 1 hora, y el asistente lo renueva solo. Si el asistente pasa 30 días sin renovarlo, te pide iniciar sesión otra vez.
Consulta Conectar una app con OAuth para ver todas las reglas de las apps conectadas.

​
Herramientas

El servidor expone seis herramientas. Cinco leen tus libros, y leave_feedback les cuenta a los desarrolladores de Sintropix qué se interpuso en el camino del asistente. Cada una responde una pregunta, en lugar de replicar un endpoint de la API. Los montos vienen como texto decimal en la moneda funcional de la empresa, y las cuentas y los Partners vienen con sus nombres.

​
list_entities

Lista las empresas que lee la conexión. Cada elemento tiene entityId, name, taxId, country, currency y organization (el nombre de la Organización). El asistente la llama primero para encontrar el entityId que usan las demás herramientas.

​
get_receivables y get_payables

Listan las líneas abiertas de cada Cuenta Contable por cobrar o por pagar de la empresa, de la más antigua a la más reciente. Cada línea tiene su fecha, fecha de vencimiento, Partner, factura, glosa y monto abierto. Un monto abierto positivo se le debe a la empresa en get_receivables, y lo debe la empresa en get_payables. get_payables también lista lo que la empresa les debe a las personas por rendiciones aprobadas, en sus cuentas de Rendición por pagar.
  • Una línea sin factura es una Partida No Aplicada, como un pago recibido a cuenta. El asistente la informa junto a lo adeudado, nunca neteada contra ello.
  • Cada cuenta devuelve hasta 100 líneas abiertas. openLinesNotShown cuenta el resto.
  • Estas herramientas leen las cuentas cuyo Subtipo es receivable o payable en el plan de cuentas. Si la empresa no marca ninguna cuenta con ese Subtipo, la respuesta no trae cuentas y trae una note que lo indica. Eso no significa que no se deba nada: el asistente lee los saldos con get_balance_sheet.

​
get_income_statement

Devuelve el estado de resultados de un período: ingresos, costo de ventas, gastos operacionales, otros ingresos y otros gastos, cada uno con sus cuentas y su total. También devuelve la utilidad bruta, el resultado operacional, el margen operacional (una razón, null sin ingresos) y el resultado neto.

​
get_balance_sheet

Devuelve el balance general en una fecha: activos, pasivos y patrimonio, cada uno con sus cuentas y su total. La sección de patrimonio también trae el resultado de los años fiscales anteriores y el resultado del año fiscal hasta la fecha. El año fiscal es el de la empresa (ver El año fiscal en los informes), y la respuesta indica el día en que comienza.

​
leave_feedback

Envía feedback a las personas que construyen Sintropix: un error, una respuesta que confundió al asistente, una posible mejora, una molestia, un detalle o algo que quiso hacer y no pudo, con lo que hizo en su lugar. El asistente lo envía por su cuenta, justo cuando encuentra el problema, un problema por llamada. No necesita decírtelo ni pedirte permiso antes, porque el feedback trata sobre el producto, no sobre tus libros. El feedback no cambia nada en tus libros, así que una conexión de Solo lectura también lo envía. La herramienta le pide al asistente dejar fuera los datos de clientes: envía ids y requestId, no nombres, montos ni el contenido de documentos. Consulta Deja fuera los datos de clientes. Las entradas siguen las mismas reglas que POST /api/feedback. La herramienta responde feedbackId, el id del feedback guardado. Si una entrada no cumple una regla, la herramienta responde un error que nombra cada campo y dice qué corregir, por ejemplo kind must be one of: bug, improvement, papercut, nit, missing_capability, y no envía nada.

​
Preguntas de ejemplo

  • “¿Qué empresas puedes ver?”
  • “¿Cuánto le deben los clientes a Acme SpA, de lo más antiguo a lo más reciente?”
  • “¿Qué facturas de Acme SpA están vencidas?”
  • “¿Cuál fue el resultado neto de Acme SpA de enero a junio?”
  • “Muéstrame el balance general de Acme SpA al cierre del mes pasado.”

Conectar una app con OAuth

Scopes, tokens, aprobaciones y cómo listar y revocar apps conectadas.