Integrasi Developer

Halaman ini adalah panduan publik utama untuk semua integrasi BotConnector. Anda tidak perlu login untuk membacanya. Login hanya diperlukan saat membuat API key BotConnector.

Install BCCLI

bash

npm install -g @botconnector/bccli
bccli login bc-cloud

Hubungkan tool yang Anda gunakan:

bash

bccli connect opencode
bccli connect cline
bccli connect aider
bccli connect deepseek-harness
bccli connect codex
bccli connect claude-code
bccli connect cursor
bccli connect openai-cli
bccli connect openai-sdk
bccli connect openai-compatible

Cek status atau pulihkan konfigurasi:

bash

bccli integrations
bccli disconnect <nama-integrasi>

BCCLI membuat backup sebelum mengubah file konfigurasi eksternal yang dikelolanya.

Protocol yang digunakan

Client	Protocol BotConnector
OpenCode / Cline / Aider / DeepSeek Harness	`/v1/chat/completions`
Codex CLI	`/v1/responses`
Claude Code	`/v1/messages` + `/v1/messages/count_tokens`
OpenAI CLI / SDK / compatible client	OpenAI-compatible profile
Cursor	Guided OpenAI Base URL setup
Kelivo (Android / iPhone)	`/v1/chat/completions`
Crush	`/v1/chat/completions`
Kilo Code	`/v1/chat/completions`

Kelivo

Kelivo adalah client mobile open-source yang dapat terhubung langsung ke endpoint OpenAI-compatible BotConnector tanpa akun Kelivo.

Install Kelivo dari App Store atau rilis Android.
Di halaman Providers, tekan tombol + kanan atas lalu pilih Import Provider. Jangan memilih provider bawaan seperti OpenAI, Gemini, OpenRouter, atau SiliconFlow.
Paste konfigurasi dari BotConnector Kelivo provider, lalu tekan Import. Provider baru bernama BotConnector akan muncul.
Provider bawaan lain boleh tetap ON; tidak perlu diubah. Saat memakai BotConnector, pilih provider/model BotConnector.
Buka BotConnector → Config dan masukkan API key bc_live_... dari Workspace → API Keys.
Di tab Models, tekan Fetch. Kelivo mengambil daftar model akun melalui GET https://api.botconnector.id/v1/models.

Konfigurasi import tidak pernah membawa API key. Untuk lampiran chat langsung, Kelivo mengekstrak PDF, DOCX, TXT, Markdown, CSV, JSON, serta file teks/kode secara lokal. Batas ekstraksi langsung adalah 16 MB per file; gunakan BotConnector Web App / Workspace untuk file yang lebih besar.

Crush Beta

Crush mendukung BotConnector melalui provider native openai-compat dan dapat mengambil model akun dari GET /v1/models.

Buat API key di Workspace → API Keys.
Export key sebelum menjalankan Crush:

bash

export BOTCONNECTOR_API_KEY="bc_live_..."

Tambahkan ke ~/.config/crush/crushrc:

bash

provider add botconnector \
  --name "BotConnector" \
  --type openai-compat \
  --base-url "https://api.botconnector.id/v1" \
  --api-key "${BOTCONNECTOR_API_KEY:?set BOTCONNECTOR_API_KEY}" \
  --discover-models true

Crush akan menggabungkan model BotConnector yang ditemukan dengan model lain yang sudah ada pada provider tersebut. Provider Crush lain tidak diubah.

Kilo Code Beta

Kilo Code dapat memakai BotConnector sebagai custom OpenAI-compatible provider dan mengambil daftar model akun secara otomatis.

Buka Settings → Providers → Custom provider.
Isi:

Provider ID: botconnector
Display name: BotConnector
Provider API: OpenAI Compatible
Base URL: https://api.botconnector.id/v1
API key: key bc_live_... Anda

Tekan Fetch models, pilih model BotConnector yang ingin dipakai, lalu simpan.

Kilo Code membaca endpoint /v1/models BotConnector yang terautentikasi, sehingga model yang tampil mengikuti API key tersebut.

OpenCode

bash

bccli connect opencode

BCCLI mengambil katalog model, menambahkan provider botconnector, mempertahankan provider lain, dan menulis ~/.config/opencode/opencode.json. Setelah itu jalankan opencode seperti biasa.

Lepas integrasi: bccli disconnect opencode.

Cline

bash

bccli connect cline

BCCLI mengelola ~/.cline/data/settings/providers.json, memasang provider openai-compatible, Base URL BotConnector, dan model default aktif. Jika slot openai-compatible sudah dipakai endpoint lain, BCCLI tidak akan menimpanya diam-diam.

Lepas integrasi: bccli disconnect cline.

Aider

bash

bccli connect aider

BCCLI mengelola ~/.aider.conf.yml dan ~/.bccli/integrations/aider.env. Setelah connect, jalankan aider seperti biasa.

Lepas integrasi: bccli disconnect aider.

DeepSeek Harness

1. Hubungkan BotConnector

Jalankan satu perintah ini:

bash

bccli connect deepseek-harness

Jika berhasil, BCCLI akan menambahkan provider botconnector ke DeepSeek Harness tanpa menghapus provider DSH lain.

Alias pendek opsional: bccli connect dsh. Alias ini melakukan hal yang sama, jadi tidak perlu menjalankan keduanya.

2. Jalankan DeepSeek Harness

Setelah integrasi berhasil, jalankan:

bash

dsh web

Jangan gunakan dsh saja, karena DeepSeek Harness 0.1.x mewajibkan profile dan akan menampilkan error --profile <name> is required.

Jangan gunakan deepseek-harness, karena nama executable yang dipasang adalah dsh.

Bentuk panjang yang setara dengan dsh web adalah:

bash

dsh --profile web

3. Konfigurasi yang dibuat

BCCLI mengelola:

$DSH_HOME/settings.yaml
$DSH_HOME/.env

Provider memakai api: openai-completions, Base URL https://api.botconnector.id/v1, dan BOTCONNECTOR_API_KEY.

4. Melepas integrasi

Gunakan:

bash

bccli disconnect deepseek-harness

Alias pendek bccli disconnect dsh juga tersedia.

Codex CLI

bash

bccli connect codex

BCCLI membuat ~/.codex/botconnector.config.toml dengan wire_api = "responses" dan Base URL https://api.botconnector.id/v1.

BCCLI juga membuat launcher:

Linux/macOS: ~/.bccli/integrations/codex-botconnector
Windows: %USERPROFILE%\.bccli\integrations\codex-botconnector.cmd

Jalankan launcher tersebut untuk memakai Codex melalui BotConnector. Lepas integrasi: bccli disconnect codex.

Claude Code

bash

bccli connect claude-code

BCCLI membuat launcher Claude Code dengan ANTHROPIC_BASE_URL=https://api.botconnector.id, API key BotConnector, dan model coding BotConnector.

Launcher:

Linux/macOS: ~/.bccli/integrations/claude-botconnector
Windows: %USERPROFILE%\.bccli\integrations\claude-botconnector.cmd

Lepas integrasi: bccli disconnect claude-code.

Cursor

bash

bccli connect cursor

Cursor memakai guided setup. BCCLI membuat ~/.bccli/integrations/cursor.txt dan tidak mengedit storage internal Cursor yang formatnya tidak stabil.

Di Cursor buka Settings → Models, masukkan API key BotConnector, aktifkan Override OpenAI Base URL, lalu gunakan https://api.botconnector.id/v1.

Catatan: override Base URL Cursor berlaku luas untuk request model OpenAI-family. Matikan override saat kembali ke model OpenAI yang dikelola Cursor.

OpenAI CLI

bash

bccli connect openai-cli

BCCLI membuat launcher yang mengatur OPENAI_BASE_URL dan membaca API key dari storage BCCLI, sehingga key tidak ditanam di script.

Launcher: ~/.bccli/integrations/openai-botconnector atau openai-botconnector.cmd di Windows.

OpenAI SDK

bash

bccli connect openai-sdk

BCCLI membuat ~/.bccli/integrations/openai-sdk.env berisi OPENAI_BASE_URL=https://api.botconnector.id/v1 dan API key. Load env file itu ke aplikasi Python/Node Anda lalu gunakan OpenAI SDK seperti biasa.

OpenAI-compatible

bash

bccli connect openai-compatible

BCCLI membuat ~/.bccli/integrations/openai-compatible.env. Gunakan profile itu pada client lain yang mendukung custom OpenAI Base URL.

API key dan keamanan

API key dibuat dari Workspace → API Keys. Membaca halaman ini tidak memerlukan login.

External agent memanggil BotConnector secara langsung dan tidak otomatis mewarisi akses khusus yang hanya diberikan kepada BotConnector Web App atau BCCLI.

Troubleshooting

bash

bccli integrations
bccli disconnect <nama-integrasi>

Jika model tidak muncul, ulangi bccli connect ... agar BCCLI mengambil katalog model terbaru.