Skill para Claude Code
La skill de Frihet para Claude Code convierte tu terminal en un asistente de gestión empresarial. No es solo acceso a la API — es inteligencia de negocio: contexto fiscal español, 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)
Instalación
Recomendado: Un comando (30+ agentes)
npx skills add Frihet-io/frihet-mcp
Instala el skill y lo configura automáticamente. Funciona con Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, y 30+ agentes más.
Alternativa: Copiar manualmente
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, añade 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: en app.frihet.io, ve a Integraciones → API Keys y pulsa Crear API Key.
Comandos
| Comando | Descripción |
|---|---|
/frihet status | Resumen de cuenta: últimas 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 | Resúmenes financieros (P&L, trimestral, morosos) |
/frihet webhooks | Configurar triggers de automatización |
/frihet setup | Configuración guiada y test de conexión |
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 líneas de detalle, calcula IVA al 21%, y confirma el número asignado.
Registrar gastos rápido
/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 categoría y marca si es deducible según las reglas fiscales españolas.
Preparar el IVA trimestral
/frihet report quarterly
Calcula automáticamente:
- 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, días 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 español:
| Concepto | Detalle |
|---|---|
| IVA general | 21% |
| IVA reducido | 10% (alimentación, transporte) |
| IVA superreducido | 4% (pan, libros, medicamentos) |
| IRPF profesionales | 15% (7% primeros 3 años) |
| Modelo 303 | IVA trimestral: abr, jul, oct, ene |
| Modelo 130 | IRPF trimestral (estimación directa) |
| Verifactu | Obligatorio: contribuyentes del Impuesto sobre Sociedades ene 2027, resto jul 2027 (aplazamiento a oct 2028 anunciado, pendiente de BOE) |
También conoce las reglas de deducibilidad de gastos (gasolina 50%, comidas max 26.67 EUR/día, etc.) y las aplica automáticamente al registrar gastos.
Flujos de trabajo
La skill incluye recetas para operaciones comunes:
- Cierre mensual — Resumen de ingresos, gastos, IVA y resultado neto
- Preparación 303 — Pre-cálculo del IVA trimestral con desglose por línea
- Alta de cliente — Crear cliente + primera factura en un solo paso
- Presupuesto a factura — Convertir un presupuesto aceptado en factura
- Lote de gastos — Registrar múltiples gastos de una vez con categorización automática
- Morosos — Facturas vencidas, ordenadas por importe, con días de retraso
Diferencia con el servidor MCP
| Servidor MCP | Skill | |
|---|---|---|
| Alcance | 157 herramientas | Herramientas + inteligencia de negocio |
| Contexto | Ninguno | Fiscal español, deducibilidad, calendario |
| Flujos | Operaciones unitarias | Recetas multi-paso (cierre, 303, conversión) |
| Formato | JSON crudo | Tablas y resúmenes legibles |
| Prerequisito | API key | API key + servidor MCP |
La skill usa el servidor MCP por debajo. No duplica lógica, añade contexto.
Seguridad
- La API key se gestiona exclusivamente vía 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