bulut API Dokümantasyonu
Postman
Ana Sayfa › Yapay Zeka Ajanları › MCP Araç Listesi

MCP Araç Listesi

MCP Araç Listesi, Evobulut ön muhasebe / ERP yazılımının Yapay Zeka Ajanları modülüne ait bir REST API servisidir. POST yöntemiyle https://ws.evobulut.com/api/mcp adresine JSON gönderilerek çağrılır; kimlik doğrulama Authorization: Bearer başlığındaki ajan anahtarı ile yapılır (Login ve UID gerekmez).

POSThttps://ws.evobulut.com/api/mcp
Açıklama

evobulut MCP sunucusundaki araçlar. Ajanlar listeyi ve her aracın parametre şemasını tools/list ile sunucudan alır; bu tablo özet içindir. Tüm araçlar ajan anahtarının bağlı olduğu kullanıcının yetkisiyle çalışır.

AraçTürNe yapar
cari_araOkumaCari arar (ad, ünvan, kod; vergi no, TC, telefon tam eşleşme). Dönen id = cari_id.
cari_detayOkumaCari kartı: vergi bilgileri, telefonlar, adresler, e-postalar, notlar, banka hesapları.
cari_ekstreOkumaTarih aralığında cari hesap hareketleri ve yürüyen bakiye (TL ya da tek döviz).
borc_alacak_ozetiOkumaFirmanın tüm carilerinin toplam borç, alacak ve net bakiyesi.
stok_araOkumaÜrün/hizmet arar (kod, ad, barkod); kalan miktar, birim, satış fiyatı.
stok_detayOkumaÜrün kartı: fiyatlar, KDV, birimler ve çarpanları, barkodlar.
stok_depo_miktarOkumaÜrünlerin depo bazında eldeki miktarı.
stok_hareketleriOkumaÜrünün onaylı giriş/çıkış hareketleri: kime, ne zaman, kaç adet, hangi fiyattan.
siparis_listeleOkumaAlınan (50) / verilen (51) siparişler; onay, cari, tarih, açık sipariş süzgeçleri.
siparis_detayOkumaSiparişin başlığı, toplamları ve satırları (teslim edilen / kalan miktar).
siparis_durumlariOkumaSipariş durum tanımları.
teklif_listeleOkumaVerilen (61) / alınan (60) teklifler.
fatura_listeleOkumaFaturalar (31 satış, 30 alış, iadeler, fişler); kalan tutar dahil.
fatura_detayOkumaFaturanın başlığı, toplamları ve satırları (id ya da belge no ile).
aktivite_listeleOkumaGörüşme / not / ziyaret kayıtları; firmadaki aktivite türleri buradan öğrenilir.
doviz_listesiOkumaTanımlı dövizler (doviz_id; 0 = TL).
doviz_kuruOkumaVerilen tarihten önceki son yayımlanmış kurlar.
depo_listesiOkumaKullanıcıya atanmış depolar.
sube_listesiOkumaFirmanın şubeleri.
kullanici_listesiOkumaAktif kullanıcılar (id, ad, departman) — görev atamak için.
cari_ekleYazmaFirma ya da kişi cari kartı (telefon, e-posta, adres ile). Aynı vergi/TC no varsa yeni kart açmaz.
siparis_olusturYazmaSipariş taslağı (onaysız). Satırlar: stok_id, miktar, KDV hariç birim fiyat.
teklif_olusturYazmaTeklif taslağı (onaysız); varsayılan tür 61 (satış teklifi).
aktivite_ekleYazmaCariye görüşme notu / aktivite. E-posta gönderen ve konum isteyen türler bu araçla girilemez.
gorev_ekleYazmaKullanıcıya ya da departmana görev; isteğe bağlı cari ve hedef tarih.

Ortak kurallar

  • Kimlik numaraları (cari_id, stok_id, doviz_id, depo_id, sube_id, kullanıcı id) önce arama/liste araçlarıyla bulunur.
  • Tarihler gg.aa.yyyy, saatler SS:dd biçimindedir; yanlış biçim açıklayıcı bir hata mesajıyla reddedilir.
  • Listeler sayfa başına 30 kayıt döner; sayfa 0'dan başlar, toplam tüm eşleşme sayısıdır.
  • Tutarlar aksi belirtilmedikçe yerel para birimindedir.
  • Yazma araçları tekrar_anahtari alır: aynı değerle gelen ikinci çağrı yeni kayıt açmaz, ilk sonucu döner.
  • "Alış fiyatlarını göremez" yetkisi olan kullanıcının anahtarıyla alış fiyatı ve maliyet alanları dönmez.
Header Bilgileri
AuthorizationBearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Acceptapplication/json, text/event-stream
İstek Gövdesi (JSON)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "cari_ara",
    "arguments": {
      "ara": "evosoft",
      "sayfa": 0
    }
  }
}
Kod Örnekleri
curl -X POST "https://ws.evobulut.com/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "cari_ara",
    "arguments": {
      "ara": "evosoft",
      "sayfa": 0
    }
  }
}'
Başarılı Yanıt
200 OK
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"toplam\":\"1\",\"kayitlar\":[{\"id\":\"12345\",\"kod\":\"120.01.001\",\"ad\":\"EvoSoft Yazılım\",\"resmi_ad\":\"EvoSoft Yazılım Ltd. Şti.\",\"vergi_no\":\"1234567890\",\"telefon\":\"0222 000 00 00\",\"il\":\"Eskişehir\",\"ozet\":\"EvoSoft Yazılım ---- Bakiye : 1.250,00 (B)\"}]}"
      }
    ],
    "isError": false
  }
}