Automatizează-ți Afacerea cu Frihet, Claude și n8n

Frihet are o API REST completă, 14 tipuri de webhook și un server MCP oficial. n8n este un motor de automatizare open source cu interfață vizuală. Claude este un asistent AI capabil să execute acțiuni în sisteme externe prin MCP.

Combinate, formează un stack care poate automatiza aproape orice operațiune administrativă dintr-o afacere mică — fără cod, fără ingineri, fără costuri de agenție.

Iată cum funcționează în practică.

Arhitectura de bază

Frihet (date afacere)
    ↕ webhook / API REST
n8n (orchestrare fluxuri)
    ↕ HTTP / MCP
Claude (inteligență, decizie)
    ↕ acțiuni
Frihet / Email / Telegram / Slack

Frihet generează evenimente (factură creată, plată primită, cheltuială înregistrată). n8n le interceptează și orchestrează ce se întâmplă mai departe. Claude adaugă inteligență când este necesar — formatează un mesaj, decide dacă o anomalie merită o alertă, generează un raport.

Flux 1: Notificare plată primită → Telegram

Scenariul: Când un client plătește o factură, primești imediat o notificare pe Telegram.

În Frihet: activează webhook-ul invoice.paid din Setări → Integrări → Webhooks. Specifică URL-ul n8n.

În n8n:

1. Nod Webhook (trigger) — ascultă pe endpoint-ul configurat în Frihet
2. Nod Set — extrage câmpurile relevante: client_name, amount, invoice_number
3. Nod Telegram — trimite mesajul: „Plată primită: {{client_name}} — {{amount}} EUR (Factura {{invoice_number}})”

Configurare: 10 minute. Rezultat: știi instantaneu când intră un ban fără să deschizi Frihet.

Flux 2: Raport săptămânal automat

Scenariul: În fiecare luni dimineață la 9

În n8n:

1. Nod Cron (trigger) — „Luni 09
   ”
2. Nod HTTP Request — apelează GET /api/v1/invoices?period=last_week cu API key Frihet în header
3. Nod HTTP Request — apelează GET /api/v1/expenses?period=last_week
4. Nod Code (simplu) — calculează totaluri: income = invoices.reduce(sum), expenses = expenses.reduce(sum)
5. Nod Telegram / Email — trimite rezumatul formatat

Opțional: adaugă un nod Claude între pasul 4 și 5. Îi pasezi datele brute și îi ceri să scrie un rezumat în limbaj natural: „Ești un asistent financiar. Rezumă aceste date ale săptămânii într-un paragraf scurt și menționează dacă există ceva neobișnuit.”

Flux 3: Urmărire automată creanțe

Scenariul: Facturile cu scadența depășită cu mai mult de 7 zile declanșează automat un email de urmărire politicos.

În n8n:

1. Nod Cron — „Zilnic la 08
   ”
2. Nod HTTP Request — GET /api/v1/invoices?status=overdue&days_overdue=7
3. Nod IF — dacă lista nu este goală, continuă
4. Nod Split In Batches — procesează fiecare factură separat
5. Nod HTTP Request — obține datele de contact ale clientului: GET /api/v1/clients/{{client_id}}
6. Nod Email — trimite emailul de urmărire cu template personalizat

Opțional Claude: înainte de a trimite emailul, pasează datele clientului și istoricul de plăți lui Claude și cere: „Scrie un email de urmărire politicos dar ferm pentru un client cu 7 zile de întârziere. Tonul: profesional, fără reproșuri, cu link de plată.” Claude personalizează mesajul pentru fiecare client.

Utilizarea serverului MCP cu Claude

Serverul MCP al Frihet permite lui Claude să execute acțiuni direct — nu doar să genereze text.

Instalare în Claude Desktop:

{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Exemple de comenzi în limbaj natural:

• „Creează o factură pentru ClientABC pentru 3.500 EUR pentru servicii de consultanță în februarie”
• „Arată-mi toate facturile neîncasate de mai mult de 30 de zile”
• „Înregistrează o cheltuială de 85 EUR la combustibil din 14 februarie”
• „Care este totalul cheltuielilor din această lună grupate pe categorie?”

Claude apelează serverul MCP, care apelează API-ul Frihet, care execută acțiunea. Tu nu deschizi nicio pagină web.

Flux 4: Alertă cheltuială neobișnuită

Scenariul: Dacă o cheltuială nouă depășește cu 50% media lunară a categoriei respective, primești o alertă înainte ca aceasta să fie confirmată.

În n8n:

1. Webhook — trigger pe expense.created din Frihet
2. HTTP Request — obține media ultimelor 3 luni pentru acea categorie: GET /api/v1/expenses/stats?category={{category}}&months=3
3. Code — compară: if (newExpense.amount > average * 1.5) { alert = true }
4. IF — dacă alert este true
5. HTTP Request Frihet — adaugă o notă pe cheltuiala respectivă: „Verifică: depășește cu >50% media categoriei”
6. Telegram — trimite alertă cu detalii

Aceasta automatizează detectarea anomaliilor pe care altfel le-ai observa (sau nu) la revizuirea lunară.

Punctul de plecare recomandat

Dacă ești nou la automatizări, ordinea recomandată:

1. Instalează n8n — versiunea self-hosted pe un VPS sau n8n Cloud (5 EUR/lună)
2. Configurează webhook-urile Frihet — activează evenimentele relevante
3. Construiește Fluxul 1 (notificare plată) — simplu, impact imediat vizibil
4. Adaugă Fluxul 2 (raport săptămânal) — valoare imediată fără a fi urgent
5. Configurează serverul MCP dacă folosești Claude zilnic — schimbă modul în care interacționezi cu Frihet

Nu încearca să automatizezi totul dintr-o dată. Fiecare flux care funcționează bine îți dă încredere și context pentru următorul.