Instalación por asistente

Cómo conectar Factunexo a ChatGPT, Codex, Claude, Claude Code, Grok y otros asistentes compatibles con MCP, paso a paso. La dirección del servidor es la misma en todos.

Todos los asistentes siguen el mismo patrón: Ud. agrega la dirección del servidor, se abre su navegador, inicia sesión con su usuario de Factunexo, elige el comercio y aprueba los permisos. Lo que cambia de un asistente a otro es dónde se agrega la dirección.

https://mcp.factunexo.com/mcp

No necesita crear credenciales, copiar claves ni registrar la aplicación en Factunexo. Si el asistente le ofrece campos opcionales como OAuth Client ID o Client Secret, déjelos vacíos.

Cómo es la autorización

Es igual en todos los asistentes, así que conviene conocerla antes de empezar:

Inicio de sesión

Se abre una página en auth.xinersoft.com, el acceso a las cuentas de Xinersoft, la empresa detrás de Factunexo. Ingrese el correo y la contraseña con los que entra a Factunexo. Su contraseña se escribe en esa página, nunca dentro del asistente.

Elección del comercio

Si Ud. administra más de un comercio, elija sobre cuál operará el asistente. La conexión queda atada a ese comercio; para usar otro, deberá conectar de nuevo. Si tiene un solo comercio, este paso no aparece.

Aprobación de permisos

La pantalla muestra la aplicación que pide acceso, el comercio, la dirección a la que se devolverá el acceso y los permisos solicitados. Revise que todo corresponda a la conexión que Ud. inició y haga clic en Autorizar.

ChatGPT

ChatGPT se conecta a servidores MCP externos con el modo desarrollador, disponible en chatgpt.com (web) para los planes Plus, Pro, Business, Enterprise y Education. No está disponible en las aplicaciones de escritorio ni en la móvil.

Planes Business, Enterprise y Education

En los espacios de trabajo de empresa, el administrador puede tener deshabilitado el modo desarrollador o las aplicaciones personalizadas. Si no encuentra las opciones, consulte con el administrador de su espacio de trabajo.

Active el modo desarrollador

En chatgpt.com abra Configuración → Seguridad e inicio de sesión (en inglés, Settings → Security and login) y active Modo desarrollador (Developer mode).

Cree la aplicación

Abra la sección de Aplicaciones (Apps) o Plugins de la configuración, haga clic en el botón + y cree una aplicación nueva con estos datos:

Campo	Valor
Nombre	`Factunexo`
URL del servidor MCP	`https://mcp.factunexo.com/mcp`
Autenticación	OAuth

Deje vacíos los campos avanzados de OAuth: ChatGPT se identifica solo ante Factunexo.

Autorice la conexión

Al guardar se abre la autorización de Factunexo. Inicie sesión, elija el comercio y apruebe los permisos. Al terminar, ChatGPT muestra la aplicación como conectada.

Úsela en un chat

En un chat nuevo abra el menú + junto al cuadro de mensaje, elija Modo desarrollador y seleccione Factunexo. Para obtener mejores resultados, nómbrela en su pedido: «Con Factunexo, dime cuánto vendí esta semana».

Confirmación de acciones

Antes de crear clientes, cargar productos o emitir comprobantes, ChatGPT le pide confirmar y le muestra los datos que enviará. Revíselos: una factura emitida se envía al SRI y no se puede deshacer desde el chat.

Desde la página de la aplicación en la configuración puede activar o desactivar herramientas individuales y actualizar la aplicación para que ChatGPT cargue las herramientas nuevas que Factunexo publique.

Codex

Codex (la terminal, la aplicación y la extensión para editores) comparte la configuración en ~/.codex/config.toml, así que basta con agregar el servidor una vez.

Agregue el servidor

En su terminal ejecute:

codex mcp add factunexo --url https://mcp.factunexo.com/mcp

También puede agregarlo a mano en ~/.codex/config.toml:

[mcp_servers.factunexo]
url = "https://mcp.factunexo.com/mcp"

Inicie sesión

codex mcp login factunexo

Se abre su navegador con la autorización de Factunexo. Al aprobarla, el navegador vuelve a Codex y la terminal confirma el inicio de sesión.

Verifique la conexión

codex mcp list

Dentro de Codex también puede escribir /mcp para ver los servidores activos.

Ejecute el inicio de sesión en su terminal

Si le pide a Codex que ejecute codex mcp login por Ud., su entorno aislado puede bloquearlo con «Operation not permitted». Ejecútelo directamente en su terminal.

Claude (web y escritorio)

Disponible en claude.ai y en Claude Desktop, en todos los planes. En el plan gratuito Claude permite un solo conector personalizado.

Agregue el conector

Abra Personalizar → Conectores (Customize → Connectors), haga clic en + y elija Agregar conector personalizado (Add custom connector).

Pegue la dirección

Escriba Factunexo como nombre y pegue https://mcp.factunexo.com/mcp como URL. No complete la Configuración avanzada (Advanced settings). Haga clic en Agregar.

Conéctelo

Haga clic en Conectar (Connect) junto a Factunexo y complete la autorización en la ventana que se abre.

Actívelo en la conversación

En el chat, abra el botón + de la esquina inferior izquierda, entre a Conectores y active Factunexo.

Planes Team y Enterprise

En estos planes el propietario de la organización agrega primero el conector en Configuración de la organización → Conectores → Agregar → Personalizado → Web, con la misma dirección. Después cada persona entra a Personalizar → Conectores, busca Factunexo y hace clic en Conectar para autorizar con su propio usuario y comercio.

Claude Code

Agregue el servidor

claude mcp add --transport http factunexo https://mcp.factunexo.com/mcp

Autentíquese

Dentro de Claude Code escriba /mcp, elija factunexo y seleccione autenticar. Se abrirá su navegador con la autorización de Factunexo.

Verifique

Vuelva a la terminal. /mcp debe mostrar Factunexo como conectado.

Grok

Entre a grok.com/connectors y elija New Connector → Custom.

Pegue la dirección del servidor.

Complete la autorización en el navegador.

Otros asistentes

Cursor, VS Code, Windsurf, Zed y la mayoría de editores con soporte MCP aceptan servidores remotos. Busque la opción de agregar un servidor MCP remoto o por HTTP —no por comando local— y pegue la misma dirección. Si le pide un tipo de transporte, elija Streamable HTTP.

Factunexo identifica a los asistentes con Client ID Metadata Documents, el mecanismo que recomienda la especificación de MCP. Un asistente que solo admita registro dinámico de clientes no podrá conectarse.

Cambiar de comercio o desconectar

Operar sobre otro comercio: vuelva a autorizar la conexión (en ChatGPT, desconecte y conecte la aplicación; en Codex, codex mcp login factunexo; en Claude Code, /mcp) y elija el otro comercio.
Retirar el acceso: en Factunexo vaya a Configuración → Asistentes de IA. Verá las aplicaciones que Ud. autorizó sobre el comercio activo, con sus permisos y su última actividad. Haga clic en Retirar acceso en la que quiera desconectar: deja de funcionar de inmediato y, para volver a usarla, deberá autorizarla de nuevo. Eliminar el conector en el asistente no basta, porque el acceso concedido sigue vigente hasta que se retira o vence.

Problemas frecuentes

Síntoma	Causa y solución
No aparece la opción de agregar servidores	En ChatGPT, el modo desarrollador no está activo o su plan o espacio de trabajo no lo permite. En Claude, revise los límites de su plan.
«Dynamic client registration not supported»	El asistente no usó Client ID Metadata Documents. En Codex, actualícelo a la última versión y repita `codex mcp login factunexo`.
La autorización dice que no hay comercios	Su usuario no tiene una membresía activa en ningún comercio.
La conexión quedó en el comercio equivocado	Vuelva a autorizar y elija el comercio correcto en el selector.
El asistente conecta pero no puede crear ni emitir	La conexión se autorizó solo con permiso de consulta, o su rol en el comercio no permite esa acción.
No aparecen datos contables	El permiso de contabilidad requiere además rol de propietario, administrador o contador.
En ChatGPT la aplicación está conectada pero no responde	Seleccione Modo desarrollador y la aplicación en el menú + del chat, y nómbrela en su pedido.

On this page