Klavis Strata MCP Server

resmi

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

Dokümantasyon

Strata

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

Strata Nedir?

Strata, yapay zeka aracılarını her şeyi bir anda sunarak bunaltmak yerine, her karmaşıklık düzeyinde araçları güvenilir bir şekilde kullanmaları için yönlendiren tek bir MCP sunucusudur. İnsanın araçlarla etkileşimi düşünülerek tasarlanmıştır ve günümüzde yapay zeka aracılarını etkileyen üç büyük sorunu çözer:

Araç Aşırı Yükü: Çok fazla araç, LLM'de seçim felcine yol açar
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, bu da inşa edebileceklerinizi 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ı iş başında 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. Sunucular arasında 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ı kullanmanız tercih edilir.

Ayrıntı düzeyi 'full_details' ise, ayrıntılar eylem ayrıntılarıyla birlikte 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ı kullanmanız 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ı kullanmanız 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 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 eylem/işlem 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 eylem/işlem 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ülür. İç 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. Uç noktaları alaka düzeyine göre sıralanmış olarak 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ı nedeniyle başarısız olduğunda (401 Yetkisiz, geçersiz kimlik bilgileri, süresi dolmuş token'lar vb.) ç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 verileri 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ından sonra 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ından sonra 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 sorgu 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