# Skill para Claude Code

La skill de Frihet para Claude Code convierte tu terminal en un asistente de gestion empresarial. No es solo acceso a la API — es inteligencia de negocio: contexto fiscal espanol, recetas de flujos de trabajo, informes financieros formateados y comandos en lenguaje natural.

## Requisitos

- [Claude Code](https://claude.ai/claude-code) instalado
- Cuenta de Frihet con acceso a la API (planes de pago)
- Servidor MCP de Frihet configurado ([ver instrucciones](/desarrolladores))

## Instalacion

### Recomendado: Un comando (30+ agentes)

```bash
npx skills add Frihet-io/frihet-mcp
```

Instala el skill y lo configura automaticamente. Funciona con Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, y [30+ agentes mas](https://agentskills.io).

### Alternativa: Copiar manualmente

```bash
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
  -o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
```

### Configurar el servidor MCP

Si aun no lo tienes, anade esto a tu `~/.claude/mcp.json`:

```json
{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["-y", "@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "fri_tu_clave_aqui"
      }
    }
  }
}
```

Obtener API key: **app.frihet.io > Configuracion > API > Crear clave**.

## Comandos

| Comando            | Descripcion                                                           |
| ------------------ | --------------------------------------------------------------------- |
| `/frihet status`   | Resumen de cuenta: ultimas facturas, pagos pendientes, gastos del mes |
| `/frihet invoice`  | Crear, listar o buscar facturas                                       |
| `/frihet expense`  | Registrar y consultar gastos                                          |
| `/frihet clients`  | Gestionar base de clientes                                            |
| `/frihet quote`    | Crear y gestionar presupuestos                                        |
| `/frihet report`   | Resumenes financieros (P&L, trimestral, morosos)                      |
| `/frihet webhooks` | Configurar triggers de automatizacion                                 |
| `/frihet setup`    | Configuracion guiada y test de conexion                               |

## Ejemplos de uso

### Crear una factura

```
/frihet invoice "Acme SL, 40 horas de consultoria a 75 EUR/hora, vencimiento 1 marzo"
```

Claude crea la factura con las lineas de detalle, calcula IVA al 21%, y confirma el numero asignado.

### Registrar gastos rapido

```
/frihet expense "47.50 gasolina 15 feb"
/frihet expense "Adobe CC 59.99 software"
/frihet expense "Comida cliente 23.40 restaurante"
```

La skill infiere la categoria y marca si es deducible segun las reglas fiscales espanolas.

### Preparar el IVA trimestral

```
/frihet report quarterly
```

Calcula automaticamente:

- IVA repercutido (cobrado en facturas)
- IVA soportado (pagado en gastos deducibles)
- Resultado a ingresar o compensar
- Datos listos para el Modelo 303

### Seguimiento de morosos

```
/frihet report unpaid
```

Lista facturas vencidas ordenadas por importe, dias de retraso, y sugiere acciones de seguimiento.

### Cierre mensual

```
/frihet report
```

Resumen completo del mes: ingresos facturados, gastos, resultado neto, IVA neto, facturas pendientes de cobro.

## Contexto fiscal integrado

La skill conoce el contexto fiscal espanol:

| Concepto           | Detalle                                              |
| ------------------ | ---------------------------------------------------- |
| IVA general        | 21%                                                  |
| IVA reducido       | 10% (alimentacion, transporte)                       |
| IVA superreducido  | 4% (pan, libros, medicamentos)                       |
| IRPF profesionales | 15% (7% primeros 3 anos)                             |
| Modelo 303         | IVA trimestral: abr, jul, oct, ene                   |
| Modelo 130         | IRPF trimestral (estimacion directa)                 |
| Verifactu          | Obligatorio: sociedades ene 2027, autonomos jul 2027 |

Tambien conoce las reglas de deducibilidad de gastos (gasolina 50%, comidas max 26.67 EUR/dia, etc.) y las aplica automaticamente al registrar gastos.

## Flujos de trabajo

La skill incluye recetas para operaciones comunes:

- **Cierre mensual** — Resumen de ingresos, gastos, IVA y resultado neto
- **Preparacion 303** — Pre-calculo del IVA trimestral con desglose por linea
- **Alta de cliente** — Crear cliente + primera factura en un solo paso
- **Presupuesto a factura** — Convertir un presupuesto aceptado en factura
- **Lote de gastos** — Registrar multiples gastos de una vez con categorizacion automatica
- **Morosos** — Facturas vencidas, ordenadas por importe, con dias de retraso

## Diferencia con el servidor MCP

|                  | Servidor MCP          | Skill                                        |
| ---------------- | --------------------- | -------------------------------------------- |
| **Alcance**      | 157 herramientas      | Herramientas + inteligencia de negocio       |
| **Contexto**     | Ninguno               | Fiscal espanol, deducibilidad, calendario    |
| **Flujos**       | Operaciones unitarias | Recetas multi-paso (cierre, 303, conversion) |
| **Formato**      | JSON crudo            | Tablas y resumenes legibles                  |
| **Prerequisito** | API key               | API key + servidor MCP                       |

La skill **usa** el servidor MCP por debajo. No duplica logica, anade contexto.

## Seguridad

- La API key se gestiona exclusivamente via variables de entorno en la config MCP
- La skill nunca muestra, loguea ni almacena tu API key
- Todos los datos viajan cifrados entre Claude Code, el servidor MCP y la API de Frihet
- El servidor MCP no almacena nada — puente stateless

## Enlaces

- [Codigo fuente (GitHub)](https://github.com/Frihet-io/frihet-mcp)
- [Servidor MCP (npm)](https://www.npmjs.com/package/@frihet/mcp-server)
- [API REST](/desarrolladores/api-rest)
- [Webhooks](/desarrolladores/webhooks)
- [Servidor MCP remoto](https://mcp.frihet.io)