DataGrout

Sebagian besar klien MCP menangani satu tugas: mengirim permintaan, mendapatkan respons. Conduit dibangun untuk masalah yang sedikit berbeda — agen yang perlu membuktikan identitasnya, terus bekerja dalam sesi panjang tanpa autentikasi ulang secara manual, dan tetap berada dalam anggaran biaya atau kebijakan saat melakukannya. Itulah celah yang diisi oleh SDK ini.

Pustaka klien MCP dengan mTLS bawaan, OAuth 2.1, dan penemuan alat semantik. Tersedia untuk Python, TypeScript, Rust, Elixir, dan Ruby.

Ganti satu impor dan agen yang sudah ada akan mendapatkan identitas berbasis sertifikat, visibilitas biaya, dan penemuan alat berbasis bahasa alami — tanpa perubahan kode lain yang diperlukan.

Apakah Anda memerlukan SDK, atau hanya endpoint mentah?

Setiap server DataGrout mengekspos endpoint MCP standar — klien apa pun yang kompatibel dengan MCP dapat terhubung langsung hanya dengan URL dan token bearer, tanpa memerlukan SDK. Conduit digunakan untuk kasus di mana Anda menginginkan lebih dari sekadar minimum:

• Anda menginginkan identitas berbasis sertifikat (mTLS) alih-alih mengelola token sendiri

• Anda menginginkan pelacakan biaya pada setiap panggilan tanpa membangunnya secara terpisah

• Anda menginginkan penemuan semantik sehingga agen dapat menemukan alat yang tepat dengan mendeskripsikan tujuan, daripada memerlukan nama alat yang tepat

• Anda mengintegrasikan dalam Rust, Elixir, atau Ruby, di mana membuat logika transport MCP secara manual lebih banyak pekerjaan daripada di Python/TypeScript

Jika tidak ada yang berlaku — misalnya, Anda hanya menghubungkan Claude Desktop ke server DataGrout — konfigurasi JSON mcpServers biasa lebih sederhana dan memadai. Conduit untuk membangun agen atau aplikasi Anda sendiri di atas DataGrout, bukan untuk konfigurasi klien dasar.

Dukungan bahasa

Bahasa	Paket	Instalasi
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

Mendapatkan server tanpa mendaftar terlebih dahulu

Belum memiliki akun atau endpoint DataGrout? SDK dapat menyediakan keduanya untuk Anda secara langsung (Python ditampilkan; panggilan yang sama ada di SDK setiap bahasa — lihat dokumentasi per bahasa yang ditautkan di bawah untuk sintaks yang tepat):

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()

Di balik satu panggilan itu: SDK mendaftarkan agen Anda, menukar token berumur pendek dengan kredensial OAuth dan URL server, menghasilkan pasangan kunci lokal, dan menandatanganinya oleh CA DataGrout. Kunci privat tetap berada di mesin Anda. Setiap proses setelah yang pertama menggunakan kembali identitas yang tersimpan secara otomatis.

Lebih suka terminal daripada menulis kode: invariant onboard.

Autentikasi

Tiga metode, identik di kelima SDK:

• Token Bearer — opsi paling sederhana, bagus untuk pengujian cepat.

• OAuth 2.1 (kredensial klien) — SDK mengambil, menyimpan cache, dan menyegarkan JWT secara otomatis.

• mTLS — setelah bootstrap satu kali, sertifikat itu sendiri mengautentikasi setiap permintaan; tidak ada token yang perlu dikelola setelahnya.

Untuk mTLS, identitas ditemukan otomatis dalam urutan pencarian tetap: direktori override eksplisit, variabel env CONDUIT_MTLS_CERT/CONDUIT_MTLS_KEY, CONDUIT_IDENTITY_DIR, default ~/.conduit/, lalu .conduit/ lokal relatif terhadap direktori kerja. Menjalankan beberapa agen di satu mesin berarti memberikan direktori identitas terpisah untuk masing-masing.

Mengapa CA khusus: identitas mesin memiliki persyaratan yang berbeda dari identitas browser — agen memerlukan sertifikat yang diterbitkan dan diputar secara terprogram, tanpa manusia dalam proses setiap kali. Kunci penandatangan berada di AWS KMS yang didukung HSM (FIPS 140-2 Level 2) dan tidak pernah meninggalkannya. Sertifikat CA bersifat publik di ca.datagrout.ai/ca.pem untuk verifikasi rantai independen.

Opsi transport

Transport	Protokol	Gunakan saat
mcp (default)	MCP melalui Streamable HTTP/SSE	Anda menginginkan dukungan protokol penuh, streaming, notifikasi
jsonrpc	JSON-RPC 2.0 melalui HTTP POST	Anda menginginkan sesuatu yang lebih sederhana dan tanpa status
websocket	JSON-RPC 2.0 melalui WebSocket	Anda memerlukan server untuk mendorong peristiwa, bukan hanya merespons

Autentikasi bekerja identik di ketiganya — mengganti transport tidak berarti mengganti cara Anda mengautentikasi.

Fitur utama

• Antarmuka Cerdas (aktif secara default) — merampingkan seluruh permukaan alat menjadi dua panggilan, discover dan perform. Agen mendeskripsikan tujuan dalam bahasa biasa alih-alih menalar ratusan skema alat. Nonaktifkan dengan use_intelligent_interface=False untuk melihat alat mentah.

• Penemuan semantik — tersedia juga secara mandiri, untuk mencari alat berdasarkan makna daripada nama yang tepat.

• Visibilitas biaya — setiap panggilan mengembalikan tanda terima dengan penggunaan kredit.

• Alur kerja terpandu — client.guide(goal=...) memandu melalui tujuan multi-langkah secara interaktif.

• Sertifikat Kepercayaan Kognitif — bukti kriptografis bahwa alur kerja bebas siklus, aman tipe, sesuai kebijakan, dan dalam anggaran, ditandatangani oleh CA yang sama dengan identitas agen.

Namespace pihak pertama

Namespace	Kegunaannya
prism	Transformasi data, pembuatan bagan, rendering, ekspor
logic	Memori agen persisten melalui lapisan logika Prolog
warden	Pemeriksaan keamanan, verifikasi niat, konsensus multi-model
deliverables	Mendaftarkan dan mengambil produk kerja yang selesai
ephemerals	Memeriksa dan mengelola hasil cache
flow	Orkestrasi alur kerja — perutean, persetujuan manusia, riwayat eksekusi

Alur dapat disimpan sebagai keterampilan bernama yang dapat digunakan kembali (save_as_skill=True) atau disematkan inline sebagai langkah satu kali melalui $compute. flow.route menangani percabangan bersyarat; flow.request_approval/flow.request_feedback menyisipkan titik pemeriksaan manusia. Apa pun yang tidak tercakup oleh namespace dapat dijangkau melalui panggilan dg() generik.

Di mana ini terhubung ke integrasi DataGrout

Conduit adalah lapisan antara agen Anda dan server DataGrout mana pun — termasuk integrasi Salesforce, QuickBooks, dan Oracle Fusion Cloud. Panggilan call_tool("salesforce@1/get_lead@1", ...) bekerja dengan cara yang sama terlepas dari integrasi mana yang dikonfigurasi server tersebut; SDK tidak perlu mengetahui integrasi tertentu sebelumnya.

Ke mana selanjutnya

• Dokumentasi per bahasa: README Python, TypeScript, Rust, Elixir, Ruby (GitHub)

• Detail keamanan: app.datagrout.ai/security

• Alat gratis tanpa akun: MCP Inspector dan JSON-RPC Inspector, berbasis browser

• Lab: tulisan penelitian tentang sertifikat kepercayaan, analisis kode semantik, penegakan kebijakan, model kredit, dan lainnya

Lisensi

MIT