Klavis Strata

resmi

Herhangi bir ölçekte güvenilir bir şekilde herhangi bir aracı kullanmak üzere AI ajanları için bir MCP sunucusu.

klavis.ai üzerinde görüntüle

Klavis Strata MCP ile neler yapabilirsiniz?

Sunucular arasında kullanılabilir eylemleri keşfedin — Yapmak istediğiniz şeyi açıklayarak yapay zekanıza ilgili araçları bulmasını söyleyin, tercih edilen başlangıç noktası olarak discover_server_categories_or_actions kullanın.
Bir kategori içindeki eylemleri keşfedin — Kullanılabilir kategorileri keşfettikten sonra get_category_actions ile belirli bir hizmet kategorisindeki tüm eylem adlarını alın.
Bir eylem için parametre şemalarını alın — Bir eylemi çalıştırmadan önce get_action_details kullanarak belirli bir eylem için tam girdi ayrıntılarını getirin.
Bir API eylemini çalıştırın — execute_action aracılığıyla gerekli parametrelerle keşfedilen bir eylemi çalıştırın, yanıt boyutunu azaltmak için isteğe bağlı olarak çıktı alanlarını filtreleyin.
Sunucu belgelerini anahtar kelimeyle arayın — Kategori keşfi daha fazla hassasiyet gerektirdiğinde "kullanıcı oluştur" veya "projeleri listele" gibi hedefli terimlerle search_documentation kullanın.
Kimlik doğrulama hatalarını çözün — Bir eylem 401 hatasıyla başarısız olduğunda kimlik doğrulama talimatları almak veya kimlik bilgilerini kaydetmek için handle_auth_failure çağrısı yapın.

Dokümantasyon

Strata

Yapay zeka ajanlarının her ölçekte araçları aşamalı olarak kullanması için tek bir MCP sunucusu

Strata Nedir?

Strata, yapay zeka ajanlarının araçları her karmaşıklık seviyesinde güvenilir bir şekilde kullanmasına rehberlik eden, her şeyi bir anda sunarak onları bunaltmak yerine, insanın araçlarla etkileşimi düşünülerek tasarlanmış tek bir MCP sunucusudur ve günümüzde yapay zeka ajanlarını etkileyen üç büyük sorunu çözer:

Araç Aşırı Yükü: Çok fazla araç, LLM'de seçim felcine neden olur
Bağlam Aşırı Yükü: Uzun araç listeleri token sayısını ve maliyetleri artırır
Kapsam Açığı: Çoğu sunucu 40~50 araçta takılı kalır ve bu da geliştirebileceklerinizi sınırlar

Strata'yı web sitemiz, API veya hatta kendi verileriniz üzerinde açık kaynak olarak kullanabilirsiniz!

Video Eğitimi

Strata'nın nasıl çalıştığını tam olarak anlamak için bu video eğitimini izleyin:

Metin Eğitimi Strata'yı çalışırken görmek için bu [paylaşılan Claude konuşmasına](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070) göz atın!

1. Sunucu Kategorilerini veya Eylemlerini Keşfedin

discover_server_categories_or_actions - kullanıcı amacına göre ilgili kategorileri veya eylemleri bulun. Anlamsal arama yok!

**Açıklama**: **TERCİH EDİLEN BAŞLANGIÇ NOKTASI**. Kullanıcı sorgusuna göre mevcut kategorileri veya eylemleri keşfedin. Sunucularda hangi eylemlerin mevcut olduğunu keşfederken önce bu aracı deneyin. Bu, mevcut eylemleri keşfetmek için birincil giriş noktasıdır ve diğer arama yöntemlerinden önce kullanılmalıdır. Çıktı, ayrıntı düzeyi ve ayrıntılarla birlikte sunucuların bir listesi olacaktır.

Ayrıntı düzeyi 'categories_only' ise, ayrıntılar yalnızca kategori adlarının bir listesi olacaktır. Sonraki adımda kategorilerin eylemlerini almak için get_category_actions aracını kullanmak tercih edilir.

Ayrıntı düzeyi 'full_details' ise, ayrıntılar eylem ayrıntılarını içeren kategori adlarının bir listesi olacaktır. Bu, sunucunun yalnızca birkaç eylemi olduğunda gerçekleşir. Sonraki adımda eylemleri yürütmek için execute_action aracını kullanmak tercih edilir.

Ayrıntı düzeyi 'categories_and_actions' ise, ayrıntılar kategori adlarının ve eylem adlarının bir listesi olacaktır. Bu, harici araçlar kullanılırken gerçekleşir. Sonraki adımda eylemlerin ayrıntılarını almak için get_action_details aracını kullanmak tercih edilir.

Parametreler:

user_query (string, zorunlu): Sonuçları filtrelemek için doğal dil kullanıcı sorgusu.
server_names (array, zorunlu): Kategorileri veya eylemleri keşfetmek için sunucu adlarının listesi.

2. Kategori Eylemlerini Alın

get_category_actions - belirtilen kategorilerdeki tüm eylem adlarını alın.

**Açıklama**: Belirli kategorilerde mevcut olan API eylemlerine kapsamlı bir genel bakış edinin. Belirli hizmet kategorilerinde hangi eylemlerin mevcut olduğunu keşfetmek veya kategori yeteneklerinin ayrıntılı bir görünümünü elde etmek istiyorsanız bu aracı kullanın. \*\* Önemli \*\*: Yalnızca discover_server_categories aracından sunucu kategorilerini aldıktan sonra çağrılmalıdır.

Parametreler:

category_names (array, zorunlu): Eylemlerin alınacağı kategorilerin listesi

3. Eylem Ayrıntılarını Alın

get_action_details - belirli bir eylem için tam şema ve parametreleri alın.

**Açıklama**: Zorunlu ve isteğe bağlı parametreler dahil olmak üzere belirli bir eylem hakkında ayrıntılı bilgi alın. Kategori adı ve eylem adı sağlanmalıdır. \*\* Önemli \*\*: Yalnızca önceki araç çağrılarından sunucu kategorilerini aldıktan sonra çağrılmalıdır.

Parametreler:

category_name (string, zorunlu): Kategorinin adı
action_name (string, zorunlu): Kategori içindeki eylemin/işlemin adı

4. Eylemi Yürütün

execute_action - parametrelerle eylemleri çalıştırın ve sonuçları alın.

**Açıklama**: Sağlanan parametrelerle belirli bir eylemi yürütün. Sunucu adı, eylem adı ve eylem parametreleri sağlanmalıdır. \*\* Önemli \*\*: Yalnızca get_action_details aracından eylem ayrıntılarını aldıktan sonra çağrılmalıdır.

Parametreler:

server_name (string, zorunlu): Sunucunun adı
category_name (string, zorunlu): Eylemin yürütüleceği kategorinin adı
action_name (string, zorunlu): Yürütülecek eylemin/işlemin adı
path_params (string, isteğe bağlı): Eylem için yol parametrelerini içeren JSON dizesi
query_params (string, isteğe bağlı): Eylem için sorgu parametrelerini içeren JSON dizesi
body_schema (string, isteğe bağlı, varsayılan: "{}"): Eylemler için istek gövdesini içeren JSON dizesi
include_output_fields (array, isteğe bağlı): Bu eylemin response_schema'sını önceki araç çağrılarından biliyorsanız isteğe bağlı ancak şiddetle önerilir: Yanıta dahil edilecek alan yollarının dizisi. Yalnızca bu alanlar döndürülecektir. İç içe alanlar için nokta gösterimi kullanın (örn., "author.displayName").
maximum_output_characters (integer, isteğe bağlı): İsteğe bağlı: Yanıtta döndürülecek maksimum karakter sayısı. Yanıt bu sınırı aşarsa kısaltılacaktır. Bunun yerine include_output_fields tercih edin.

5. Dokümantasyon Ara

search_documentation - yalnızca gerektiğinde ilgili bilgileri bulun.

**Açıklama**: **İKİNCİL SEÇENEK**: Bu aracı yalnızca discover_server_categories yeterli ayrıntı sağlamadığında veya belirli bir sunucunun dokümantasyonunda arama yapmanız gerektiğinde kullanın. Anahtar kelime eşleştirme kullanarak kategori, işlem, etiketler veya işlevselliğe göre sunucu eylem dokümantasyonlarını arayın. Bu doğal dil araması değildir - tam anahtar kelimeleri ve ifadeleri eşleştirir. Alaka düzeyine göre sıralanmış uç noktaları döndürür. En iyi eşleşmeleri bulmak için birkaç hedefli anahtar kelime kullanın. Yaygın desenler: kategori adları ('projects', 'users', 'pipelines'), eylemler ('create', 'delete', 'list', 'get') veya kombinasyonlar ('create user', 'list projects'). Arama algoritması, ayrıntılı açıklama alanlarının sonuçları bastırmasını önlemek için akıllı puanlama kullanır.

Parametreler:

query (string, zorunlu): API dokümantasyon terimleriyle eşleşen arama anahtar kelimeleri. En iyi uygulamalar: (1) 'users', 'projects', 'files' gibi kaynak adlarını kullanın, (2) Hassasiyet için 'user create' veya 'project delete' gibi eylemler ekleyin, (3) 'how to', 'show me', 'all the' gibi dolgu kelimelerinden kaçının - uç nokta adlarında ve açıklamalarında görünen temel terimlere odaklanın.
server_name (string, zorunlu): İçinde arama yapılacak sunucunun adı.
max_results (integer, isteğe bağlı, varsayılan: 10, minimum: 1, maksimum: 50): Döndürülecek sonuç sayısı. Varsayılan: 10

6. Kimlik Doğrulama Hatasını Ele Alın

handle_auth_failure - yalnızca gerektiğinde kimlik doğrulamayı ele alın.

**Açıklama**: Eylemler yürütülürken oluşan kimlik doğrulama hatalarını ele alın. KRİTİK: Bu araç YALNIZCA execute_action özellikle kimlik doğrulama sorunları (401 Yetkisiz, geçersiz kimlik bilgileri, süresi dolmuş token'lar vb.) nedeniyle başarısız olduğunda çağrılmalıdır. Kimlik doğrulama durumunu kontrol etmek veya başka bir amaç için bu aracı ÇAĞIRMAYIN. Kullanım: (1) execute_action bir kimlik doğrulama hatası döndürdüğünde, kimlik doğrulama talimatlarını almak için bu aracı 'get_auth_url' ile çağırın. (2) Bir hata sonrasında kullanıcı kimlik doğrulama verilerini sağladığında, kimlik bilgilerini kaydetmek için bu aracı 'save_auth_data' ile çağırın. Hata bir kimlik doğrulama hatası DEĞİLSE (örn., 404 Bulunamadı, 500 Dahili Sunucu Hatası, vb.) bu aracı ASLA çağırmayın.

Parametreler:

server_name (string, zorunlu): execute_action sırasında kimlik doğrulaması başarısız olan sunucunun adı
intention (string, zorunlu, enum: ["get_auth_url", "save_auth_data"]): execute_action kimlik doğrulama hatalarıyla başarısız olduğunda kimlik doğrulama talimatlarını almak için 'get_auth_url' kullanın. Bir kimlik doğrulama hatası sonrasında kullanıcı kimlik doğrulama bilgilerini sağladığında 'save_auth_data' kullanın.
auth_data (object, isteğe bağlı): Bir kimlik doğrulama hatası sonrasında kullanıcı tarafından sağlanan kimlik doğrulama verileri (örn., {"token": "...", "api_key": "..."}). Yalnızca kimlik doğrulama hatalarını çözerken 'save_auth_data' amacıyla kullanılır.

Değerlendirme

Strata gerçek sonuçlar sunar:

MCPMark Karşılaştırması: Resmi GitHub sunucusuna kıyasla +%15,2 daha yüksek pass@1 oranı ve resmi Notion sunucusuna kıyasla +%13,4 daha yüksek pass@1 oranı elde eder. (Kaynak)
İnsan Değerlendirmesi: 2 binden fazla gerçek dünya sorgusu değerlendirme setinde %83+ doğruluk oranına ulaşır

Sonraki Adımlar

İlk Strata sunucunuzu dakikalar içinde oluşturun Strata API'sinin tamamını keşfedin