# 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.

- **Modül:** Yapay Zeka Ajanları
- **Yöntem:** POST
- **Endpoint:** `https://ws.evobulut.com/api/mcp`
- **Kimlik doğrulama:** `Authorization: Bearer` başlığında ajan anahtarı (Login ve UID gerekmez)
- **Son güncelleme:** 2026-10-09
- **Doküman:** https://dev.evobulut.com/servis/yapay-zeka-ajanlari/mcp-arac-listesi-331

## 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ür | Ne yapar |
| --- | --- | --- |
| cari_ara | Okuma | Cari arar (ad, ünvan, kod; vergi no, TC, telefon tam eşleşme). Dönen id = cari_id. |
| cari_detay | Okuma | Cari kartı: vergi bilgileri, telefonlar, adresler, e-postalar, notlar, banka hesapları. |
| cari_ekstre | Okuma | Tarih aralığında cari hesap hareketleri ve yürüyen bakiye (TL ya da tek döviz). |
| borc_alacak_ozeti | Okuma | Firmanın tüm carilerinin toplam borç, alacak ve net bakiyesi. |
| stok_ara | Okuma | Ürün/hizmet arar (kod, ad, barkod); kalan miktar, birim, satış fiyatı. |
| stok_detay | Okuma | Ürün kartı: fiyatlar, KDV, birimler ve çarpanları, barkodlar. |
| stok_depo_miktar | Okuma | Ürünlerin depo bazında eldeki miktarı. |
| stok_hareketleri | Okuma | Ürünün onaylı giriş/çıkış hareketleri: kime, ne zaman, kaç adet, hangi fiyattan. |
| siparis_listele | Okuma | Alınan (50) / verilen (51) siparişler; onay, cari, tarih, açık sipariş süzgeçleri. |
| siparis_detay | Okuma | Siparişin başlığı, toplamları ve satırları (teslim edilen / kalan miktar). |
| siparis_durumlari | Okuma | Sipariş durum tanımları. |
| teklif_listele | Okuma | Verilen (61) / alınan (60) teklifler. |
| fatura_listele | Okuma | Faturalar (31 satış, 30 alış, iadeler, fişler); kalan tutar dahil. |
| fatura_detay | Okuma | Faturanın başlığı, toplamları ve satırları (id ya da belge no ile). |
| aktivite_listele | Okuma | Görüşme / not / ziyaret kayıtları; firmadaki aktivite türleri buradan öğrenilir. |
| doviz_listesi | Okuma | Tanımlı dövizler (doviz_id; 0 = TL). |
| doviz_kuru | Okuma | Verilen tarihten önceki son yayımlanmış kurlar. |
| depo_listesi | Okuma | Kullanıcıya atanmış depolar. |
| sube_listesi | Okuma | Firmanın şubeleri. |
| kullanici_listesi | Okuma | Aktif kullanıcılar (id, ad, departman) — görev atamak için. |
| cari_ekle | Yazma | Firma ya da kişi cari kartı (telefon, e-posta, adres ile). Aynı vergi/TC no varsa yeni kart açmaz. |
| siparis_olustur | Yazma | Sipariş taslağı (onaysız). Satırlar: stok_id, miktar, KDV hariç birim fiyat. |
| teklif_olustur | Yazma | Teklif taslağı (onaysız); varsayılan tür 61 (satış teklifi). |
| aktivite_ekle | Yazma | Cariye görüşme notu / aktivite. E-posta gönderen ve konum isteyen türler bu araçla girilemez. |
| gorev_ekle | Yazma | Kullanı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

| Authorization | Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| --- | --- |
| Accept | application/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
    }
  }
}
```

## Örnek istek (cURL)

```bash
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

```json
{
  "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
  }
}
```