MCP'deki Kaynaklar ve Araçlar arasında ne fark var?

Araçlar API'ye karşı eylemler yürütür (fatura oluştur, giderleri listele). Kaynaklar, aracının API çağrıları yapmadan sorgulayabileceği statik referans verilerini ifşa eder. Vergi oranları, mali takvimler veya gider kategorileri her zaman bağlam olarak mevcuttur.

MCP İstemleri nedir ve nasıl kullanılır?

İstemler, birden fazla aracı mantıksal bir sıra içinde birbirine bağlayan rehberli iş akışlarıdır. Ayrı ayrı operasyonlar yürütmek yerine, aylık kapanış gibi bir istem, aracıyı adım adım yönlendirir: bekleyen faturaları gözden geçir, giderleri kategorize et, vergi yükümlülüklerini doğrula.

v1.2'yi kullanmak için bir şeyi güncellemem gerekiyor mu?

npx @frihet/mcp-server kullanıyorsanız, en son sürümü otomatik olarak alırsınız. Sabit bir kurulumunuz varsa, npm update @frihet/mcp-server ile güncelleyin. v1.1.0'a göre kırılma değişiklikleri yoktur.

MCP Sunucusu v1.2: kaynaklar, istemler ve yapılandırılmış çıktı

Frihet MCP sunucusunun 1.2.1 sürümü daha fazla araç eklemiyor. Zeka ekliyor. Ajanların vergi bağlamına soru sormadan sahip olmaları için Kaynaklar. Müdahale olmadan eksiksiz akışlar yürütmeleri için İstemler. Her yanıtın deterministik bir şekilde ayrıştırılabilir olması için yapılandırılmış çıktı.

Bu güncelleme, MCP sunucusunu bir CRUD operasyon köprüsünden, AI ajanları için eksiksiz bir iş yönetimi arayüzüne dönüştürüyor.

Kaynaklar: her zaman mevcut referans verileri

MCP Kaynakları, ajanın Frihet API’sine çağrı yapmadan istediği zaman okuyabileceği statik verilerdir. Kota tüketmezler, ek kimlik doğrulama gerektirmezler ve sunucu bağlandığı andan itibaren mevcuttur.

v1.2, 5 kaynak sunar:

`frihet://api/schema`

Mevcut tüm uç noktaların, kimlik doğrulama yöntemlerinin ve hız limitlerinin özeti. Bir ajan Frihet ile ne yapabileceğini öğrenmesi gerektiğinde, deneme yanılma yoluyla keşfetmek yerine bu kaynağa başvurur.

`frihet://tax/rates`

İspanya’da yürürlükte olan vergi oranları: genel IVA (%21), indirimli (%10) ve süper indirimli (%4); Kanarya Adaları IGIC (%7, %3, %0); IRPF kesintileri. Ajan, bir fatura oluşturmadan veya bir gider kaydetmeden önce bu bağlama sahiptir. İşletmenizin nerede faaliyet gösterdiğini zaten biliyorsa, hangi IVA’yı uygulayacağını size sormasına gerek yoktur.

`frihet://tax/calendar`

Üç aylık beyannamelerin sunulma tarihleri: Model 303 (IVA), Model 130 (IRPF), Model 420 (IGIC). Ajan üç aylık kapanışı hazırladığında, her yükümlülüğün ne zaman vadesinin geldiğini tam olarak bilir.

`frihet://config/expense-categories`

Muafiyet kurallarıyla birlikte 8 gider kategorisi. Ofis malzemeleri, sarf malzemeleri, ulaşım, harcırahlar, eğitim, sigorta, profesyonel hizmetler, diğerleri. Her kategori, muafiyet yüzdesini ve geçerli koşulları içerir.

`frihet://config/invoice-statuses`

Bir faturanın durum akışı: taslak, düzenlendi, gönderildi, tahsil edildi, vadesi geçmiş, iptal edildi. Her durum, izin verilen geçişleri ve etkinleştirilebilecek tetikleyicileri (webhook’lar, bildirimler) içerir. Ajan, her an hangi eylemlerin geçerli olduğunu bilir.

İstemler: rehberli iş akışları

Bir Araç bir operasyon yürütür. Bir İstem, birkaç operasyonu tutarlı bir akış içinde orkestra eder. Fark, “bu gideri oluştur”dan “bu 15 gider biletini işle, kategorize et, doğru vergileri uygula ve oluşturmadan önce onayla”ya geçmektir.

v1.2, 5 istem içerir:

`monthly-close`

Rehberli aylık kapanış. Ajan, tahsil edilmemiş faturaları gözden geçirir, atanmamış giderleri kategorize eder, dönemin vergi yükümlülüklerinin karşılandığını doğrular ve bir özet oluşturur. Normalde bir saat manuel inceleme gerektiren bir akış, bir görüşmede yürütülür.

`onboard-client`

Yeni müşteri kaydı. Müşterinin konumuna göre vergi türünü belirler (anakara IVA’sı, Kanarya Adaları IGIC’i, AB içi), doğru vergi verileriyle kaydı oluşturur ve bir hoş geldin teklifi oluşturur. Hepsi tek bir sıra halinde.

`quarterly-tax-prep`

Üç aylık vergi hazırlığı. Dönemin tüm faturalarını toplar, IVA veya IGIC vergi matrahlarını hesaplar, IRPF kesintilerini uygular ve Model 303 veya 130’un önizlemesini oluşturur. Ajan işi yapar; siz veya yöneticiniz sonucu doğrularsınız.

`overdue-followup`

Vadesi geçmiş faturaların takibi. Süresi geçmiş tüm faturaları tanımlar, müşteriye göre gruplandırır, her biri için toplam ödenmemiş tutarı hesaplar ve kişiselleştirilmiş tahsilat mesajları hazırlar. “Bana ne borçlu olduklarını kontrol etmem gerekiyor”dan “işte göndermeye hazır taslaklar”a.

`expense-batch`

Toplu gider işleme. Bir gider listesi alır, yapılandırılmış kurallara göre kategorize eder, ilgili vergileri uygular, her birinin muafiyetini doğrular ve önceden onay ile oluşturur. Bir haftalık veya bir seyahatin birikmiş biletlerini işlemek için idealdir.

Yapılandırılmış çıktı: ayrıştırılabilir yanıtlar

Şimdiye kadar, MCP sunucusunun yanıtları biçimlendirilmiş metindi. İnsan okuması için faydalı olsa da, ajanlar programatik kararlar almak için yapılandırılmış verilere ihtiyaç duyarlar.

v1.2, her araca outputSchema ve structuredContent ekler. Her yanıt, döndürülen verilerin yapısını tam olarak açıklayan bir JSON şeması içerir. Ajan, çağırmadan önce hangi alanları alacağını, tiplerinin ne olduğunu ve hangilerinin isteğe bağlı olduğunu bilir.

İşte bu, quarterly-tax-prep gibi bir istemin 4 operasyonu güvenilir bir şekilde birbirine bağlamasını sağlayan şeydir: her adım, bir sonraki adımın belirsizlik olmadan tüketebileceği bilinen bir yapıya sahip veriler üretir.

MCP sunucusu üzerinde entegrasyonlar geliştiren geliştiriciler için bu, serbest metni ayrıştırma ihtiyacını ortadan kaldırır. Yanıt her zaman aynı formdadır.

Güvenlik notları

MCP sunucusundaki her araç artık işlemin salt okunur mu yoksa yıkıcı mı olduğunu gösteren ek açıklamalar içerir. Bir list-invoices okuma olarak işaretlenmiştir. Bir delete-expense yıkıcı olarak işaretlenmiştir.

Bu, ajanların onay politikalarını uygulamasına olanak tanır. Bir ajan, okuma operasyonlarını sormadan yürütebilir, ancak verileri silmeden veya değiştirmeden önce açık bir onay isteyebilir. Güvenlik ajana bağlı değildir — sunucu tarafından tanımlanır.

Evrensel kurulum

Sunucu, herhangi bir uyumlu ajana tek bir komutla kurulur:

npx @frihet/mcp-server

Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex ve herhangi bir MCP istemcisinde çalışır. Beceriler aracılığıyla kurulumu destekleyen ajanlar için:

npx skills add Frihet-io/frihet-mcp

Her iki yöntem de 30’dan fazla araca, 5 kaynağa, 5 isteme ve yapılandırılmış çıktıya erişim sağlar.

Frihet-io altında depo

MCP sunucusu GitHub’daki Frihet-io organizasyonuna devredilmiştir. Deponun URL’si artık github.com/Frihet-io/frihet-mcp’dir. Önceki bağlantılar otomatik olarak yönlendirilir.

NPM paketi hala @frihet/mcp-server’dır. Kurulumda değişiklik yoktur.

Bu güncelleme kimler için?

MCP sunucusunu zaten kullanan profesyoneller, otomatik vergi bağlamı olarak Kaynaklar ve daha önce manuel olarak adım adım yürüttükleri akışlar olarak İstemler kazanırlar.

Frihet üzerinde geliştirme yapan geliştiriciler, deterministik entegrasyonlar için yapılandırılmış çıktı ve onay politikaları için güvenlik ek açıklamaları kazanırlar.

Muhasebe büroları ve vergi danışmanları, iş akışlarına özel istemler kazanırlar: aylık kapanış, üç aylık hazırlık, tahsilat takibi.

AI ajanları kullanan herhangi bir işletme, sadece operasyonları yürütmekle kalmayıp, aynı zamanda bunları gerçek iş akışlarında nasıl birbirine bağlayacağını bilen bir MCP sunucusu kazanır.

Nasıl güncellenir

Eğer npx @frihet/mcp-server kullanıyorsanız, zaten en son sürüme sahipsiniz. Sabit bir kurulumunuz varsa:

npm update @frihet/mcp-server

Kırılma değişiklikleri yoktur. Mevcut tüm araçlar arayüzlerini korur. Kaynaklar, İstemler ve yapılandırılmış çıktı saf eklemelerdir.

Tam dokümantasyon docs.frihet.io/desarrolladores adresinde bulunmaktadır. Kaynak kodu GitHub’da (Frihet-io/frihet-mcp). Paket npm’de @frihet/mcp-server olarak mevcuttur.