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).
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, saatlerSS:ddbiçimindedir; yanlış biçim açıklayıcı bir hata mesajıyla reddedilir. - Listeler sayfa başına 30 kayıt döner;
sayfa0'dan başlar,toplamtüm eşleşme sayısıdır. - Tutarlar aksi belirtilmedikçe yerel para birimindedir.
- Yazma araçları
tekrar_anahtarialı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
}
}
} 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
}
}
}'const response = await fetch("https://ws.evobulut.com/api/mcp", {
method: "POST",
headers: { "Content-Type": "application/json", "Authorization": "Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Accept": "application/json, text/event-stream" },
body: JSON.stringify({
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
})
});
const veri = await response.json();
console.log(veri);using System.Text;
using System.Text.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx");
client.DefaultRequestHeaders.TryAddWithoutValidation("Accept", "application/json, text/event-stream");
var json = """
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
}
""";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://ws.evobulut.com/api/mcp", content);
var veri = await response.Content.ReadAsStringAsync();
Console.WriteLine(veri);import requests
url = "https://ws.evobulut.com/api/mcp"
headers = {"Authorization": "Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Accept": "application/json, text/event-stream"}
payload = {
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$url = "https://ws.evobulut.com/api/mcp";
$payload = '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
}';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Accept: application/json, text/event-stream"]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
String json = """
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://ws.evobulut.com/api/mcp"))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
.header("Accept", "application/json, text/event-stream")
.method("POST", HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
Uri.parse('https://ws.evobulut.com/api/mcp'),
headers: {'Content-Type': 'application/json', 'Authorization': 'Bearer evo_ak_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Accept': 'application/json, text/event-stream'},
body: jsonEncode({
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "cari_ara",
"arguments": {
"ara": "evosoft",
"sayfa": 0
}
}
}),
);
print(response.body); 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
}
} Yapay Zeka Ajanları modülündeki diğer servisler