Skill para Claude Code
A skill da Frihet para Claude Code transforma seu terminal em um assistente de gestão empresarial. Não é apenas acesso à API — é inteligência de negócios: contexto fiscal espanhol, receitas de fluxos de trabalho, relatórios financeiros formatados e comandos em linguagem natural.
Requisitos
- Claude Code instalado
- Conta Frihet com acesso à API (planos pagos)
- Servidor MCP Frihet configurado (ver instruções)
Instalação
Recomendado: Um comando (mais de 30 agentes)
npx skills add Frihet-io/frihet-mcp
Instala a skill e a configura automaticamente. Funciona com Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, e mais de 30 agentes.
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 o servidor MCP
Se ainda não o tem, adicione isto ao seu ~/.claude/mcp.json:
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_tu_clave_aqui"
}
}
}
}
Obter chave de API: app.frihet.io > Configuração > API > Criar chave.
Comandos
| Comando | Descrição |
|---|---|
/frihet status | Resumo da conta: últimas faturas, pagamentos pendentes, despesas do mês |
/frihet invoice | Criar, listar ou buscar faturas |
/frihet expense | Registrar e consultar despesas |
/frihet clients | Gerenciar base de clientes |
/frihet quote | Criar e gerenciar orçamentos |
/frihet report | Resumos financeiros (P&L, trimestral, inadimplentes) |
/frihet webhooks | Configurar triggers de automação |
/frihet setup | Configuração guiada e teste de conexão |
Exemplos de uso
Criar uma fatura
/frihet invoice "Acme SL, 40 horas de consultoria a 75 EUR/hora, vencimento 1 março"
Claude cria a fatura com as linhas de detalhe, calcula IVA a 21%, e confirma o número atribuído.
Registrar despesas rápido
/frihet expense "47.50 gasolina 15 feb"
/frihet expense "Adobe CC 59.99 software"
/frihet expense "Comida cliente 23.40 restaurante"
A skill infere a categoria e marca se é dedutível de acordo com as regras fiscais espanholas.
Preparar o IVA trimestral
/frihet report quarterly
Calcula automaticamente:
- IVA repercutido (cobrado em faturas)
- IVA suportado (pago em despesas dedutíveis)
- Resultado a pagar ou compensar
- Dados prontos para o Modelo 303
Acompanhamento de inadimplentes
/frihet report unpaid
Lista faturas vencidas ordenadas por valor, dias de atraso, e sugere ações de acompanhamento.
Fechamento mensal
/frihet report
Resumo completo do mês: receitas faturadas, despesas, resultado líquido, IVA líquido, faturas pendentes de cobrança.
Contexto fiscal integrado
A skill conhece o contexto fiscal espanhol:
| Conceito | Detalhe |
|---|---|
| IVA geral | 21% |
| IVA reduzido | 10% (alimentação, transporte) |
| IVA super-reduzido | 4% (pão, livros, medicamentos) |
| IRPF profissionais | 15% (7% primeiros 3 anos) |
| Modelo 303 | IVA trimestral: abr, jul, out, jan |
| Modelo 130 | IRPF trimestral (estimativa direta) |
| Verifactu | Obrigatório: sociedades jan 2027, autônomos jul 2027 |
Também conhece as regras de dedutibilidade de despesas (gasolina 50%, refeições máx. 26.67 EUR/dia, etc.) e as aplica automaticamente ao registrar despesas.
Fluxos de trabalho
A skill inclui receitas para operações comuns:
- Fechamento mensal — Resumo de receitas, despesas, IVA e resultado líquido
- Preparação 303 — Pré-cálculo do IVA trimestral com desagregação por linha
- Cadastro de cliente — Criar cliente + primeira fatura em uma única etapa
- Orçamento para fatura — Converter um orçamento aceito em fatura
- Lote de despesas — Registrar múltiplas despesas de uma vez com categorização automática
- Inadimplentes — Faturas vencidas, ordenadas por valor, com dias de atraso
Diferença com o servidor MCP
| Servidor MCP | Skill | |
|---|---|---|
| Escopo | 52 ferramentas CRUD | Ferramentas + inteligência de negócios |
| Contexto | Nenhum | Fiscal espanhol, dedutibilidade, calendário |
| Fluxos | Operações unitárias | Receitas multi-etapas (fechamento, 303, conversão) |
| Formato | JSON bruto | Tabelas e resumos legíveis |
| Pré-requisito | Chave de API | Chave de API + servidor MCP |
A skill usa o servidor MCP por baixo. Não duplica lógica, adiciona contexto.
Segurança
- A chave de API é gerenciada exclusivamente via variáveis de ambiente na configuração MCP
- A skill nunca exibe, registra ou armazena sua chave de API
- Todos os dados viajam criptografados entre Claude Code, o servidor MCP e a API da Frihet
- O servidor MCP não armazena nada — ponte stateless