Menghubungkan AI
Pakai kunci API Anda sendiri untuk Claude, ChatGPT, Gemini, dan penyedia lain, atau server AI sendiri seperti Ollama.
Fitur AI di MyPlan (menulis deskripsi tugas, merangkum, menyarankan sub-tugas, dan bantuan menulis di halaman) berjalan lewat koneksi AI milik workspace. Setiap workspace menghubungkan penyedia AI pilihannya sendiri dengan kuncinya sendiri, jadi biaya AI dibayar langsung oleh workspace ke penyedia tersebut, bukan lewat tagihan MyPlan.
Ada dua cara menghubungkan AI:
| Mode | Untuk | Yang dibutuhkan |
|---|---|---|
| Penyedia | Anthropic Claude, OpenAI ChatGPT, Google Gemini, atau penyedia lain yang kompatibel dengan OpenAI (OpenRouter, Groq, Mistral, DeepSeek, Together, dan sejenisnya) | Kunci API dari penyedia dan nama model |
| Endpoint kustom | Server AI Anda sendiri: Ollama, LM Studio, vLLM, LocalAI, atau server lain yang kompatibel dengan OpenAI | URL server, nama model, dan token (opsional) |
Hanya pemilik dan admin workspace yang bisa mengatur koneksi AI. Anggota cukup memakai AI. Tamu tidak bisa memakai AI.
Menghubungkan penyedia
Buka pengaturan AI
Pengaturan workspace → AI, lalu di bagian Koneksi AI pilih Penyedia.
Pilih penyedia
Pilih Claude, ChatGPT, Gemini, atau Lainnya (kompatibel OpenAI). Untuk Lainnya, klik salah satu
preset (OpenRouter, Groq, Mistral, DeepSeek) untuk mengisi Base URL, atau isi sendiri alamat
API yang biasanya diakhiri /v1.
Tempel kunci API
Buat kunci di konsol penyedia (tautan Dapatkan kunci dari ... ada di bawah kolom kunci), lalu tempel di Kunci API.
Pilih model
Klik Muat model untuk mengambil daftar model dari penyedia, lalu pilih salah satu. Anda juga bisa mengetik nama model secara langsung.
Uji lalu simpan
Klik Uji koneksi. MyPlan mengirim prompt kecil dan menampilkan waktu respons serta model yang menjawab. Jika berhasil, klik Simpan.
Di bagian Lanjutan Anda bisa mengatur Batas waktu (5 sampai 300 detik, bawaan 60), Token maksimum (panjang jawaban), Temperature, dan Base URL untuk proxy atau gateway di depan penyedia besar.
Menghubungkan Ollama (server sendiri)
Buka Ollama ke jaringan
Secara bawaan Ollama hanya mendengarkan 127.0.0.1. Di mesin Ollama, atur variabel lingkungan
OLLAMA_HOST=0.0.0.0 lalu jalankan ulang Ollama, supaya server MyPlan bisa menjangkaunya di port 11434.
Pastikan firewall mengizinkan port tersebut dari server MyPlan, dan unduh dulu model yang ingin dipakai
(misalnya ollama pull qwen2.5:7b).
Minta admin MyPlan mengizinkan alamatnya
Demi keamanan, MyPlan menolak alamat privat dan internal (misalnya 192.168.x.x, 10.x.x.x, localhost, dan
alamat layanan di dalam cluster). Alamat Ollama Anda harus dimasukkan dulu oleh admin MyPlan ke daftar
ai.allowedPrivateHosts di konsol MyPlan (berisi nama host, alamat IP, atau rentang CIDR). Sebelum diizinkan,
penyimpanan dan uji koneksi menampilkan Alamat ini privat atau internal, jadi diblokir MyPlan. Minta admin MyPlan
Anda mengizinkan host ini untuk koneksi AI.
Isi koneksi
Di Koneksi AI pilih Endpoint kustom → Ollama, isi URL server (misalnya http://192.168.1.20:11434),
klik Muat model, pilih model, lalu Uji koneksi dan Simpan. Token boleh dikosongkan, kecuali Ollama Anda
berada di balik proxy yang meminta bearer token.
Alamat http:// biasa hanya boleh untuk host yang sudah diizinkan admin MyPlan. Alamat publik harus memakai https://.
Model lokal bisa lambat saat pertama dimuat; naikkan Batas waktu jika uji koneksi kehabisan waktu.
Server lain yang kompatibel dengan OpenAI (LM Studio, vLLM, LocalAI) memakai langkah yang sama dengan tipe
Kompatibel OpenAI dan URL yang diakhiri /v1, misalnya http://192.168.1.30:1234/v1.
Keamanan kunci
- Kunci API disimpan terenkripsi (AES-256-GCM) dan tidak pernah dikirim kembali ke browser. Setelah disimpan,
yang tampil hanya empat karakter terakhir, misalnya
••••abcd, beserta siapa dan kapan kunci diatur. - Kunci hanya bisa diganti atau dihapus, tidak bisa dilihat lagi.
- Kunci tersimpan hanya dikirim ke penyedia dan alamat tempat kunci itu dimasukkan. Jika Anda mengganti penyedia atau alamat, masukkan kuncinya lagi.
- Setiap perubahan koneksi tercatat di Log audit: siapa, penyedia, model, dan host, tanpa kunci.
Ke mana biayanya
| Situasi | Siapa yang membayar | Kuota AI bulanan MyPlan |
|---|---|---|
| Workspace memakai koneksinya sendiri | Workspace, langsung ke penyedia AI (atau gratis untuk server sendiri) | Tidak dihitung |
| Workspace belum punya koneksi dan MyPlan menyediakan AI bawaan | MyPlan | Dihitung sesuai paket |
| Workspace belum punya koneksi dan AI bawaan tidak tersedia | — | AI tidak bisa dipakai sampai koneksi dibuat |
Fitur AI tetap mengikuti paket langganan workspace (lihat Kuota dan fitur langganan).
Privasi
Prompt berisi konten yang sedang diolah, yaitu halaman, atau tugas beserta komentarnya, dan dikirim ke penyedia yang Anda hubungkan. Ketentuan dan kebijakan data penyedia tersebut berlaku. Anggota hanya bisa mengirim apa yang sudah bisa mereka buka.
Batas per anggota dan pemakaian
- Batas per jam per anggota: admin bisa mengatur berapa permintaan AI yang boleh dibuat setiap anggota per jam (bawaan 60, 0 berarti tanpa batas).
- Pemakaian per anggota: tabel di pengaturan AI menampilkan jumlah permintaan, yang gagal, token masuk/keluar, dan waktu terakhir dipakai per anggota untuk bulan ini atau bulan lalu.
Pesan galat yang sering muncul
| Pesan | Artinya |
|---|---|
| ... menolak kunci API | Kunci salah, tidak lengkap, atau sudah dicabut. Buat kunci baru dan ganti. |
| ... tidak punya model ini | Nama model salah atau model belum diunduh (Ollama). Klik Muat model. |
| ... tidak punya API AI di alamat ini | Base URL salah. Server kompatibel OpenAI biasanya diakhiri /v1. |
| Tidak bisa menjangkau ... | Server mati, firewall menutup port, atau Ollama belum memakai OLLAMA_HOST=0.0.0.0. |
| Akun ... sudah kehabisan kredit atau kuota | Isi ulang saldo di penyedia. |
| Alamat ini privat atau internal | Minta admin MyPlan mengizinkan host tersebut. |
Izin
| Aksi | Pemilik | Admin | Anggota | Tamu |
|---|---|---|---|---|
| Melihat dan mengubah koneksi AI | Ya | Ya | Tidak | Tidak |
| Uji koneksi dan memuat daftar model | Ya | Ya | Tidak | Tidak |
| Mengatur batas per jam dan melihat pemakaian per anggota | Ya | Ya | Tidak | Tidak |
| Memakai AI | Ya | Ya | Ya | Tidak |