Skip to main content
Glama
arca-mcp

arca-mcp

by PablosSG85
README.md
# arca-mcp

Conector para consultar **ARCA (ex AFIP)** desde **Claude**, sin abrir el navegador: Mis Comprobantes
(facturas recibidas y emitidas), Cuentas Tributarias (deuda y saldos), Mis Facilidades (planes de pago) y
Presentación de DDJJ y Pagos (declaraciones presentadas y VEP) de todos tus clientes.

- Entra **con tu propia clave fiscal**, guardada cifrada en tu computadora. Nunca con la de un cliente.
- Tus clientes te **delegan los servicios** en ARCA, como ya se hace con el contador.
- Corre en tu computadora: no se publica en internet y nadie más ve tus datos.
- **Sólo consulta.** No presenta, no paga, no acepta nada.

> Es un proyecto independiente, no es de ARCA. Revisá el código antes de usarlo con datos reales.

## Qué necesitás

- Python 3.11 o más nuevo.
- Claude Desktop (o Claude Code).
- Tu clave fiscal nivel 3 o superior.

## 1. Instalar

```bash
pip install git+https://github.com/PablosSG85/arca-mcp
```

## 2. Guardar tu clave (una sola vez)

```bash
arca-mcp-clave
```

Te pide tu CUIT y tu clave fiscal (no se ve mientras escribís). Queda en el Administrador de
credenciales de Windows, el Llavero de Mac o el Secret Service de Linux. Nunca en un archivo.

## 3. Sumarlo a Claude Desktop

En Claude Desktop: Configuración → Desarrollador → Editar configuración, y agregá:

```json
{
  "mcpServers": {
    "arca": { "command": "C:\\ruta\\completa\\a\\arca-mcp.exe" }
  }
}
```

Poné la **ruta completa** del programa: la sacás con `where arca-mcp` (Windows) o `which arca-mcp`
(Mac y Linux). Claude Desktop no siempre encuentra los programas instalados con pip si sólo ponés el
nombre. Reiniciá Claude Desktop. Con Claude Code: `claude mcp add arca -- arca-mcp`.

## 4. Que cada cliente te delegue los servicios

**El cliente** (o el administrador de relaciones, si es una empresa):

1. Entra a ARCA con su clave fiscal → **Administrador de Relaciones de Clave Fiscal**.
2. **Nueva Relación** → Buscar → elige **Mis Comprobantes**. Repite para **Sistema de Cuentas Tributarias**,
   **Mis Facilidades** y **Presentación de DDJJ y Pagos**.
3. Como representante pone **tu CUIT** y confirma.

**Vos:** entrás a ARCA con tu clave → **Aceptación de Designación** → aceptás cada servicio.

## Cómo se usa

Pedile a Claude, por ejemplo:

- «¿Qué clientes tengo en ARCA?»
- «Facturas recibidas de 30-12345678-9 en octubre»
- «Cuentas tributarias 2026 de Pérez SRL: ¿tiene deuda?»
- «¿Pérez SRL tiene algún plan de pagos vigente?»
- «¿Qué declaraciones de IVA presentó Pérez SRL este año? ¿Pagó los VEP?»

La primera consulta del día puede tardar un minuto: ARCA es lenta.

## Cuidados que trae

- **Un solo intento de ingreso.** Si ARCA rechaza la clave, el conector se traba solo para no bloquearte
  la clave por reintentos. Revisala entrando a ARCA a mano, guardala de nuevo con `arca-mcp-clave` y
  destrabalo con `arca-mcp-clave --desbloquear`.
- **Controla el CUIT en cada pantalla.** Si ARCA muestra otro contribuyente, no devuelve esos datos.
- **Nunca inventa ceros.** Si ARCA no devolvió el cuadro, la respuesta dice «incompleto», no «sin deuda».
- Cada consulta queda anotada (sin claves) en `registro.jsonl`, en la carpeta de datos del usuario
  (`%APPDATA%\arca-mcp` en Windows, `~/.local/share/arca-mcp` en Mac y Linux). Para usar otra carpeta,
  definí la variable `ARCA_MCP_DATOS` igual para Claude y para la terminal donde corrés `arca-mcp-clave`.
  Si ARCA rechaza la clave, el mensaje dice dónde quedó el candado.
- De a una consulta por computadora, aunque tengas el conector en Claude Desktop y en Claude Code a la vez.
- Una consulta de Cuentas Tributarias puede tardar hasta tres minutos si ARCA está lenta.

## Licencia

MIT.