Klavis Strata

resmi

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

Klavis Strata MCP ile neler yapabilirsiniz?

  • İlgili eylemleri keşfedin — Asistanınızdan, doğal dilde ifade edilen bir amaca göre adı belirtilen sunuculardaki kategorileri veya eylemleri discover_server_categories_or_actions kullanarak bulmasını isteyin.
  • Kategori eylemlerini listeleyin — Ayrıntılara geçmeden önce get_category_actions ile belirli kategorilerdeki tüm eylem adlarını alın.
  • Eylem şemalarını inceleyin — Bir kategori ve eylem adı kullanarak get_action_details aracılığıyla belirli bir eylemin zorunlu ve isteğe bağlı parametrelerini alın.
  • Eylemleri yürütün — execute_action aracılığıyla yol, sorgu ve gövde parametreleriyle bir eylem çalıştırın; isteğe bağlı olarak include_output_fields ile döndürülen alanları sınırlayın.
  • Sunucu belgelerinde arama yapın — Keşif yeterli ayrıntı sağlamadığında, search_documentation kullanarak sunucu belgelerinde anahtar kelimeye göre uç noktaları bulun.
  • Kimlik doğrulama hatalarını giderin — Kimlik doğrulama hatasından sonra handle_auth_failure kullanarak kimlik doğrulama talimatlarını alın veya kimlik bilgilerini kaydedin.

Dokümantasyon

Strata

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

Strata Hero - Progressive tool discovery for AI agents

Strata nedir?

Strata, AI ajanlarının araçları her türlü karmaşıklık düzeyinde güvenilir biçimde kullanmasına rehberlik eden tek bir MCP sunucusudur. Her şeyi bir anda sunarak ajanları bunaltmak yerine, insanların araçlarla etkileşim kurma biçimi düşünülerek tasarlanmıştır ve günümüzde AI ajanlarını etkileyen üç temel sorunu çözer:

  • Araç Yükü: Çok fazla araç, LLM'lerin seçim yaparken kararsız kalmasına neden olur
  • Bağlam Yükü: Uzun araç listeleri token sayısını ve maliyetleri artırır
  • Kapsam Açığı: Çoğu sunucu 40~50 araçla sınırlı kalır ve neler geliştirebileceğinizi kısıtlar

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

Video Eğitimi

Strata'nın nasıl çalıştığını tüm ayrıntılarıyla öğrenmek için bu video eğitimini izleyin:

Strata

Metin Eğitimi

[!TIP]

Strata'yı çalışırken görmek için bu paylaşılan Claude konuşmasına göz atın!

1. Sunucu Kategorilerini veya Eylemleri Keşfedin

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

[accordion] Araç Ayrıntıları

Açıklama: BAŞLAMAK İÇİN ÖNERİLEN NOKTA. Kullanıcı sorgusuna göre kullanılabilir kategorileri veya eylemleri keşfedin. Sunucularda hangi eylemlerin kullanılabildiğini araştırırken önce bu aracı deneyin. Bu, kullanılabilir eylemleri keşfetmenin birincil başlangıç 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 listesini içerir.

Ayrıntı düzeyi 'categories_only' ise ayrıntılar yalnızca kategori adlarının listesinden oluşur. Sonraki adımda kategorilerin eylemlerini almak için get_category_actions aracını kullanmanız önerilir.

Ayrıntı düzeyi 'full_details' ise ayrıntılar, eylem ayrıntılarıyla birlikte kategori adlarının listesinden oluşur. Bu, sunucuda yalnızca birkaç eylem olduğunda gerçekleşir. Sonraki adımda eylemleri yürütmek için execute_action aracını kullanmanız önerilir.

Ayrıntı düzeyi 'categories_and_actions' ise ayrıntılar, kategori adları ve eylem adlarının listesinden oluşur. 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 önerilir.

Parametreler:

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

2. Kategori Eylemlerini Alın

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

[accordion] Araç Ayrıntıları

Açıklama: Belirli kategorilerde kullanılabilen API eylemlerine kapsamlı bir genel bakış alın. Belirli hizmet kategorilerinde hangi eylemlerin kullanılabildiğini araştırmak veya kategori özelliklerini ayrıntılı olarak görmek istiyorsanız bu aracı kullanın. ** Önemli **: Bu araç yalnızca discover_server_categories aracından sunucu kategorilerini aldıktan sonra çağrılmalıdır.

Parametreler:

  • category_names (array, required): Eylemleri alınacak kategorilerin listesi

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

get_action_details - belirli bir eylemin tam şemasını ve parametrelerini alın.

[accordion] Araç Ayrıntıları

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

Parametreler:

  • category_name (string, required): Kategorinin adı
  • action_name (string, required): 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.

[accordion] Araç Ayrıntıları

Açıklama: Belirtilen parametrelerle belirli bir eylemi yürütün. Sunucu adı, eylem adı ve eylem parametreleri belirtilmelidir. ** Önemli **: Bu araç yalnızca get_action_details aracından eylem ayrıntılarını aldıktan sonra çağrılmalıdır.

Parametreler:

  • server_name (string, required): Sunucunun adı
  • category_name (string, required): Eylemin yürütüleceği kategorinin adı
  • action_name (string, required): Yürütülecek eylemin/işlemin adı
  • path_params (string, optional): Eylemin yol parametrelerini içeren JSON dizesi
  • query_params (string, optional): Eylemin sorgu parametrelerini içeren JSON dizesi
  • body_schema (string, optional, default: "{}"): Eylemlerin istek gövdesini içeren JSON dizesi
  • include_output_fields (array, optional): İsteğe bağlıdır ancak önceki araç çağrılarından bu eylemin response_schema değerini biliyorsanız kullanmanız önemle ö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österimini kullanın (ör. "author.displayName").
  • maximum_output_characters (integer, optional): İsteğe bağlı: Yanıtta döndürülecek en fazla karakter sayısı. Yanıt bu sınırı aşarsa kısaltılır. Bunun yerine include_output_fields kullanmanız önerilir.

5. Belgelerde Arama Yapın

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

[accordion] Araç Ayrıntıları

Açıklama: İKİNCİL SEÇENEK: Bu aracı yalnızca discover_server_categories yeterli ayrıntı sağlamadığında veya belirli bir sunucunun belgelerinde arama yapmanız gerektiğinde kullanın. Anahtar kelime eşleştirmesiyle kategori, işlem, etiket veya işlevselliğe göre sunucu eylemlerinin belgelerinde arama yapın. Bu, doğal dilde arama değildir; tam anahtar kelimeleri ve ifadeleri eşleştirir. Uç noktaları alaka düzeyine göre sıralayarak döndürür. En iyi eşleşmeleri bulmak için hedefli birkaç anahtar kelime kullanın. Yaygın örüntüler: kategori adları ('projects', 'users', 'pipelines'), eylemler ('create', 'delete', 'list', 'get') veya bunların birleşimleri ('create user', 'list projects'). Arama algoritması, uzun açıklama alanlarının sonuçları gereğinden fazla etkilemesini önlemek için akıllı puanlama kullanır.

Parametreler:

  • query (string, required): API belgelerindeki terimlerle eşleşen arama anahtar kelimeleri. En iyi uygulamalar: (1) 'users', 'projects', 'files' gibi kaynak adlarını kullanın, (2) 'user create' veya 'project delete' gibi eylemler ekleyerek aramayı hassaslaştırın, (3) 'how to', 'show me', 'all the' gibi dolgu sözcüklerinden kaçının; uç nokta adlarında ve açıklamalarında geçen temel terimlere odaklanın.
  • server_name (string, required): Arama yapılacak sunucunun adı.
  • max_results (integer, optional, default: 10, minimum: 1, maximum: 50): Döndürülecek sonuç sayısı. Varsayılan: 10

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

handle_auth_failure - kimlik doğrulama işlemlerini yalnızca gerektiğinde ele alın.

[accordion] Araç Ayrıntıları

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 Unauthorized, geçersiz kimlik bilgileri, süresi dolmuş belirteçler vb.) çağrılmalıdır. Kimlik doğrulama durumunu kontrol etmek veya başka herhangi bir amaçla 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) Kullanıcı bir hatanın ardından kimlik doğrulama verilerini sağladığında, kimlik bilgilerini kaydetmek için bu aracı 'save_auth_data' ile çağırın. Hata kimlik doğrulama hatası DEĞİLSE (ör. 404 Not Found, 500 Internal Server Error vb.) bu aracı ASLA çağırmayın.

Parametreler:

  • server_name (string, required): execute_action sırasında kimlik doğrulaması başarısız olan sunucunun adı
  • intention (string, required, enum: ["get_auth_url", "save_auth_data"]): Kimlik doğrulama hatasıyla başarısız olan execute_action çağrısında kimlik doğrulama talimatlarını almak için 'get_auth_url' kullanın. Kimlik doğrulama hatasının ardından kullanıcı kimlik doğrulama bilgilerini sağladığında 'save_auth_data' kullanın.
  • auth_data (object, optional): Kimlik doğrulama hatasının ardından kullanıcı tarafından sağlanan kimlik doğrulama verileri (ör. {"token": "...", "api_key": "..."}). Yalnızca kimlik doğrulama hatalarını giderirken 'save_auth_data' amacıyla kullanılır.

Değerlendirme

Strata gerçek sonuçlar sunar:

  • MCPMark Benchmark: Resmî GitHub sunucusuna kıyasla pass@1 oranında %15.2 daha yüksek, resmî Notion sunucusuna kıyasla ise pass@1 oranında %13.4 daha yüksek sonuç elde eder. (Kaynak)
  • İnsan Değerlendirmesi: 2 binden fazla gerçek dünya sorgusundan oluşan değerlendirme kümelerinde %83'ün üzerinde doğruluk sağlar

Sonraki Adımlar

[card] Başlayın

İlk Strata sunucunuzu dakikalar içinde oluşturun

[card] API Referansı

Strata API'sinin tamamını keşfedin

Bu belgeler, geliştirici dokümantasyon platformu Mintlify üzerinde oluşturulup barındırılmaktadır.