Documentación para desarrolladores

Última actualización: 15 de octubre de 2026

Cuentix es una plataforma para que prepares, revises y presentes tus propios impuestos. Esta página documenta las rutas públicas que usa un asistente para encontrar el conector de Cuentix. No existe una API financiera anónima: los datos de una empresa solo se leen con la autorización de su usuario.

Ver la especificación OpenAPI (/openapi.json)

Qué es público

Dos rutas responden sin iniciar sesión. Ambas son de solo lectura y devuelven metadatos de descubrimiento en JSON. Ninguna devuelve facturas, movimientos bancarios ni información de una empresa.

Método	Ruta	Devuelve
`GET`	`/.well-known/oauth-authorization-server`	Dónde autorizar y obtener tokens (RFC 8414)
`GET`	`/.well-known/oauth-protected-resource/api/mcp`	Qué servidor protege al conector y qué permisos acepta (RFC 9728)

Metadatos del servidor de autorización

Indica las direcciones para autorizar, obtener y revocar tokens, y los métodos que acepta.

Solicitud

curl -s https://www.cuentixapp.com/.well-known/oauth-authorization-server

Respuesta

{
  "issuer": "https://www.cuentixapp.com",
  "authorization_endpoint": "https://www.cuentixapp.com/api/ai-connector/authorize",
  "token_endpoint": "https://www.cuentixapp.com/api/ai-connector/token",
  "registration_endpoint": "https://www.cuentixapp.com/api/ai-connector/register",
  "revocation_endpoint": "https://www.cuentixapp.com/api/ai-connector/revoke",
  "response_types_supported": ["code"],
  "grant_types_supported": ["authorization_code", "refresh_token"],
  "token_endpoint_auth_methods_supported": ["none"],
  "code_challenge_methods_supported": ["S256"],
  "scopes_supported": ["financial:read", "ledger:read", "distribucion:propose"],
  "client_id_metadata_document_supported": false
}

Metadatos del conector

Describe el conector MCP de Cuentix como recurso protegido y apunta al servidor de autorización de arriba.

Solicitud

curl -s https://www.cuentixapp.com/.well-known/oauth-protected-resource/api/mcp

Respuesta

{
  "resource": "https://www.cuentixapp.com/api/mcp",
  "resource_name": "Cuentix",
  "authorization_servers": ["https://www.cuentixapp.com"],
  "scopes_supported": ["financial:read", "ledger:read", "distribucion:propose"],
  "bearer_methods_supported": ["header"]
}

Usa siempre www.cuentixapp.com. La dirección sin www redirige con un 307.

Acceso a los datos de una empresa

Los metadatos son públicos para que cualquier asistente compatible pueda encontrar el conector. Los datos no lo son.

Para leer información de una empresa, su usuario conecta el asistente desde el conector MCP de Cuentix, inicia sesión y aprueba el acceso.
El acceso se limita a las empresas y permisos que el usuario aprueba, y puede revocarlo cuando quiera desde Cuentix.
Sin esa autorización, ninguna ruta devuelve información fiscal o financiera.

Cómo protegemos esos datos: Seguridad

Sobre /openapi.json

Es una especificación OpenAPI 3.1 que describe solo las dos rutas públicas de esta página. Sirve como referencia de descubrimiento.

No incluye rutas de escritura, de autenticación ni la lista de herramientas del conector.
No es un manifiesto de plugin de ChatGPT.

Contacto

¿Integras un asistente o encontraste un error en estos metadatos? Escríbenos a hola@cuentix.mx.