# Facturear: cómo conectarse como agente de IA

> Facturear (facture.ar) emite facturas electrónicas de ARCA (ex AFIP, Argentina): facturas A, B, C, E, M y notas de crédito/débito con CAE, para uno o varios CUITs. Este archivo está escrito para agentes de IA (Claude, ChatGPT, Cursor, Codex, Gemini CLI y cualquier cliente MCP): explica cómo conectarse a Facturear y qué se puede hacer una vez conectado. Idioma de la cuenta: español (Argentina).

## When to use this

Use Facturear when the job is to issue an Argentine electronic invoice through ARCA (formerly AFIP): factura A, B, C, E or M, or a nota de crédito or débito, and return the CAE. Use it to register a CUIT, finish the ARCA setup, turn a ticket, order, spreadsheet or chat message into a draft, and send the authorized PDF to the buyer. Call it over MCP at https://www.facture.ar/api/mcp (OAuth, or a bearer API key for scripts) or over the REST API documented at https://www.facture.ar/openapi.json.

The free plan is self-serve (10 invoices a month, 1 CUIT, no card). API keys are created by the account holder at https://www.facture.ar/app/api-keys. A test key is the sandbox: it invoices in ARCA homologation and cannot emit a production voucher. Confirm amount, receiver and voucher type with the person before issuing in production.

Do not use Facturear for tax advice, to file a VAT return, or to invoice outside Argentina.

Si sos un agente y una persona te pidió "conectate a Facturear": seguí la sección "Conectarse" para tu propio cliente. Si tu cliente no te deja agregar conectores por tu cuenta, mostrale a la persona los pasos de su app tal como figuran abajo, en español, sin inventar menús.

## Conectarse

- Servidor MCP: https://www.facture.ar/api/mcp
- Transporte: Streamable HTTP (POST JSON-RPC a esa URL). No hay endpoint SSE separado.
- Autenticación: OAuth 2.1 con PKCE y registro dinámico de clientes (RFC 7591). NO hace falta client_id ni client_secret previos: el cliente se registra solo en el registration_endpoint. Un pedido sin token devuelve 401 con el header WWW-Authenticate apuntando a la metadata del recurso (RFC 9728).
  - Metadata del recurso protegido: https://www.facture.ar/.well-known/oauth-protected-resource/api/mcp
  - Metadata del servidor de autorización: https://www.facture.ar/.well-known/oauth-authorization-server
  - authorization_endpoint: https://www.facture.ar/oauth/authorize
  - token_endpoint: https://www.facture.ar/api/oauth/token
  - registration_endpoint: https://www.facture.ar/api/oauth/register
  - revocation_endpoint: https://www.facture.ar/api/oauth/revoke
  - scope: facturear (el único que existe)
  - grant types: authorization_code (con PKCE S256) y refresh_token
- Qué pasa en el login: se abre https://www.facture.ar en el navegador de la persona; entra con Google o con un link a su email (si no tenía cuenta, se crea en ese momento con el plan Free) y aprueba el acceso del agente. La persona ve el nombre del cliente que pediste en el registro: registrate como "Facturear" o con el nombre de tu app, no con un id opaco.
- Sin navegador (scripts, servidores, automatizaciones): en lugar de OAuth, mandá una Clave API de Facturear como bearer: header "Authorization: Bearer TU_API_KEY". Las claves se crean en https://www.facture.ar/app/api-keys. Una clave de test opera en homologación (pruebas) y una de producción en producción; con clave API el entorno queda fijo por la clave.

### Claude Code (terminal)

Ejecutá vos mismo:

    claude mcp add --transport http facturear https://www.facture.ar/api/mcp

Después la persona corre /mcp dentro de Claude Code, elige "facturear" y autentica en el navegador.

### Codex CLI (terminal)

    codex mcp add facturear --url https://www.facture.ar/api/mcp

Al primer uso se abre el navegador para iniciar sesión en Facturear.

### Cursor, Windsurf, Gemini CLI y otros clientes MCP con archivo de configuración

Agregá el servidor a la configuración del cliente (en Cursor, ~/.cursor/mcp.json; en Gemini CLI, ~/.gemini/settings.json):

    {
      "mcpServers": {
        "facturear": { "url": "https://www.facture.ar/api/mcp" }
      }
    }

Al primer uso el cliente abre el navegador para iniciar sesión y aprobar.

### Claude (claude.ai, Claude Desktop, Cowork)

Vos no podés agregar el conector desde el chat: dale a la persona estos pasos.

1. Personalizar → Conectores (Customize → Connectors).
2. Tocá + y elegí "Agregar conector personalizado" (Add custom connector).
3. Nombre: Facturear. URL: https://www.facture.ar/api/mcp. Dejá vacíos Client ID y Client Secret.
4. Tocá Conectar, iniciá sesión en Facturear y aprobá el acceso.

Funciona en el plan gratuito de Claude (admite un conector personalizado). En Team o Enterprise, primero lo agrega un Owner en Configuración de la organización → Conectores, y después cada persona lo conecta con su cuenta.

### ChatGPT

Vos no podés agregar el conector desde el chat: dale a la persona estos pasos. Requiere ChatGPT Plus, Pro, Business, Enterprise o Edu; el plan gratuito no admite conectores propios.

1. Foto de perfil → Configuración → Seguridad e inicio de sesión (Settings → Security and login) → activá "Modo desarrollador" (Developer mode). Solo en la web (chatgpt.com). En Business/Enterprise puede depender de la política del workspace: si no aparece, lo habilita un admin.
2. Andá a Plugins y tocá + (plus). Nombre: Facturear. Descripción: "Facturas electrónicas de ARCA (Argentina): dar de alta CUITs y emitir facturas". En Conexión (Connection), URL del servidor MCP: https://www.facture.ar/api/mcp. Autenticación: OAuth. No pide client ID ni secret.
3. Creá la conexión, iniciá sesión en Facturear y aprobá el acceso.
4. En un chat nuevo, tocá + → "Modo desarrollador" (Developer mode) y marcá Facturear. Pedile las cosas mencionando Facturear ("usá Facturear para...").

### Si algo falla

- La URL es exactamente https://www.facture.ar/api/mcp (con www). Sin Client ID ni Client Secret.
- Si el login no vuelve al agente, revisá que el cliente registre un redirect_uri con https, un esquema propio de la app (cursor://, vscode://) o http://localhost / http://127.0.0.1 en cualquier puerto.
- La persona puede ver y desconectar agentes en https://www.facture.ar/app/agentes.

## Qué podés hacer una vez conectado (tools MCP)

Empezá siempre por get_account.

| Tool | Para qué |
| --- | --- |
| get_account | Plan, uso del mes (facturas y CUITs contra el límite) y cada CUIT con su estado en ARCA |
| add_cuit | Dar de alta un CUIT (se valida contra el padrón de ARCA) |
| setup_cuit | Configurarlo en ARCA (certificado, web service, punto de venta). Devuelve un link de un solo uso para que la persona cargue su clave fiscal directamente en Facturear |
| get_cuit_setup_status | En qué paso está esa configuración (tarda unos minutos) |
| create_invoice | Emitir una factura en "homologation" (prueba, sin valor fiscal) o "production" (comprobante real). Devuelve un batchId: la emisión es asíncrona. Factura E al exterior: invoiceType 19 con monId y el bloque export (el CUIT tiene que tener habilitada la factura al exterior en https://www.facture.ar/app/facturacion/nueva/exterior) |
| get_invoice_batch | Si ARCA la autorizó (CAE) o por qué la rechazó |
| list_invoices / get_invoice | Buscar facturas y obtener el PDF |
| send_invoice_email | Mandarle el PDF al cliente por email |
| propose_invoice | Pasarle los datos de un documento (remito, pedido, foto, planilla, mensaje) y recibir un borrador con receptor del padrón, tipo A/B/C e IVA resueltos |
| list_drafts / issue_drafts | Ver los borradores y emitirlos cuando la persona confirma |
| list_templates | Plantillas con cliente fijo, lista de precios y CUIT por tipo de documento |

## Reglas para el agente

1. La clave fiscal de ARCA NUNCA pasa por el chat. Para configurar un CUIT usá setup_cuit y dale a la persona el link seguro que devuelve; no le pidas la clave, y si la escribe igual no la repitas ni la uses, y sugerile cambiarla en ARCA.
2. Las facturas de producción son comprobantes fiscales reales. Antes de emitir en "production" confirmá con la persona importe, receptor (CUIT/DNI) y tipo de comprobante.
3. Probá primero en homologación cuando la cuenta es nueva.
4. Si get_account muestra el límite del plan alcanzado, decíselo: el plan se mejora en https://www.facture.ar/app/account.

## Cuenta, planes y soporte

- Cuenta y plan: https://www.facture.ar/app/account (Free: 10 facturas/mes y 1 CUIT; Básica: 1.000 facturas/mes y 1 CUIT; Pro: 25.000 facturas/mes y 25 CUITs; Enterprise a medida).
- Agentes conectados: https://www.facture.ar/app/agentes
- Claves API: https://www.facture.ar/app/api-keys
- Guía para personas: https://docs.facture.ar/es/guides/agentes-ia
- API REST: https://www.facture.ar/openapi.json (índice https://www.facture.ar/api/v1, catálogo https://www.facture.ar/.well-known/api-catalog). Errores en application/problem+json, con code, message y resolution.
- Sandbox (homologación): https://www.facture.ar/api/v1/sandbox. La clave de test se crea sola en https://www.facture.ar/app/api-keys.
- Ficha pública del servidor MCP, con la lista de tools: https://www.facture.ar/.well-known/mcp/server-card.json
- Documentación completa del producto: https://docs.facture.ar (índice para agentes: https://docs.facture.ar/llms.txt)
- Sobre Facturear: https://www.facture.ar/about
- Contacto: https://www.facture.ar/contact (hola@facture.ar)
- Privacidad: https://www.facture.ar/privacy
- Mapa del sitio: https://www.facture.ar/sitemap.xml