> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facture.ar/llms.txt
> Use this file to discover all available pages before exploring further.
# Facturar desde Claude, ChatGPT o tu agente de IA
> Conectá Facturear a Claude, ChatGPT, Cursor o cualquier agente compatible con MCP: creá tu cuenta, configurá tu CUIT en ARCA y emití facturas electrónicas desde el chat.
# Facturar desde tu agente de IA
Facturear se usa también desde el chat. Lo conectás una vez a Claude, ChatGPT, Cursor o cualquier agente compatible con **MCP** (Model Context Protocol) y después le pedís cosas como:
* "Dame de alta el CUIT 20-12345678-9 y configuralo en ARCA"
* "Haceme una factura C de \$85.000 a Juan Pérez, DNI 30123456, por el servicio de septiembre"
* "¿Cuántas facturas emití este mes y cuánto me queda del plan?"
No hace falta tener cuenta de antemano: si no tenés, la creás en el mismo paso en que conectás el agente.
**URL del conector:** `https://www.facture.ar/api/mcp`
## La forma rápida: pegale esto a tu agente
Copiá este mensaje y pegalo en el chat de tu agente (también está, con el botón **Copiar mensaje**, en **Configuración → Agentes IA** dentro del panel):
```text theme={null}
Conectá Facturear (facturación electrónica ARCA, Argentina) como servidor MCP. Las instrucciones para agentes están en https://www.facture.ar/llms.txt: leelas y hacé la conexión. La URL del servidor es https://www.facture.ar/api/mcp, con login OAuth (no hace falta client ID ni secret). Si no podés agregar conectores vos mismo, decime los pasos exactos para hacerlo en esta app y después ayudame a facturar.
```
Un agente con terminal (Claude Code, Codex CLI, Cursor) lee [facture.ar/llms.txt](https://www.facture.ar/llms.txt) y se conecta solo. Claude y ChatGPT no pueden agregar conectores desde el chat, pero te dicen exactamente qué tocar en su app. Si preferís hacerlo a mano, los pasos están abajo.
***
## Cómo funciona el login
No le das tu contraseña ni tu API Key al agente. La conexión usa **OAuth**, el mismo mecanismo que "Iniciar sesión con Google":
Pegás la URL del conector en tu agente (los pasos para cada uno están abajo).
Se abre facture.ar en tu navegador. Entrás con Google o con un link a tu email. Si no tenías cuenta, se crea en ese momento, con el plan Free.
Facturear te muestra qué agente pide acceso y qué va a poder hacer. Tocás **Permitir** y volvés al chat.
Podés ver y desconectar los agentes conectados cuando quieras desde **Configuración → Agentes IA** en el panel.
***
## Conectarlo, paso a paso
Funciona en claude.ai, Claude Desktop y Cowork, en cualquier plan (el plan gratuito admite un conector personalizado).
Andá a **Personalizar → Conectores** (Customize → Connectors).
Tocá **+** y elegí **Agregar conector personalizado** (Add custom connector).
Nombre: `Facturear`. URL: `https://www.facture.ar/api/mcp`. No completes Client ID ni Client Secret: no hacen falta.
Tocá **Conectar**, iniciá sesión en Facturear y aprobá el acceso.
En planes Team o Enterprise, primero un Owner agrega el conector en **Configuración de la organización → Conectores**, y después cada persona lo conecta con su cuenta.
En chatgpt.com, tu foto de perfil → **Configuración → Seguridad e inicio de sesión** (Settings → Security and login) y activá **Modo desarrollador** (Developer mode). Por ahora se activa solo desde la web.
Andá a **Plugins** y tocá **+**. Nombre: `Facturear`. Descripción: `Facturas electrónicas de ARCA`. En **Conexión** (Connection), la URL del servidor MCP: `https://www.facture.ar/api/mcp`. Autenticación: **OAuth**. No pide Client ID ni Secret.
Creá la conexión, iniciá sesión en Facturear y aprobá el acceso.
En un chat nuevo, **+ → Modo desarrollador** y marcá Facturear. Pedile las cosas nombrándolo: "usá Facturear para...".
Necesitás ChatGPT Plus, Pro, Business, Enterprise o Edu: el plan gratuito no admite conectores propios. En Business/Enterprise, si no ves **Modo desarrollador**, lo habilita un admin del workspace.
```bash theme={null}
claude mcp add --transport http facturear https://www.facture.ar/api/mcp
```
Después, dentro de Claude Code, corré `/mcp`, elegí **facturear** y autenticá: se abre el navegador para iniciar sesión y aprobar.
En Codex CLI es parecido:
```bash theme={null}
codex mcp add facturear --url https://www.facture.ar/api/mcp
```
Cualquier cliente MCP con transporte HTTP y OAuth sirve. En Cursor, en `~/.cursor/mcp.json`:
```json theme={null}
{
"mcpServers": {
"facturear": { "url": "https://www.facture.ar/api/mcp" }
}
}
```
Al primer uso te pide iniciar sesión en Facturear.
**Sin navegador (scripts, servidores):** usá tu [API Key](/es/guides/api-keys) como token: header `Authorization: Bearer TU_API_KEY`. La key de test opera en homologación y la de producción en producción.
***
## Tu clave fiscal nunca pasa por el chat
Para configurar un CUIT, Facturear hace por vos los trámites en ARCA (certificados, autorización del web service y punto de venta) y para eso necesita tu **clave fiscal**. Esa clave **no se escribe en el chat**:
1. Le pedís al agente que configure tu CUIT.
2. El agente te da un **link de un solo uso** a una página de Facturear.
3. Escribís la clave ahí. Va directo a Facturear, cifrada; el agente y el modelo de IA nunca la ven.
4. El agente sigue el progreso y te avisa cuando el CUIT está listo para facturar.
El link vence a los 30 minutos y sirve una sola vez. Si usás un agente en la terminal, también te puede dar un comando que pide la clave sin mostrarla en pantalla y la envía directo a Facturear.
Si por error escribiste tu clave fiscal en un chat, cambiala desde el sitio de ARCA. Facturear nunca te la va a pedir por chat.
***
## Qué puede hacer el agente
| Herramienta | Para qué |
| - | - |
| `get_profile` | Quién está conectado: id de la cuenta y, si están, nombre y email |
| `get_account` | Plan, uso del mes y estado de cada CUIT |
| `add_cuit` | Dar de alta un CUIT (lo valida con el padrón de ARCA) |
| `setup_cuit` | Configurarlo en ARCA con el link seguro para la clave fiscal |
| `get_cuit_setup_status` | Ver en qué paso está la configuración |
| `create_invoice` | Emitir una factura, en homologación o en producción |
| `get_invoice_batch` | Ver si ARCA la autorizó (CAE) o por qué la rechazó |
| `list_invoices` / `get_invoice` | Buscar facturas y obtener el detalle y el link al PDF |
| `send_invoice_email` | Mandar el PDF de una factura autorizada por email (hasta 5 destinatarios, con un mensaje opcional) |
| `list_templates` | Ver tus plantillas: CUIT, punto de venta, modo, cliente fijo, lista de precios e instrucciones |
| `propose_invoice` | Armar un borrador con los datos de un documento que leyó el agente (remito, pedido, mensaje, planilla). En modo `automatic` se emite solo si no hay observaciones |
| `list_drafts` | Ver los borradores pendientes de revisar o emitir, con sus observaciones |
| `issue_drafts` | Emitir ante ARCA los borradores que le indiques |
`create_invoice`, `list_invoices` y `propose_invoice` reciben `environment` (`homologation` o `production`). Con login OAuth el agente lo tiene que indicar en cada llamada; con una API Key lo fija la key y no puede pedir el otro entorno.
`create_invoice` acepta además `idempotency_key`: el agente manda un UUID nuevo por factura y, si la llamada falla por red o timeout, la repite con la misma clave; Facturear devuelve la emisión original en vez de emitir otra. `propose_invoice` cumple la misma función con `externalId`. Ver [Reintentar sin duplicar facturas](/es/guides/idempotencia).
Probá primero en **homologación**: el agente emite facturas de prueba, sin valor fiscal. En producción, el agente te confirma importe, receptor y tipo de comprobante antes de emitir.
***
## Preguntas frecuentes
En Claude no: el plan gratuito admite un conector personalizado. En ChatGPT sí: los conectores propios requieren Plus, Pro, Business, Enterprise o Edu, con el modo desarrollador activado.
Tus CUITs, tu plan y uso, y tus facturas. Nunca tu clave fiscal ni las claves privadas de tus certificados.
Desde el panel, en **Configuración → Agentes IA**, tocá **Desconectar** en **Agentes conectados**. El agente pierde el acceso en su próxima llamada. También podés quitarlo desde la configuración de conectores de tu agente.
Revisá que la URL sea exactamente `https://www.facture.ar/api/mcp` (con `www`) y que no hayas cargado un Client ID o Client Secret. Si sigue fallando, escribinos desde el chat de soporte del panel.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.