DataGrout

Çoğu MCP istemcisi tek bir işi halleder: istek gönder, yanıt al. Conduit ise biraz farklı bir sorun için tasarlandı — kim olduğunu kanıtlaması gereken, uzun oturumlar boyunca elle yeniden kimlik doğrulamadan çalışmaya devam eden ve bunu yaparken maliyet veya politika bütçesi içinde kalan bir ajan. Bu SDK'nın doldurduğu boşluk tam olarak budur.

Yerleşik mTLS, OAuth 2.1 ve anlamsal araç keşfi içeren MCP istemci kütüphanesi. Python, TypeScript, Rust, Elixir ve Ruby için mevcuttur.

Tek bir import değişimiyle mevcut bir ajan, sertifika tabanlı kimlik, maliyet görünürlüğü ve doğal dil araç keşfi kazanır — başka hiçbir kod değişikliği gerekmez.

SDK'ya mı ihtiyacınız var, yoksa sadece ham uç noktaya mı?

Her DataGrout sunucusu standart bir MCP uç noktası sunar — MCP uyumlu herhangi bir istemci, yalnızca bir URL ve taşıyıcı token ile doğrudan bağlanabilir, SDK gerekmez. Conduit, minimum gereksinimin ötesini istediğiniz durumlar içindir:

• Token'ı kendiniz yönetmek yerine sertifika tabanlı (mTLS) kimlik istiyorsunuz

• Her çağrıda maliyet takibi istiyorsunuz, bunu ayrıca oluşturmadan

• Anlamsal keşif istiyorsunuz, böylece bir ajan tam araç adını bilmek yerine bir hedefi tanımlayarak doğru aracı bulabilsin

• Rust, Elixir veya Ruby ile entegrasyon yapıyorsunuz; burada MCP taşıma mantığını elle yazmak Python/TypeScript'ten daha fazla iştir

Bunların hiçbiri geçerli değilse — örneğin, yalnızca Claude Desktop'u bir DataGrout sunucusuna bağlıyorsanız — düz mcpServers JSON yapılandırması daha basit ve yeterlidir. Conduit, DataGrout üzerinde kendi ajanınızı veya uygulamanızı oluşturmak içindir, temel istemci yapılandırması için değil.

Dil desteği

Dil	Paket	Kurulum
Python	datagrout-conduit	pip install datagrout-conduit==0.7.0
TypeScript	@datagrout/conduit	npm install @datagrout/conduit@0.7.0
Rust	datagrout-conduit	cargo add datagrout-conduit@0.7.0
Elixir	datagrout_conduit	{:datagrout_conduit, "~> 0.7.0"}
Ruby	datagrout-conduit	gem install datagrout-conduit -v 0.7.0

Önce kaydolmadan sunucu edinme

Henüz DataGrout hesabınız veya uç noktanız yok mu? SDK ikisini de sizin için doğrudan sağlayabilir (Python gösterilmiştir; aynı çağrı her dilin SDK'sında mevcuttur — tam sözdizimi için aşağıdaki dile özel belgelere bakın):

from datagrout.conduit import ClientBuilder
from datagrout.conduit.onramp import OnrampOptions

client = await ClientBuilder().bootstrap_onramp(OnrampOptions(
    gateway="https://app.datagrout.ai",
    agent_name="my-agent",
    agent_type="claude-sonnet-4-6",
    intended_use="Summarise documents and extract entities.",
))
await client.connect()

Bu tek çağrının arkasında: SDK ajanınızı kaydeder, kısa ömürlü bir token'ı OAuth kimlik bilgileri ve sunucu URL'si ile değiştirir, yerel bir anahtar çifti oluşturur ve DataGrout'un CA'sı tarafından imzalatır. Özel anahtar makinenizde kalır. İlk çalıştırmadan sonraki her çalıştırma, kaydedilmiş kimliği otomatik olarak yeniden kullanır.

Kod yazmak yerine terminali mi tercih edersiniz: invariant onboard.

Kimlik doğrulama

Beş SDK'da da aynı olan üç yöntem:

• Taşıyıcı token — en basit seçenek, hızlı testler için uygundur.

• OAuth 2.1 (istemci kimlik bilgileri) — SDK JWT'leri otomatik olarak getirir, önbelleğe alır ve yeniler.

• mTLS — tek seferlik başlatmanın ardından, sertifikanın kendisi her isteğin kimliğini doğrular; sonrasında yönetilecek token yoktur.

mTLS için kimlik sabit bir arama sırasıyla otomatik olarak keşfedilir: açık bir geçersiz kılma dizini, CONDUIT_MTLS_CERT/CONDUIT_MTLS_KEY ortam değişkenleri, CONDUIT_IDENTITY_DIR, varsayılan ~/.conduit/ ve ardından çalışma dizinine göre yerel bir .conduit/. Tek makinede birden fazla ajan çalıştırmak, her birine kendi kimlik dizinini vermek anlamına gelir.

Neden özel bir CA: makine kimliği, tarayıcı kimliğinden farklı gereksinimlere sahiptir — ajanların, her seferinde bir insanın sürece dahil olması olmadan, programatik olarak verilen ve döndürülen sertifikalara ihtiyacı vardır. İmzalama anahtarı, HSM destekli bir AWS KMS anahtarında (FIPS 140-2 Seviye 2) yaşar ve asla oradan çıkmaz. CA sertifikası, bağımsız zincir doğrulaması için ca.datagrout.ai/ca.pem adresinde herkese açıktır.

Taşıma seçenekleri

Taşıma	Protokol	Ne zaman kullanılır
mcp (varsayılan)	Streamable HTTP/SSE üzerinden MCP	Tam protokol desteği, akış, bildirimler istiyorsunuz
jsonrpc	HTTP POST üzerinden JSON-RPC 2.0	Daha basit ve durumsuz bir şey istiyorsunuz
websocket	WebSocket üzerinden JSON-RPC 2.0	Sunucunun yalnızca yanıt vermesini değil, olayları itmesini istiyorsunuz

Kimlik doğrulama üçünde de aynı şekilde çalışır — taşımayı değiştirmek, kimlik doğrulama yönteminizi değiştirmek anlamına gelmez.

Temel özellikler

• Akıllı Arayüz (varsayılan olarak açık) — tüm araç yüzeyini iki çağrıya indirger: keşfet ve gerçekleştir. Ajan, yüzlerce araç şeması üzerinde akıl yürütmek yerine hedefi düz dilde tanımlar. Ham araçları görmek için use_intelligent_interface=False ile devre dışı bırakın.

• Anlamsal keşif — tam ad yerine anlamla araç aramak için ayrıca da kullanılabilir.

• Maliyet görünürlüğü — her çağrı, kredi kullanımıyla birlikte bir makbuz döndürür.

• Rehberli iş akışları — client.guide(goal=...) çok adımlı bir hedefte etkileşimli olarak ilerler.

• Bilişsel Güven Sertifikaları — bir iş akışının döngüsüz, tip güvenli, politikaya uygun ve bütçe dahilinde olduğunun kriptografik kanıtı; ajan kimlikleriyle aynı CA tarafından imzalanır.

Birinci taraf ad alanları

Ad alanı	Ne için kullanılır
prism	Veri dönüşümü, grafikleme, işleme, dışa aktarma
logic	Prolog mantık katmanı aracılığıyla kalıcı ajan belleği
warden	Güvenlik kontrolleri, niyet doğrulama, çok modelli fikir birliği
deliverables	Tamamlanmış iş ürünlerini kaydetme ve alma
ephemerals	Önbelleğe alınmış sonuçları inceleme ve yönetme
flow	İş akışı orkestrasyonu — yönlendirme, insan onayı, yürütme geçmişi

Akışlar, adlandırılmış, yeniden kullanılabilir beceriler olarak kaydedilebilir (save_as_skill=True) veya $compute aracılığıyla tek seferlik adımlar olarak satır içine gömülebilir. flow.route koşullu dallanmayı yönetir; flow.request_approval/flow.request_feedback insan kontrol noktaları ekler. Bir ad alanı tarafından kapsanmayan her şeye genel bir dg() çağrısıyla erişilebilir.

Bu, DataGrout'un entegrasyonlarına nerede bağlanır

Conduit, ajanınız ile herhangi bir DataGrout sunucusu arasındaki katmandır — Salesforce, QuickBooks ve Oracle Fusion Cloud entegrasyonları dahil. Bir call_tool("salesforce@1/get_lead@1", ...) çağrısı, sunucuda hangi entegrasyonlar yapılandırılmış olursa olsun aynı şekilde çalışır; SDK'nın belirli bir entegrasyonu önceden bilmesi gerekmez.

Sıradaki adımlar

• Dile özel belgeler: Python, TypeScript, Rust, Elixir, Ruby README'leri (GitHub)

• Güvenlik ayrıntıları: app.datagrout.ai/security

• Ücretsiz, hesap gerektirmeyen araçlar: MCP Inspector ve JSON-RPC Inspector, tarayıcı tabanlı

• Laboratuvarlar: güven sertifikaları, anlamsal kod analizi, politika uygulama, kredi modeli ve daha fazlası hakkında araştırma yazıları

Lisans

MIT