Hubungkan Claude, Cursor, VS Code, atau klien MCP apa pun ke mesin Qurak.
Asisten yang menebak-nebak aritmetika salah cukup sering untuk berdampak. Terhubung ke sini, ia menyerahkan matematikanya ke mesin sungguhan dan mengembalikan jawaban terhitung, bukan jawaban yang sekadar masuk akal — kalkulus, persamaan diferensial, aljabar, statistika, plot.
Koneksi ini memberi tahu agen Anda kebenaran tentang dirinya sebelum komputasi apa pun dihabiskan: check_support menjawab apakah sebuah fungsi ada, get_capabilities melaporkan batas yang benar-benar berlaku, dan plan_computation mengubah tujuan menjadi metode kerja dengan resep terverifikasi terlampir. Agen akan terus memanggil alat yang mengatakan di muka apa yang tidak bisa dilakukannya.
Ia terbuka di setiap paket, termasuk yang gratis, dan seluruh koneksinya hanyalah satu URL. Yang dibeli paket berbayar adalah anggaran komputasi dan laju — tidak pernah aksesnya.
| URL | Transpor | Kegunaan |
|---|---|---|
| https://qurak.com/mcp | Streamable HTTP | Diutamakan. Pakai ini kecuali klien Anda tidak bisa. |
| https://qurak.com/mcp/sse | HTTP+SSE (2024-11-05) | Usang, hanya untuk klien lama. |
Transpornya stateless: ia tidak menerbitkan id sesi protokol, jadi GET dan DELETE pada /mcp menjawab 405 memang disengaja. Itu terpisah dari session_id opsional yang diterima alat evaluasi — lihat Alat — yang merupakan argumen alat yang Anda pilih, bukan sesuatu yang dibagikan transpor.
Kebanyakan klien menangani ini untuk Anda. Pilih klien Anda di bawah dan ikuti satu jalur yang ditunjukkannya — Anda tidak butuh keduanya.
| Metode | Cara kerja | Pakai saat |
|---|---|---|
| OAuth | Klien membuka peramban Anda, Anda masuk ke Qurak dan menyetujui permintaannya. Tidak ada kredensial yang disalin dengan tangan. | Klien Anda hanya meminta URL — Claude Desktop dan claude.ai tidak punya tempat menaruh token. |
| Token Bearer | Anda membuat token dan menaruhnya di header Authorization di konfigurasi klien. | Klien Anda mendukung header dan Anda ingin kredensial tetap — berguna untuk CI atau mesin bersama. |
| Cakupan | Memberi |
|---|---|
| qurak:evaluate | Menjalankan ekspresi dan membuat plot di akun Anda. Menghabiskan anggaran komputasi dan batas laju paket Anda. |
| qurak:docs | Membaca referensi fungsi. Tidak menghabiskan komputasi, jadi koneksi khusus dokumentasi aman diberikan secara luas. |
Di baliknya, ini alur OAuth 2.1 standar dengan PKCE, dapat ditemukan di /.well-known/oauth-protected-resource dan /.well-known/oauth-authorization-server (juga dijawab di /.well-known/openid-configuration, yang dicoba lebih dulu oleh sebagian klien). Klien dapat mengidentifikasi dirinya dengan tiga cara — sebuah dokumen metadata client ID, pendaftaran dinamis, atau client ID dan secret yang Anda daftarkan di bawah — dan klien yang mendukung salah satunya akan menemukannya sendiri.
claude mcp add --transport http qurak https://qurak.com/mcp \
--header "Authorization: Bearer qk_..."<code>type</code> wajib ada. Entri dengan <code>url</code> tanpa <code>type</code> dibaca sebagai server stdio dan dilewati diam-diam.
{
"mcpServers": {
"qurak": {
"type": "http",
"url": "https://qurak.com/mcp",
"headers": { "Authorization": "Bearer qk_..." }
}
}
}Hilangkan flag <code>--header</code> untuk memakai OAuth: Claude Code membuka peramban saat pertama terhubung.
Jalur ini memang hanya OAuth — tidak ada kolom untuk token. Langkah yang sama berlaku untuk konektor claude.ai.
Cursor lebih memilih OAuth begitu server menerbitkan metadata penemuan, dan server ini menerbitkannya — jadi blok <code>headers</code> di konfigurasinya kemungkinan diabaikan. Harapkan alur peramban, dan biarkan berjalan.
Kuncinya <code>servers</code>, bukan <code>mcpServers</code>.
{
"servers": {
"qurak": {
"type": "http",
"url": "https://qurak.com/mcp",
"headers": { "Authorization": "Bearer ${input:qurak-token}" }
}
},
"inputs": [
{ "id": "qurak-token", "type": "promptString",
"description": "Qurak Bearer token", "password": true }
]
}Memakai <code>inputs</code> menjaga token di luar berkas, jadi konfigurasinya aman untuk di-commit.
Jika klien Anda hanya bisa transpor HTTP+SSE yang lebih lama, arahkan ke <code>https://qurak.com/mcp/sse</code>.
https://qurak.com/mcp| Alat | Fungsinya | Cakupan |
|---|---|---|
| evaluate | Mengevaluasi ekspresi Qurak (sintaks kompatibel .wl). Mengembalikan hasil terformat, beserta waktu tempuhnya. Opsional session_id, format (Standard, TeX, JSON) dan timeout_ms. | qurak:evaluate |
| plot | Menjalankan ekspresi pemplotan dan mengembalikan grafiknya sebagai gambar PNG. Menerima argumen yang sama dengan session_id dan timeout_ms. | qurak:evaluate |
| clear_session | Membuang sesi evaluasi beserta semua yang didefinisikan di dalamnya. | qurak:evaluate |
| search_docs | Mencari di referensi fungsi berdasarkan nama atau deskripsi, sekaligus resep tugas di sampingnya. Opsional kind (function, task, any); setiap hasil menyebutkan jenisnya. | qurak:docs |
| get_task | Satu resep tugas lengkap: langkah-langkahnya berurutan, dan keluaran yang dihasilkan tiap langkah saat diverifikasi pada mesin ini. Langkah-langkah berjalan berurutan dalam satu sesi. | qurak:docs |
| get_symbol | Semua yang diketahui tentang satu simbol: ketersediaan, bentuk, opsi, contoh. | qurak:docs |
| check_support | Memeriksa apakah fungsi tertentu tersedia, sebelum memakainya. | qurak:docs |
| plan_computation | Membumikan tujuan sebelum menghitung: putusan dukungan untuk setiap fungsi dalam draf ekspresi, resep terverifikasi yang paling dekat, dan rekomendasi rute dalam angka anggaran koneksi ini sendiri. Tidak menghabiskan komputasi. | qurak:docs |
| evaluate_async | Mengirim ekspresi sebagai pekerjaan latar belakang dengan anggaran hitungan menit yang bergantung paket, untuk pekerjaan yang tidak tertampung anggaran interaktif. Mengembalikan id pekerjaan seketika; pekerjaan adalah jatah harian. | qurak:evaluate |
| get_job list_jobs cancel_job | Status sebuah pekerjaan dan, begitu selesai, hasil lengkapnya (berikan wait_ms dan satu panggilan melakukan long-poll alih-alih puluhan polling rapat); pekerjaan terbaru pada akun; pembatalan. Polling gratis. | qurak:evaluate |
| simulate_circuit | Menyimulasikan sirkuit kuantum - vektor keadaan ideal, set gerbang standar - dan mengembalikan histogram pengukurannya. Berjalan sebagai pekerjaan latar belakang, dengan plafon qubit yang mengikuti paket. | qurak:evaluate |
| save_guide get_guide list_guides delete_guide | Catatan tahan lama pada akun: simpan definisi dan asumsi sebuah model kerja di bawah sebuah nama, dan baca kembali di percakapan berikutnya. Membaca membutuhkan cakupan docs; menulis membutuhkan evaluate. | qurak:docs qurak:evaluate |
| get_capabilities | Batas yang berlaku untuk koneksi ini, dalam angka: plafon anggaran komputasi, jatah per menit dan sisanya, plot tersimpan terbesar, cakupan yang diberikan, batas sesi. Tanpa argumen. | apa saja |
| WolframLanguageEvaluator | Alias warisan untuk evaluate, dipertahankan untuk klien yang mengharapkan nama alat AgentTools. Argumen sama, perilaku sama. | qurak:evaluate |
evaluate dan plot bersifat stateless kecuali Anda meneruskan session_id. Dengan satu, definisi terbawa — a = 10 pada satu panggilan, lalu a + 5 pada panggilan berikutnya dengan id yang sama, dievaluasi menjadi 15. Sesi bersifat privat untuk akun Anda, jadi dua akun yang memakai id sama tidak pernah melihat variabel satu sama lain. Sesi dibuang setelah 30 menit menganggur, saat sebuah evaluasi di dalamnya kehabisan waktu (mesin tidak bisa diinterupsi, jadi sesinya ikut hilang), atau saat Anda memanggil clear_session.
Anggaran komputasi dan batas laju mengikuti paket Anda — lihat Harga, atau panggil get_capabilities dari koneksi itu sendiri untuk angka yang berlaku. Melampaui salah satunya kembali sebagai hasil alat dengan isError terisi, bukan kesalahan transpor, sehingga agen Anda dapat membaca pesannya dan menyesuaikan. Hal yang sama berlaku untuk kesalahan sintaksis, waktu habis, atau kegagalan di dalam mesin: semuanya adalah jawaban, dan koneksi tetap terbuka.
check_support memberi tahu apa yang tersedia tanpa menghabiskan satu evaluasi. timeout_ms memungkinkan sebuah panggilan meminta anggaran lebih pendek daripada yang diizinkan paket — berguna untuk gagal cepat pada ekspresi yang Anda duga murah. Ia dibatasi ke anggaran paket sendiri, jadi tidak bisa membeli waktu lebih dari yang Anda punya. Fungsi berkas, proses, dan jaringan diblokir.