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 instalado
- Cuenta de Frihet con acceso a la API (planes de pago)
- Servidor MCP de Frihet configurado (ver instrucciones)
Instalacion
Opcion 1: Clonar y enlazar
git clone https://github.com/berthelius/frihet-mcp.git
ln -s "$(pwd)/frihet-mcp/skill" ~/.claude/skills/frihet
Opcion 2: Copiar directamente
# Descargar solo la skill
curl -sL https://raw.githubusercontent.com/berthelius/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet/SKILL.md --create-dirs
Configurar el servidor MCP
Si aun no lo tienes, anade esto a tu ~/.claude/mcp.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 | 31 herramientas CRUD | 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