Klavis Strata

resmi

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

Apa yang bisa Anda lakukan dengan Klavis Strata MCP?

  • Temukan tindakan yang relevan — Minta asisten Anda menemukan kategori atau tindakan di berbagai server yang disebutkan berdasarkan maksud dalam bahasa alami menggunakan discover_server_categories_or_actions.
  • Daftarkan tindakan kategori — Ambil semua nama tindakan dalam kategori tertentu dengan get_category_actions sebelum menelusuri detailnya.
  • Periksa skema tindakan — Dapatkan parameter wajib dan opsional untuk tindakan tertentu melalui get_action_details menggunakan nama kategori dan tindakan.
  • Jalankan tindakan — Jalankan tindakan dengan parameter path, query, dan body melalui execute_action, serta batasi kolom yang dikembalikan secara opsional dengan include_output_fields.
  • Cari dokumentasi server — Temukan endpoint berdasarkan kata kunci dalam dokumentasi server menggunakan search_documentation jika penemuan belum memberikan detail yang cukup.
  • Atasi kegagalan autentikasi — Dapatkan petunjuk autentikasi atau simpan kredensial setelah terjadi kesalahan autentikasi menggunakan handle_auth_failure.

Dokumentasi

Strata

Satu server MCP bagi agen AI untuk menggunakan alat secara bertahap pada skala apa pun

Strata Hero - Progressive tool discovery for AI agents

Apa itu Strata?

Strata adalah satu server MCP yang memandu agen AI menggunakan alat secara andal pada tingkat kompleksitas apa pun. Alih-alih membanjiri agen dengan semuanya sekaligus, Strata dirancang dengan mempertimbangkan cara manusia berinteraksi dengan alat, untuk mengatasi tiga masalah utama yang saat ini menghambat agen AI:

  • Terlalu Banyak Alat: Terlalu banyak alat menyebabkan LLM kesulitan menentukan pilihan
  • Konteks Berlebihan: Daftar alat yang panjang meningkatkan jumlah token dan biaya
  • Kesenjangan Cakupan: Sebagian besar server hanya menyediakan 40~50 alat, sehingga membatasi hal yang dapat Anda bangun

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

Tutorial Video

Tonton tutorial video ini untuk memahami sepenuhnya cara kerja Strata:

Strata

Tutorial Teks

[!TIP]

Lihat percakapan Claude yang dibagikan 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!

[accordion] Detail Alat

Deskripsi: TITIK AWAL YANG DIUTAMAKAN. Temukan kategori atau tindakan yang tersedia berdasarkan kueri pengguna. Coba alat ini terlebih dahulu saat menjelajahi tindakan yang tersedia di berbagai server. Ini adalah titik masuk utama untuk menjelajahi tindakan yang tersedia dan harus digunakan sebelum metode pencarian lainnya. Hasilnya berupa daftar server beserta tingkat detail dan rinciannya.

Jika tingkat detailnya adalah 'categories_only', rinciannya hanya berupa daftar nama kategori. Langkah berikutnya, sebaiknya gunakan alat get_category_actions untuk mendapatkan tindakan dalam kategori tersebut.

Jika tingkat detailnya adalah 'full_details', rinciannya berupa daftar nama kategori beserta detail tindakannya. Ini terjadi saat server hanya memiliki sedikit tindakan. Langkah berikutnya, sebaiknya gunakan alat execute_action untuk menjalankan tindakan.

Jika tingkat detailnya adalah 'categories_and_actions', rinciannya berupa daftar nama kategori dan nama tindakan. Ini terjadi saat menggunakan alat eksternal. Langkah berikutnya, sebaiknya gunakan alat get_action_details untuk mendapatkan detail tindakan.

Parameter:

  • user_query (string, wajib): Kueri pengguna dalam bahasa alami untuk memfilter 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.

[accordion] Detail Alat

Deskripsi: Dapatkan ikhtisar lengkap tindakan API yang tersedia dalam kategori tertentu. Gunakan alat ini jika Anda ingin menjelajahi tindakan yang tersedia dalam kategori layanan tertentu atau melihat kemampuan kategori secara terperinci. ** Penting **: Alat ini hanya boleh dipanggil setelah Anda mendapatkan kategori server dari alat discover_server_categories.

Parameter:

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

3. Dapatkan Detail Tindakan

get_action_details - dapatkan skema lengkap dan parameter untuk tindakan tertentu.

[accordion] Detail Alat

Deskripsi: Dapatkan informasi terperinci tentang tindakan tertentu, termasuk parameter wajib dan opsional. Nama kategori dan nama tindakan harus diberikan. ** Penting **: Alat ini hanya boleh dipanggil setelah Anda mendapatkan kategori server dari pemanggilan 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 hasilnya.

[accordion] Detail Alat

Deskripsi: Jalankan tindakan tertentu dengan parameter yang diberikan. Nama server, nama tindakan, dan parameter tindakan harus diberikan. ** Penting **: Alat ini hanya boleh dipanggil setelah Anda mendapatkan detail 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 isi permintaan untuk tindakan
  • include_output_fields (array, opsional): Opsional, tetapi sangat disarankan jika Anda mengetahui response_schema tindakan ini dari pemanggilan alat sebelumnya: Array jalur bidang yang akan disertakan dalam respons. Hanya bidang ini yang akan dikembalikan. Gunakan notasi titik untuk bidang bertingkat (misalnya, "author.displayName").
  • maximum_output_characters (integer, opsional): Opsional: Jumlah karakter maksimum yang dikembalikan dalam respons. Jika respons melebihi batas ini, respons akan dipotong. Sebaiknya gunakan include_output_fields daripada parameter ini.

5. Cari Dokumentasi

search_documentation - temukan informasi yang relevan hanya saat diperlukan.

[accordion] Detail Alat

Deskripsi: OPSI SEKUNDER: Gunakan alat ini hanya jika discover_server_categories tidak memberikan detail yang memadai atau jika Anda perlu mencari dalam dokumentasi server tertentu. Cari dokumentasi tindakan server berdasarkan kategori, operasi, tag, atau fungsi menggunakan pencocokan kata kunci. Ini bukan pencarian bahasa alami—alat ini mencocokkan kata kunci dan frasa secara persis. Hasilnya berupa endpoint yang diurutkan berdasarkan relevansi. Gunakan beberapa kata kunci yang terarah untuk menemukan hasil terbaik. Pola umum: nama kategori ('projects', 'users', 'pipelines'), tindakan ('create', 'delete', 'list', 'get'), atau kombinasinya ('create user', 'list projects'). Algoritme pencarian menggunakan penilaian cerdas agar bidang deskripsi yang panjang tidak mendominasi hasil.

Parameter:

  • query (string, wajib): Kata kunci pencarian yang cocok dengan istilah dalam dokumentasi API. Praktik terbaik: (1) Gunakan nama sumber daya seperti 'users', 'projects', 'files', (2) Tambahkan tindakan agar lebih spesifik, 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 dan deskripsi endpoint.
  • server_name (string, wajib): Nama server yang akan dicari.
  • max_results (integer, opsional, default: 10, minimum: 1, maximum: 50): Jumlah hasil yang akan dikembalikan. Default: 10

6. Tangani Kegagalan Autentikasi

handle_auth_failure - tangani autentikasi hanya saat diperlukan.

[accordion] Detail Alat

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

Parameter:

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

Evaluasi

Strata memberikan hasil nyata:

  • Tolok Ukur MCPMark: Mencapai tingkat pass@1 15.2% lebih tinggi dibandingkan server GitHub resmi dan tingkat pass@1 13.4% lebih tinggi dibandingkan server Notion resmi. (Sumber)
  • Evaluasi Manusia: Mencapai akurasi 83%+ pada kumpulan evaluasi yang terdiri dari >2k kueri dunia nyata

Langkah Berikutnya

[card] Mulai

Buat server Strata pertama Anda dalam hitungan menit

[card] Referensi API

Jelajahi API Strata secara lengkap

Dokumentasi ini dibuat dan dihosting di Mintlify, platform dokumentasi untuk pengembang.