Kembali ke katalog

OpenCode — menghubungkan agen AI melalui MCP

Hubungkan OpenCode ke MCP Deskgram 2: alamat lokal, token Bearer, konfigurasi, dan pemeriksaan alat baca.

OpenCode — menghubungkan agen AI melalui MCP
AI dan MCPAgen AI

OpenCode adalah agen AI yang mendukung server MCP. Agen ini dapat terhubung ke MCP lokal Deskgram 2 untuk membaca alat yang diizinkan, skema modul, dan status tugas. Model bahasa untuk OpenCode dikonfigurasi secara terpisah.

Menyiapkan Deskgram

Jalankan Deskgram, buka pengaturan MCP, tetapkan token, aktifkan listener, lalu simpan. Alamat bawaan adalah http://127.0.0.1:8765/mcp. Jika port diubah, gunakan nilai tersebut pada konfigurasi agen.

Untuk pemeriksaan pertama, pertahankan mode hanya-baca dan aktifkan alat yang diperlukan saja. Katalog MCP aktual menunjukkan kemampuan versi yang terpasang.

Konfigurasi OpenCode

Tambahkan server berikut ke konfigurasi. Sebelum menjalankan agen, isi variabel lingkungan DESKGRAM_MCP_TOKEN dengan token yang sama seperti di Deskgram.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "deskgram": {
      "type": "remote",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer {env:DESKGRAM_MCP_TOKEN}" },
      "oauth": false,
      "enabled": true
    }
  }
}

Jika sudah ada server, tambahkan deskgram ke objek mcp yang ada tanpa mengganti lainnya. oauth: false menggunakan Bearer, bukan mencoba OAuth otomatis.

127.0.0.1 menunjuk ke lingkungan tempat OpenCode berjalan. Di kontainer atau server jarak jauh, alamat tersebut tidak otomatis mengarah ke Deskgram di komputer Anda.

Memeriksa tanpa menjalankan tugas

Jalankan opencode mcp list, lalu minta agen memanggil deskgram_health dan deskgram_list_modules. Gunakan deskgram_get_module_schema, misalnya untuk profile_setup, untuk membaca parameter.

Membaca skema tidak memulai modul. Sebelum membuat tugas, tinjau akun, parameter, izin MCP, dan mode eksekusi. Operasi tulis dapat memerlukan izin tambahan; alat yang tercantum belum tentu diaktifkan.

OpenCode dan OpenRouter

OpenCode menangani percakapan dan pemanggilan MCP, sedangkan OpenRouter menyediakan model. Jika dipakai oleh agen, kunci dan penagihan OpenRouter diatur terpisah. Kunci yang disimpan di Deskgram tidak mengonfigurasi OpenCode atau memberinya akses MCP.

Kesalahan dan dokumentasi

Jika gagal tersambung, periksa Deskgram, listener, port, dan /mcp. Jika otorisasi gagal, periksa variabel lingkungan serta header Bearer; jalankan ulang OpenCode setelah mengubah lingkungan. Respons405 untuk GET browser bukan pengujian pertukaran MCP: gunakan klien MCP.

Lihat dokumentasi OpenCode MCP, MCP Deskgram, dan panduan OpenRouter.

Ketentuan dan pengungkapan

Biaya model mengikuti penyedia yang dipilih. Tombol membuka situs resmi tanpa kode rujukan. Panduan ini tidak menyatakan kemitraan resmi.

Pengaturan diperiksa pada 20 Oktober 2026.

Buka situs