Klavis Strata MCP Server

resmi

Satu server MCP untuk agen AI agar dapat menggunakan alat apa pun secara andal dalam skala berapa pun

Dokumentasi

Strata

Satu server MCP untuk agen AI menggunakan alat secara progresif di skala apa pun

<img src="https://mintcdn.com/klavisai/7Siw7A5JJSHURM5d/images/concepts/strata_hero.png?fit=max&auto=format&n=7Siw7A5JJSHURM5d&q=85&s=b581fdb821699a32b260d124789396bd" alt="Strata Hero - Progressive tool discovery for AI agents" className="w-full rounded-lg" style={{ maxWidth: '100%', height: 'auto' }} width="2533" height="496" data-path="images/concepts/strata_hero.png" />

Apa itu Strata?

Strata adalah satu server MCP yang memandu agen AI menggunakan alat secara andal di tingkat kompleksitas apa pun, alih-alih membanjiri mereka dengan semuanya sekaligus, ia dirancang dengan memikirkan interaksi manusia dengan alat, memecahkan tiga masalah utama yang mengganggu agen AI saat ini:

  • Kelebihan Alat: Terlalu banyak alat menyebabkan kelumpuhan pilihan pada LLM
  • Kelebihan Konteks: Daftar alat yang panjang meledakkan jumlah token dan biaya
  • Kesenjangan Cakupan: Sebagian besar server terjebak di 40~50 alat, membatasi apa yang dapat Anda bangun

Anda dapat menggunakan Strata melalui situs web kami, API, atau bahkan sumber terbuka pada data Anda sendiri!

Tutorial Video

Tonton tutorial video ini untuk pemahaman lengkap tentang cara kerja Strata:

Tutorial Teks Lihat [percakapan Claude bersama](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070) ini untuk melihat Strata beraksi!

1. Temukan Kategori atau Tindakan Server

discover_server_categories_or_actions - temukan kategori atau tindakan yang relevan berdasarkan maksud pengguna. Tanpa pencarian semantik!

**Deskripsi**: **TITIK AWAL YANG DISARANKAN**. Temukan kategori atau tindakan yang tersedia berdasarkan kueri pengguna. Coba alat ini terlebih dahulu saat menjelajahi tindakan apa yang tersedia di seluruh server. Ini adalah titik masuk utama untuk menjelajahi tindakan yang tersedia dan harus digunakan sebelum metode pencarian lainnya. Outputnya akan berupa daftar server dengan tingkat detail dan rincian.

Jika tingkat detail adalah 'categories_only', rinciannya hanya berupa daftar nama kategori. Langkah selanjutnya disarankan menggunakan alat get_category_actions untuk mendapatkan tindakan untuk kategori tersebut.

Jika tingkat detail adalah 'full_details', rinciannya akan berupa daftar nama kategori dengan rincian tindakan mereka disertakan. Ini terjadi ketika server hanya memiliki sedikit tindakan. Langkah selanjutnya disarankan menggunakan alat execute_action untuk menjalankan tindakan.

Jika tingkat detail adalah 'categories_and_actions', rinciannya akan berupa daftar nama kategori dan nama tindakan. Ini terjadi saat menggunakan alat eksternal. Langkah selanjutnya disarankan menggunakan alat get_action_details untuk mendapatkan rincian tindakan.

Parameter:

  • user_query (string, wajib): Kueri pengguna bahasa alami untuk menyaring hasil.
  • server_names (array, wajib): Daftar nama server untuk menemukan kategori atau tindakan.

2. Dapatkan Tindakan Kategori

get_category_actions - ambil semua nama tindakan dalam kategori yang ditentukan.

**Deskripsi**: Dapatkan gambaran komprehensif tentang tindakan API yang tersedia dalam kategori tertentu. Gunakan alat ini jika Anda ingin menjelajahi tindakan apa yang tersedia dalam kategori layanan tertentu atau mendapatkan tampilan rinci tentang kemampuan kategori. \*\* Penting \*\*: Ini hanya boleh dipanggil setelah Anda mendapatkan kategori server dari alat discover_server_categories.

Parameter:

  • category_names (array, wajib): Daftar kategori untuk mendapatkan tindakan

3. Dapatkan Rincian Tindakan

get_action_details - dapatkan skema lengkap dan parameter untuk tindakan tertentu.

**Deskripsi**: Dapatkan informasi rinci tentang tindakan tertentu, termasuk parameter wajib dan opsional. Harus menyediakan nama kategori dan nama tindakan. \*\* Penting \*\*: Ini hanya boleh dipanggil setelah Anda mendapatkan kategori server dari panggilan alat sebelumnya.

Parameter:

  • category_name (string, wajib): Nama kategori
  • action_name (string, wajib): Nama tindakan/operasi dalam kategori

4. Jalankan Tindakan

execute_action - jalankan tindakan dengan parameter dan dapatkan hasil.

**Deskripsi**: Jalankan tindakan tertentu dengan parameter yang disediakan. Harus menyediakan nama server, nama tindakan, dan parameter tindakan. \*\* Penting \*\*: Ini hanya boleh dipanggil setelah Anda mendapatkan rincian tindakan dari alat get_action_details.

Parameter:

  • server_name (string, wajib): Nama server
  • category_name (string, wajib): Nama kategori untuk menjalankan tindakan
  • action_name (string, wajib): Nama tindakan/operasi yang akan dijalankan
  • path_params (string, opsional): String JSON yang berisi parameter jalur untuk tindakan
  • query_params (string, opsional): String JSON yang berisi parameter kueri untuk tindakan
  • body_schema (string, opsional, default: "{}"): String JSON yang berisi badan permintaan untuk tindakan
  • include_output_fields (array, opsional): Opsional tetapi sangat disarankan ketika Anda mengetahui response_schema dari tindakan ini dari panggilan alat sebelumnya: Array jalur bidang untuk disertakan dalam respons. Hanya bidang ini yang akan dikembalikan. Gunakan notasi titik untuk bidang bersarang (misalnya, "author.displayName").
  • maximum_output_characters (integer, opsional): Opsional: Jumlah maksimum karakter yang akan dikembalikan dalam respons. Jika respons melebihi batas ini, akan dipotong. Lebih disarankan include_output_fields daripada ini.

5. Cari Dokumentasi

search_documentation - temukan informasi yang relevan hanya saat diperlukan.

**Deskripsi**: **OPSI SEKUNDER**: Gunakan alat ini hanya ketika discover_server_categories tidak memberikan detail yang cukup atau ketika Anda perlu mencari dalam dokumentasi server tertentu. Cari dokumentasi tindakan server berdasarkan kategori, operasi, tag, atau fungsionalitas menggunakan pencocokan kata kunci. Ini bukan pencarian bahasa alami - ini mencocokkan kata kunci dan frasa yang tepat. Mengembalikan titik akhir yang diurutkan berdasarkan relevansi. Gunakan beberapa kata kunci yang ditargetkan untuk menemukan kecocokan terbaik. Pola umum: nama kategori ('projects', 'users', 'pipelines'), tindakan ('create', 'delete', 'list', 'get'), atau kombinasi ('create user', 'list projects'). Algoritma pencarian menggunakan penilaian cerdas untuk mencegah bidang deskripsi yang panjang membanjiri hasil.

Parameter:

  • query (string, wajib): Kata kunci pencarian yang cocok dengan istilah dokumentasi API. Praktik terbaik: (1) Gunakan nama sumber daya seperti 'users', 'projects', 'files', (2) Tambahkan tindakan untuk presisi seperti 'user create' atau 'project delete', (3) Hindari kata pengisi seperti 'how to', 'show me', 'all the' - fokus pada istilah inti yang muncul dalam nama titik akhir dan deskripsi.
  • server_name (string, wajib): Nama server untuk mencari di dalamnya.
  • max_results (integer, opsional, default: 10, minimum: 1, maksimum: 50): Jumlah hasil yang akan dikembalikan. Default: 10

6. Tangani Kegagalan Auth

handle_auth_failure - tangani autentikasi hanya saat diperlukan.

**Deskripsi**: Tangani kegagalan autentikasi yang terjadi saat menjalankan tindakan. KRITIS: Alat ini HANYA boleh dipanggil ketika execute_action gagal secara khusus karena masalah autentikasi (401 Unauthorized, kredensial tidak valid, token kedaluwarsa, dll.). JANGAN panggil alat ini untuk memeriksa status autentikasi atau untuk tujuan lain apa pun. Penggunaan: (1) Ketika execute_action mengembalikan kesalahan autentikasi, panggil alat ini dengan 'get_auth_url' untuk mendapatkan instruksi autentikasi. (2) Ketika pengguna memberikan data autentikasi setelah kegagalan, panggil alat ini dengan 'save_auth_data' untuk menyimpan kredensial. JANGAN PERNAH memanggil alat ini jika kegagalannya BUKAN kegagalan autentikasi (misalnya, 404 Not Found, 500 Internal Server Error, dll.).

Parameter:

  • server_name (string, wajib): Nama server yang gagal autentikasi selama execute_action
  • intention (string, wajib, enum: ["get_auth_url", "save_auth_data"]): Gunakan 'get_auth_url' ketika execute_action gagal dengan kesalahan autentikasi untuk mendapatkan instruksi autentikasi. Gunakan 'save_auth_data' ketika pengguna memberikan kredensial autentikasi setelah kegagalan autentikasi.
  • auth_data (object, opsional): Data autentikasi yang diberikan oleh pengguna setelah kegagalan autentikasi (misalnya, {"token": "...", "api_key": "..."}). Hanya digunakan dengan maksud 'save_auth_data' saat menyelesaikan kegagalan autentikasi.

Evaluasi

Strata memberikan hasil nyata:

  • Tolok Ukur MCPMark: Mencapai tingkat pass@1 +15,2% lebih tinggi vs server GitHub resmi dan tingkat pass@1 +13,4% lebih tinggi vs server Notion resmi. (Sumber)
  • Evaluasi Manusia: Mencapai akurasi 83%+ di seluruh set evaluasi >2k kueri dunia nyata

Langkah Selanjutnya

Buat server Strata pertama Anda dalam hitungan menit Jelajahi API Strata lengkap