MCP

La API expone un servidor MCP (Model Context Protocol), el estándar abierto para conectar asistentes y agentes de IA con herramientas. Sirve para cualquier cliente compatible con MCP que permita un servidor HTTP remoto con un header de autorización (Claude, Cursor, VS Code, Windsurf, tu propio agente…): el asistente integra y opera arcafactura con tu API key.

URL: https://api.arcafactura.com/mcp (transporte Streamable HTTP)
Autenticación: header Authorization: Bearer <API_KEY>

La forma más fácil: pegale esto a tu asistente (reemplazá <TU_API_KEY> por tu key; al crear una key en el portal te lo damos ya completo):

Agregá el servidor MCP de arcafactura (facturación electrónica de ARCA, Argentina) a tu configuración de MCP:

- Nombre: arcafactura
- Tipo: HTTP (Streamable HTTP)
- URL: https://api.arcafactura.com/mcp
- Header: Authorization: Bearer <TU_API_KEY>

Si sos Claude Code, corré:
claude mcp add --transport http arcafactura https://api.arcafactura.com/mcp --header "Authorization: Bearer <TU_API_KEY>"

Si tu cliente usa un archivo JSON (mcpServers), agregá:
{ "arcafactura": { "type": "http", "url": "https://api.arcafactura.com/mcp", "headers": { "Authorization": "Bearer <TU_API_KEY>" } } }

Cuando esté conectado:
1. Llamá a la herramienta guia_integracion y contame en pocas líneas qué podés hacer.
2. Para probar usá siempre el entorno "homologacion". Antes de emitir en "produccion" (comprobantes reales), mostrame la vista previa con previsualizar_comprobante y esperá mi confirmación.
3. Usá una idempotencyKey distinta por comprobante y reusala si tenés que reintentar.

Desde la terminal (ejemplo con Claude Code; otros clientes tienen un comando parecido):

claude mcp add --transport http arcafactura https://api.arcafactura.com/mcp \
  --header "Authorization: Bearer $ARCAFACTURA_API_KEY"

Clientes con configuración JSON (la mayoría usa este formato; el nombre de la clave puede variar, por ejemplo servers en VS Code):

{
  "mcpServers": {
    "arcafactura": {
      "type": "http",
      "url": "https://api.arcafactura.com/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}

Herramientas:

Tool	Qué hace
`guia_integracion`	Esta guía (contrato, campos, errores, catálogos).
`catalogos_arca`	Códigos ARCA válidos en JSON.
`listar_certificados`	Certificados guardados en la bóveda (alias, vencimiento, vigencia; `via` en los CUIT representados).
`enviar_comprobante`	Manda el PDF por mail al cliente.
`consultar_padron`	Datos del receptor según ARCA (nombre, domicilio, condición IVA y, si es monotributista, la categoría del monotributo).
`representar_cuit`	Delegación: un CUIT factura con un certificado de la cuenta (sin claves).
`emitir_comprobante`	Emite con el certificado de la bóveda. Pide `idempotencyKey`. En producción emite un comprobante real.
`consultar_comprobante`	Estado guardado de una emisión por `idempotencyKey`, sin reemitir.
`reconciliar_comprobante`	Resuelve contra ARCA una emisión que quedó sin confirmar, sin reemitir.
`tutoriales`	Paso a paso para configurar ARCA: certificados, autorización de wsfe, punto de venta, de dónde sacar cada dato para la factura, errores de ARCA.
`datos_emisor`	Datos para la factura guardados por CUIT.
`guardar_datos_emisor`	Guarda los datos para la factura de un CUIT (incluido el nombre de fantasía).
`listar_plantillas`	Plantillas del PDF de la cuenta.
`guardar_plantilla`	Crea o reemplaza una plantilla (formato, estilo, color, encabezado, nombre de fantasía, pie, predeterminada, puntos de venta). El logo se sube desde el portal o con la API.
`previsualizar_comprobante`	El PDF de un comprobante sin emitirlo (BORRADOR): para mostrarlo antes de confirmar.

Por seguridad, la clave privada no se sube por MCP (pasaría por el modelo de IA): los certificados se cargan desde el portal.