Tovanix
Tovanix

Akses MCP

Hubungkan akun Tovanix ke aplikasi AI yang mendukung MCP. Endpoint https://tovanix.com/api/mcp/rpc menggunakan Streamable HTTP tanpa status dan hanya menerima POST.

  • Autentikasi: Authorization: Bearer <credential> atau header X-MCP-Key; kredensial diawali mcp_live_ dan ditampilkan sekali
  • Izin: semua kemampuan nonaktif sampai diaktifkan; tools/list hanya menampilkan yang aktif, bernama tovanix_ diikuti nama kemampuan
  • Alat pengeluaran dan tindakan permanen memerlukan kode sekali pakai totp_code serta mengikuti batas per panggilan dan harian
  • Daftar IP sumber yang diizinkan, tanggal kedaluwarsa, dan batas laju bawaan 120 panggilan per menit (hingga 600)
  • Tiga sumber daya (katalog kemampuan, ringkasan akun, panduan platform) dan tiga prompt (pemeriksaan akun, laporan belanja, pemeriksaan kedaluwarsa)
  • Kesalahan: 401 kredensial tidak valid, 403 sumber atau status akun tidak diizinkan, 405 bukan POST, 413 permintaan terlalu besar
  • Pembuatan kredensial memerlukan membaca dan menerima Perjanjian Akses MCP; konten serta tindakan atas nama Anda menjadi tanggung jawab Anda
  • Selain pengeluaran dan tindakan permanen, pengaturan penting seperti URL panggilan balik, kiriman publik, dan akses bucket publik juga memerlukan kode sekali pakai; kiriman AI, pesan dukungan, email, dan pembacaan Telegram langsung dibatasi per akun, kiriman serta pesan dukungan berulang ditolak, dan pesan dukungan ditandai “Dikirim melalui asisten AI”

POST /api/mcp/rpc

Tiga kredensial dengan fungsi masing-masing

MCP (Model Context Protocol) memungkinkan klien AI seperti Claude mengakses kemampuan akun Tovanix Anda sebagai “alat”. Di konsol, buat kredensial MCP untuk tiap klien dan aktifkan satu per satu kemampuan yang boleh digunakan; klien terhubung ke endpoint dengan kredensial tersebut, lalu dapat mencari data dan menjalankan tugas melalui percakapan.

MCP memiliki endpoint dan kredensial sendiri, terpisah dari API terbuka dan sesi masuk konsol: menghapus kredensial MCP tidak memengaruhi integrasi API terbuka Anda, begitu pula sebaliknya.

  • API terbuka /api/v1/* — Kunci API (X-API-Key / tanda tangan) — Program yang Anda tulis — Sesuai pengaturan kunci
  • MCP /api/mcp/rpc — Kredensial MCP (Bearer) — Klien AI — Tidak ada — diaktifkan satu per satu
  • Konsol — Sesi masuk — Anda — Semua yang ada di akun Anda

Mulai cepat

Semua klien MCP yang mendukung Streamable HTTP dan pengaturan header permintaan dapat terhubung. Pilih alat Anda di bawah dan salin perintah atau konfigurasi yang sesuai.

Anda juga dapat memeriksa kredensial dengan mengakses tools/list melalui curl: server tidak menyimpan sesi, sehingga panggilan initialize terlebih dahulu tidak diperlukan.

Hanya hash kredensial yang disimpan, sehingga tidak dapat dipulihkan — jika hilang, hapus lalu buat yang baru. Simpan dalam konfigurasi klien; jangan masukkan ke repositori publik, tangkapan layar, atau obrolan.

Endpoint dan autentikasi

Halaman “Akses MCP” di konsol menampilkan endpoint akun Anda yang siap disalin.

  • Endpoint MCP — Setiap permintaan dikirim ke URL tunggal ini.
  • Transportasi — Streamable HTTP tanpa sesi: tiap permintaan diautentikasi sendiri, hanya POST diterima, dan Mcp-Session-Id tidak diterbitkan; GET dan DELETE mengembalikan 405.
  • Autentikasi — Authorization: Bearer <credential>. Jika klien hanya mengizinkan penambahan header khusus tanpa mengubah Authorization, gunakan X-MCP-Key: <credential>.
  • Versi protokol — 2025-06-18 (terbaru), 2025-03-26, dan 2024-11-05, dinegosiasikan berdasarkan versi yang dikirim klien dalam initialize; versi yang tidak didukung menggunakan versi terbaru.
  • Pesan — JSON-RPC 2.0, dengan batas isi permintaan 1 MB. Permintaan batch dari klien lama maksimal 32 item.
  • Permintaan browser — Permintaan dengan header Origin dari situs selain milik platform ditolak (perlindungan pengikatan ulang DNS). Klien desktop dan baris perintah tidak mengirim Origin dan tidak terpengaruh.

Kredensial dan izin

Kredensial diawali mcp_live_ dan panjangnya 73 karakter. Tiap kredensial memiliki pengaturan berikut yang dapat diubah kapan saja di konsol; kredensial kedaluwarsa atau nonaktif langsung berhenti berfungsi.

Sebelum membuat kredensial, Anda harus membaca dan menyetujui Perjanjian Akses MCP. Perjanjian menjelaskan risiko mengizinkan AI mengoperasikan akun dan penanggung risikonya: operasi dan kerugian melalui MCP menjadi tanggung jawab Anda. Kredensial tidak dapat dibuat jika belum ada perjanjian yang diterbitkan; setelah pembaruan, kredensial baru memerlukan persetujuan ulang sementara kredensial yang ada tetap berfungsi.

Saat akun dibatasi, MCP hanya mengizinkan kemampuan baca; operasi tulis, berbiaya, dan tidak dapat dibatalkan ditolak dengan pesan yang mengarahkan pengguna ke konsol. Jika akun dibekukan, semua permintaan mengembalikan 403.

Alat dan penamaan

Nama alat = tovanix_ + nama kemampuan, dengan titik diganti garis bawah. Misalnya, kemampuan account.balance.get menjadi alat tovanix_account_balance_get.

tools/list hanya mengembalikan kemampuan yang aktif untuk kredensial ini. Deskripsi tiap alat menjelaskan kapan digunakan, arti parameter, dan hal yang perlu diperhatikan, agar klien AI dapat memilih alat.

Baca: hanya baca. Tulis: perubahan yang dapat dibatalkan, seperti mengedit catatan. Berbiaya: memotong saldo Anda. Tidak dapat dibatalkan: tindakan seperti menghapus kunci atau menutup kartu. Alat berbiaya dan tidak dapat dibatalkan memerlukan kode sekali pakai (lihat bagian berikut). Beberapa perubahan yang dapat dibatalkan tetapi tetap memerlukan persetujuan langsung — mengubah URL callback, menerbitkan posting, membuat bucket publik — juga memerlukan kode sekali pakai; di konsol ditandai “Kode diperlukan”.

Kode sekali pakai

Alat berbiaya dan tidak dapat dibatalkan menerima parameter tambahan totp_code, yaitu kode 6 digit terkini dari aplikasi autentikator Anda. AI tidak dapat memperoleh kode ini dan akan memintanya saat diperlukan. Hal yang sama berlaku untuk alat bertanda “Kode diperlukan”.

  • Tiap kode hanya berlaku sekali. Kode yang baru dipakai di konsol juga tidak dapat dipakai ulang melalui MCP.
  • Jika autentikasi dua faktor akun belum aktif, alat ini selalu ditolak dengan arahan untuk mengaktifkannya di konsol.
  • Kode diperiksa sebelum langkah lainnya, sehingga kode yang salah tidak menghabiskan kuota pengeluaran harian.

Batas pengeluaran

Setiap panggilan berbiaya melewati empat langkah berikut secara berurutan; jika satu langkah gagal, dana tidak dipotong.

confirmed_total_usd

Sebagian besar alat berbiaya memerlukan confirmed_total_usd: jumlah total yang ditawarkan AI dan Anda setujui. Jika harga saat eksekusi lebih tinggi, tidak ada tindakan yang dijalankan dan AI memberi tahu harga baru.

Penanganan kuota saat gagal

Jika panggilan gagal dan dipastikan tidak ada biaya terpotong, kuota yang dicadangkan dikembalikan. Jika hasil pembebanan biaya belum dapat dipastikan, kuota tetap dicadangkan agar biaya yang mungkin terjadi tetap dihitung. Tagihan menunjukkan biaya yang benar-benar dibebankan.

Batas frekuensi dan konten yang dikirim atas nama Anda

Selain batas frekuensi tiap kredensial, alat yang menulis konten atas nama Anda atau mengirim permintaan Telegram langsung memiliki batas per akun: digunakan bersama oleh semua kredensial akun dan diatur ulang setiap hari pukul 00:00 UTC+8. Panggilan yang melampaui batas ditolak dan AI diminta berhenti; posting komunitas dan pesan dukungan dengan isi identik dalam 10 menit juga ditolak, sedangkan email dideduplikasi berdasarkan kunci idempotensi, bukan isi. Di konsol, alat ini ditandai “Dibatasi frekuensi”.

Konten atas nama Anda

Setelah alat terkait diaktifkan, AI dapat memposting dan membalas di komunitas, menghubungi dukungan langsung, dan mengirim email dari akun SMTP atas nama Anda. Konten tersebut mewakili Anda dan menjadi tanggung jawab Anda:

Sumber daya dan prompt

Selain alat, server menyediakan tiga sumber daya hanya baca dan tiga prompt yang dapat langsung dipakai klien.

  • tovanix://catalog — Katalog kemampuan: semua bidang dan kemampuan, serta yang diaktifkan kredensial ini. AI membacanya ketika mendapat “tidak diizinkan” atau ditanya apa yang dapat dilakukan.
  • tovanix://account/overview — Ringkasan akun: status akun, layanan yang digunakan, serta izin dan penggunaan kuota harian kredensial ini. Saldo hanya ditampilkan jika “Lihat saldo akun” aktif.
  • tovanix://guide — Panduan platform: penyajian jumlah dan mata uang, status pesanan, dan hal yang harus dikonfirmasi sebelum memesan.
  • account_health — — — Pemeriksaan akun: saldo, langganan, masa berlaku lintas layanan, pesanan tidak biasa, dan daftar hal yang perlu ditangani.
  • spend_report — days, bawaan 30 — Laporan pengeluaran: tagihan terbaru dan total pengeluaran per layanan.
  • renewal_check — within_days, bawaan 14 — Pemeriksaan masa berlaku: layanan yang akan kedaluwarsa dan biaya perpanjangannya — tidak ada perpanjangan otomatis.

Kesalahan dan pemecahan masalah

Masalah koneksi dan autentikasi dikembalikan sebagai kode status HTTP. Kegagalan bisnis dikembalikan sebagai hasil alat (isError: true) dengan teks yang menjelaskan langkah berikut untuk AI, misalnya “minta kode sekali pakai kepada pengguna” atau “saldo tidak cukup — minta pengguna isi ulang dahulu”.

Hubungkan Tovanix MCP dari setiap alat AI

Ganti <YOUR_MCP_CREDENTIAL> dengan kredensial MCP yang dibuat di konsol.

  • Claude Code — Jalankan di terminal
    claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Codex — Berkas konfigurasi: ~/.codex/config.toml
    [mcp_servers.tovanix]
    url = "https://tovanix.com/api/mcp/rpc"
    bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL"
  • Cursor — Berkas konfigurasi: ~/.cursor/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • GitHub Copilot (VS Code) — Berkas konfigurasi: .vscode/mcp.json
    {
      "servers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer ${input:tovanix-credential}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "tovanix-credential",
          "description": "Tovanix MCP credential",
          "password": true
        }
      ]
    }
  • Gemini CLI — Berkas konfigurasi: ~/.gemini/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "httpUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • OpenCode — Berkas konfigurasi: ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Qwen Code — Jalankan di terminal
    qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>"
  • Kimi Code CLI — Berkas konfigurasi: ~/.kimi-code/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • CodeBuddy Code — Jalankan di terminal
    codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc
  • Qoder CLI — Berkas konfigurasi: ~/.qoder/settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamable-http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kiro — Berkas konfigurasi: ~/.kiro/settings/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae — Berkas konfigurasi: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CN — Berkas konfigurasi: .trae/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Trae CLI — Berkas konfigurasi: trae_cli.yaml
    mcp_servers:
      - name: "tovanix"
        url: "https://tovanix.com/api/mcp/rpc"
        type: "http"
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
  • GitHub Copilot CLI — Berkas konfigurasi: ~/.copilot/mcp-config.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "http",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          },
          "tools": [
            "*"
          ]
        }
      }
    }
  • Cline — Berkas konfigurasi: cline_mcp_settings.json
    {
      "mcpServers": {
        "tovanix": {
          "type": "streamableHttp",
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Kilo Code — Berkas konfigurasi: ~/.config/kilo/kilo.jsonc
    {
      "mcp": {
        "tovanix": {
          "type": "remote",
          "url": "https://tovanix.com/api/mcp/rpc",
          "enabled": true,
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Continue — Berkas konfigurasi: ~/.continue/config.yaml
    mcpServers:
      - name: tovanix
        type: streamable-http
        url: https://tovanix.com/api/mcp/rpc
        requestOptions:
          headers:
            Authorization: Bearer <YOUR_MCP_CREDENTIAL>
  • Zed — Berkas konfigurasi: ~/.config/zed/settings.json
    {
      "context_servers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Junie — Berkas konfigurasi: ~/.junie/mcp/mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Amp — Berkas konfigurasi: ~/.config/amp/settings.json
    {
      "amp.mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Goose — Berkas konfigurasi: ~/.config/goose/config.yaml
    extensions:
      tovanix:
        enabled: true
        type: streamable_http
        name: tovanix
        uri: https://tovanix.com/api/mcp/rpc
        headers:
          Authorization: "Bearer <YOUR_MCP_CREDENTIAL>"
        timeout: 300
  • Augment (Auggie) — Jalankan di terminal
    auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>"
  • Factory Droid — Jalankan di terminal
    droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth
  • Crush — Berkas konfigurasi: ~/.config/crush/crushrc
    mcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>"
  • Warp — Tempel di pengaturan aplikasi
    {
      "tovanix": {
        "url": "https://tovanix.com/api/mcp/rpc",
        "headers": {
          "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
        }
      }
    }
  • Windsurf — Berkas konfigurasi: ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "tovanix": {
          "serverUrl": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Claude (web / aplikasi desktop) — Masukkan alamat pada aplikasi dan tambahkan header Authorization (Bearer + kredensial)
    https://tovanix.com/api/mcp/rpc
  • LM Studio — Berkas konfigurasi: mcp.json
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }
  • Dify — Masukkan alamat pada aplikasi dan tambahkan header Authorization (Bearer + kredensial)
    https://tovanix.com/api/mcp/rpc
  • Coze — Masukkan alamat pada aplikasi dan tambahkan header Authorization (Bearer + kredensial)
    https://tovanix.com/api/mcp/rpc
  • n8n — Masukkan alamat pada aplikasi dan tambahkan header Authorization (Bearer + kredensial)
    https://tovanix.com/api/mcp/rpc
  • Aplikasi klien MCP lainnya — Tempel di pengaturan aplikasi
    {
      "mcpServers": {
        "tovanix": {
          "url": "https://tovanix.com/api/mcp/rpc",
          "headers": {
            "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>"
          }
        }
      }
    }

Pertanyaan umum

Mengapa tools/list mengembalikan daftar kosong?

Kredensial belum memiliki kemampuan aktif. Aktifkan yang diperlukan di “Akses MCP” pada konsol, lalu hubungkan kembali.

Mengapa alat pengeluaran selalu ditolak?

Periksa tiga hal: apakah batas belanja kredensial masih bawaan 0, apakah autentikasi dua faktor aktif, dan apakah batas harian sudah habis.

Halaman terkait: Biarkan asisten AI mengelola akun Tovanix Anda · Dokumentasi API · Integrasi pengembang

Memuat…