Bize yazınAgent Tale’i dene
İçeriğe geç

DokümantasyonAccount

Toolsets (MCP Bridge)

Toolset, bir dış API'yi veya MCP sunucusunu agent'ların çağırabileceği araç (tool) kümesine çeviren kayıttır (Settings → Developer → MCP Bridge). Her toolset /mcp/:slug altında JSON-RPC 2.0 (MCP) arayüzü olarak yayınlanır. Bu araçları agent sohbeti, Asistan (Zephyr), Legend düğümleri ve TUI çağırır.

flowchart LR
    A[OpenAPI spec] --> I[Import]
    B[MCP sunucusu] --> I
    C[Lore] --> I
    I --> T["/mcp/:slug (JSON-RPC 2.0)"]
    T --> D[Agent sohbeti · Zephyr · Legend · TUI]

Erişim

Toolset içe aktarma giriş yapmış her cüzdana açıktır; cüzdan başına saatte 10 içe aktarma sınırı vardır. Yeni toolset private başlar: yalnız sahibi görür, sahibi yayınladığında (publish) herkes görür. LLM ile araç çıkarımı ve bir toolset'i Platform default yapmak yalnızca admin işidir.

Toolset türleri

Tür Kaynak Araçlar nereden gelir
OpenAPI OpenAPI/Swagger spec URL'si (veya well-known yollardan bulunan spec) Spec'teki işlemler REST çağrısına çevrilir
MCP server — Remote URL (native_mcp) Uzak bir MCP sunucusunun adresi (ör. Miro) Sunucunun kendi tools/list yanıtı olduğu gibi kullanılır
MCP server — Local command (stdio_mcp) .mcp.json tarzı komut + argüman + ortam değişkenleri Sunucu platformda yalıtılmış bir container'da çalıştırılır
Lore Bir Lore bilgi tabanı search_lore ve list_documents araçları

Local command her kurulumda yok

stdio_mcp yalnızca operatör stdio runner bileşenini kurmuşsa (STDIO_RUNNER_URL) çalışır; bugün yalnız geliştirme profilinde açıktır. İzinli komutlar: npx, uvx, node, python3, python, deno.

İçe aktarma

  1. Settings → Developer → MCP Bridge; içe aktarma çubuğunda türü seçin (OpenAPI spec · MCP server · Lore).
  2. OpenAPI spec: spec URL'sini verin. Önizleme yoktur, içe aktarma hemen kaydedilir. Header veya cookie parametresi gerektiren işlemler atlanır ve listelenir.
  3. MCP server: uzak adres ya da yerel komut girin (veya bir .mcp.json yapıştırın). Kimlik doğrulama: yok, Bearer/API key ya da etkileşimsiz OAuth refresh token. Kaydetmeden önce bir dry-run önizleme sunucunun araç listesini gösterir; hiçbir şey yazılmaz.
  4. Lore: listeden bir bilgi tabanı seçin.
  5. Kimlik bilgileri AES-GCM ile şifreli saklanır ve API yanıtlarında hiç dönmez.

Toolset detayı

Bir karta tıklamak /settings/toolsets/:slug detayını açar:

Öğe Açıklama
Durum active / degraded / broken (periyodik sağlık kontrolü)
Callable tools Araç listesi; LLM ile çıkarsanmış araçlar onaylanana kadar pending görünür
Tool access Araçları tek tek kapatıp açarak izin listesi (allow-list) oluşturun; hiçbiri seçili değilse tüm araçlar çağrılabilir
Re-sync Yalnız uzak MCP toolset'lerinde: yeni araçları ekler, kaybolanları silmeden pasifleştirir. OpenAPI toolset'i spec'i yeniden içe aktararak güncellenir
Quota Günlük ve aylık kredi tavanı (0 = sınırsız, UTC gün/ay) ve çağrı başı ücret
Credentials Bearer, API key veya Basic kimlik bilgisini güncelleme
Platform default Yalnız admin: toolset'i her agent için izinsiz kullanılabilir yapar ve yayınlar

Çağrı geçmişi (GET /api/v1/toolsets/:slug/calls) ve metrikler (/metrics) arka uçta vardır; web detay ekranı bunları bugün göstermez.

Agent araç izinleri

Bir agent adına yapılan çağrılarda ek bir izin katmanı vardır (AgentToolSetGrant):

  • Agent yalnızca kendisine izin verilen toolset'leri kullanabilir. Agent sahibi izinleri agent detay sayfasındaki Tools bölümünden (Add tool · Manage tools) veya Card Editor'dan yönetir; izin toolset'in tamamını veya seçili araçlarını kapsayabilir.
  • İzin yalnızca daraltır: cüzdanın göremediği (başkasının private) bir toolset'e izin verilemez.
  • Platform default toolset'ler izin kaydı olmadan da kullanılabilir; sahip, devre dışı bir izin kaydıyla agent'ını bunlardan çıkarabilir.
  • Bir agent adına yapılmayan çağrılar yalnız görünürlük kuralına tabidir: yayınlanmış toolset'ler ve cüzdanın kendi toolset'leri.

/mcp/:slug ve faturalama

  • initialize ve tools/list yayınlanmış toolset'lerde herkese açıktır; tools/call kimlik ister (oturum veya API anahtarı). Dakikada 120 çağrı sınırı vardır.
  • Uzak MCP toolset'lerinde köprü, sunucuya streamable HTTP veya eski HTTP+SSE ile bağlanır (otomatik algılanır).
  • Sahip olmayan her çağrı toolset'in çağrı başı ücretini (varsayılan 1 ⚡) harcar; sahibin kendi çağrıları ücretsizdir ve kotayı tüketmez. Kota ücretten önce kontrol edilir; kota dolmuşsa çağrı upstream'e gitmez ve ücret alınmaz.

Güvenlik

Önlem Açıklama
Credential şifreleme API anahtarları AES-GCM ile şifrelenir, düz metin tutulmaz
SSRF guard Köprü özel/iç ağ adreslerine istek atmaz; operatör ALLOWED_TOOL_CIDRS ile belirli aralıklara izin verebilir
Spend gate Ücretli çağrılar on-chain kredi kontrolünden veya yerel kredi defterinden geçer
Sınırlar Upstream yanıtı 256 KiB, çağrı zaman aşımı 30 sn

LLM çıkarımı + onay

Spec'i olmayan bir servis için admin, uç nokta örneklerinden LLM ile araç tanımı çıkarabilir (POST /api/v1/toolsets/infer). Çıkarılan araçlar pending kaydedilir ve tek tek onaylanmadan çağrılamaz.

Sonraki Adım

API'niz kendi ağınızda ve dışarı açılmıyorsa Toolset yerine Embassy (MCP Base) kurun. Cüzdan başına dış servis kaydı için Connectors.