Menggunakan klien MCP di iPhone: konektor yang tersedia, server Anda sendiri, dan batasannya
Orvena adalah klien MCP untuk iPhone. Orvena menghubungkan asisten ke Notion, Linear, GitHub, Jira & Confluence, Zapier, dan Home Assistant, atau ke server MCP yang Anda jalankan sendiri, dan memungkinkan Apple Intelligence, Private Cloud Compute, model milik Orvena, atau model OpenRouter memanggil alat-alatnya. Panduan ini membahas layar penyiapan beserta namanya, aturan yang harus dipenuhi server kustom, cara alat muat dalam jendela konteks yang kecil, dan persetujuan yang akan Anda lihat sebelum apa pun diubah atau dikirim.
Apa yang dilakukan klien MCP di iPhone
MCP, singkatan dari Model Context Protocol, adalah standar terbuka untuk menghubungkan layanan ke asisten AI. Sebuah layanan menjalankan server MCP yang mencantumkan alat-alatnya, masing-masing dengan nama, deskripsi, dan argumen yang diterimanya, lalu klien memanggil sebuah alat saat model memintanya. Orvena adalah kliennya, yang berkomunikasi dengan setiap server lewat HTTPS langsung dari iPhone Anda.
Orvena hanya terhubung ke server jarak jauh lewat MCP streamable HTTP. Server stdio lokal, jenis yang dijalankan aplikasi desktop sebagai perintah, tidak bisa berjalan di dalam Orvena, jadi letakkan server itu di balik jembatan HTTPS jarak jauh dan tambahkan alamat jembatan tersebut.
Konektor yang tersedia di Orvena
Buka menu di kiri atas, lalu Pengaturan, lalu Koneksi (baris berjudul "Hubungkan layanan Anda"). Versi 2.0.0 mencantumkan enam layanan:
| Konektor | Cara masuk | Kegunaannya |
|---|---|---|
| Notion | OAuth | Mencari dan mengelola halaman, basis data, dan konten ruang kerja. |
| Linear | OAuth, baca dan tulis | Mencari dan mengelola isu, proyek, tim, dan data perencanaan. |
| GitHub | Kode sekali pakai, tanpa personal access token | Mencari dan mengelola repositori, kode, isu, dan pull request. |
| Jira & Confluence | OAuth, 13 cakupan, termasuk menulis pekerjaan Jira dan halaman Confluence | Mencari dan mengelola item kerja Jira serta ruang, halaman, dan komentar Confluence. |
| Zapier | Token koneksi | Memakai aplikasi dan tindakan yang dikonfigurasi di server Zapier MCP Anda. |
| Home Assistant | Token akses dan alamat HTTPS Anda | Memeriksa dan mengendalikan perangkat, entitas, adegan, dan otomatisasi yang disediakannya. |
Model membaca deskripsi ini untuk menentukan layanan mana yang dibutuhkan sebuah permintaan. Setiap server melaporkan alatnya sendiri setelah Anda masuk, dan barisnya menampilkan jumlahnya. Slack, Figma, Canva, Todoist, dan PayPal tidak tercantum karena saat ini Orvena belum bisa memenuhi persyaratan proses masuk mereka.
- Ketuk Hubungkan pada sebuah kartu. Tanpa Premium Unlock, tombolnya bertuliskan Premium dan membuka layar pembelian.
- Untuk Notion, Linear, dan Jira & Confluence, halaman masuk milik layanan itu terbuka di sebuah panel begitu server meminta Anda masuk. Setujui aksesnya di sana.
- Untuk GitHub, panel berjudul "Otorisasi Orvena" menampilkan kode sekali pakai. Ketuk "Salin kode dan buka GitHub", tempel kodenya, lalu setujui. Panel menampilkan "Menunggu otorisasi…" sampai GitHub mengonfirmasi.
- Layanan itu pindah ke daftar teratas, dan statusnya berubah dari "Menghubungkan…" menjadi jumlah alatnya.
Home Assistant MCP di iPhone, dan Zapier
Keduanya memakai token, bukan halaman masuk. Di Home Assistant, tambahkan integrasi "Model Context Protocol Server", lalu buat token di profil Anda, bagian Security (Keamanan), Long-lived access tokens (token akses jangka panjang). Di Orvena, ketuk Hubungkan pada Home Assistant, masukkan alamatnya di bawah "Di mana lokasinya?", misalnya https://your-home:8123/api/mcp, lalu tempel tokennya.
Di sini Orvena mewajibkan HTTPS, bahkan di jaringan Anda sendiri, sehingga token tidak akan dikirim ke alamat http://, seperti http://homeassistant.local:8123 atau alamat IP lokal lewat http://. Dengan alamat http://, tombol Hubungkan di panel tidak melakukan apa-apa. Home Assistant membutuhkan sertifikat TLS yang valid atau reverse proxy HTTPS yang tepercaya.
Zapier hanya meminta token: di mcp.zapier.com, buat server, pilih aplikasinya, lalu salin token koneksi dari tab Connect.
Cara menambahkan server MCP Anda sendiri
Kartu terakhir di Koneksi, "Server Anda sendiri", membuka "Server kustom". URL-nya harus memakai https:// dengan nama host dan tidak boleh berisi nama pengguna, kata sandi, atau #fragment. Server harus mendukung MCP streamable HTTP, menjawab dengan JSON biasa atau aliran SSE, dan mendukung versi protokol 2025-11-25, 2025-06-18, atau 2025-03-26. Pengalihan (redirect) harus tetap di origin yang sama, dan server yang tidak melaporkan alat apa pun tidak akan disimpan.
- Isi Nama dan kolom alamat, yang placeholder-nya https://server.example/mcp.
- Jika server memakai kunci API atau token, tempel ke "Bearer token (optional)". Jika dibiarkan kosong, Orvena mencoba akses terbuka, lalu proses masuk.
- Jika server OAuth tidak menyebutkan cakupan yang dibutuhkannya, masukkan cakupan itu di "OAuth scopes, space-separated (optional)" (cakupan OAuth, dipisahkan spasi).
- Di "Apa yang dapat dibantu server ini? (opsional)", tulis satu kalimat tentang kegunaannya.
- Ketuk "Tambah server". Tombolnya bertuliskan "Memeriksa…" selama Orvena terhubung dan mengambil daftar alat.
Orvena memulai OAuth hanya setelah menerima HTTP 401, 403, atau tantangan WWW-Authenticate, dan server otorisasinya harus mendukung PKCE dengan S256.
Orvena memakai kalimat tujuan itu hanya untuk memutuskan kapan server dimuat. Tanpa kalimat itu, Orvena menyusun ringkasan setiap server dari hingga empat deskripsi alat, dipotong menjadi 320 karakter. Jika ada alat yang tidak punya deskripsi, barisnya menampilkan "Add a purpose so Orvena can choose this server reliably." (tambahkan tujuan agar Orvena bisa memilih server ini dengan andal), dan jika tidak ada satu alat pun yang punya deskripsi, server hanya dipakai saat Anda menyebut namanya. Perbaiki dengan "Jelaskan tujuan" di menu ••• pada baris itu.
Apa yang membutuhkan Premium Unlock
Semua koneksi membutuhkannya, baik keenam layanan yang tercantum maupun server apa pun yang Anda tambahkan sendiri. Premium Unlock adalah pembelian satu kali seharga US$14,99 tanpa langganan, dan juga menambahkan Private Cloud Compute di iOS 27, model cloud dengan kunci OpenRouter Anda sendiri, percakapan suara, dan tugas terjadwal. Apple Intelligence dan model unduhan Orvena gratis, tetapi tanpa Premium Unlock keduanya menjawab tanpa alat konektor.
Menggunakan MCP dengan Apple Intelligence dan mesin lainnya
Keempat mesin di layar Model mendapatkan alat konektor. Untuk Apple Intelligence dan Private Cloud Compute, Orvena mengonversi skema JSON setiap alat MCP ke format skema framework Foundation Models milik Apple. Jika skema sebuah alat memakai sesuatu yang tidak bisa diekspresikan framework tersebut, model Apple menerima alat itu tanpa argumen, jadi gunakan model Orvena atau OpenRouter untuk alat tersebut. Model OpenRouter yang tercantum tanpa dukungan alat adalah pengecualian: "Model ini tidak dapat menggunakan alat, jadi Orvena akan menjawab tanpa alat."
| Mesin | Berjalan di | Jendela konteks | Hasil alat yang dilihat model |
|---|---|---|---|
| Apple Intelligence | iPhone ini, iOS 27 | Dibaca dari iOS saat aplikasi berjalan: 8.192 token di iOS 27 dalam pengujian, meskipun dokumentasi Apple menyebut 4.096 | Hingga 2.400 karakter |
| Model Orvena | iPhone ini (Qwen 3.5 4B, 3,1 GB) | 16.384 token | Hingga 4.000 karakter |
| Private Cloud Compute | Server Apple, iOS 27, Premium | 32.768 token | Hingga 4.000 karakter |
| OpenRouter | OpenRouter, kunci Anda sendiri, Premium | Panjang yang tercantum untuk model itu, 60.000 jika tidak diketahui, paling banyak 120.000 | Hingga 4.000 karakter |
Otomatis, pengaturan mesin default, tidak pernah memilih Private Cloud Compute atau OpenRouter dengan sendirinya.
Cara daftar alat dan hasilnya muat di jendela yang kecil
Jendela 8.192 token tidak punya banyak ruang untuk puluhan definisi alat, jadi alat konektor tidak pernah dikirim ke model sekaligus. Model pertama-tama memanggil load_connectors untuk memilih satu atau dua layanan dari daftar layanan yang terhubung, masing-masing dideskripsikan dalam paling banyak 180 karakter (8.192 karakter secara keseluruhan). Lalu load_tools memilih satu sampai delapan operasi dari layanan tersebut. Hanya operasi itulah yang bisa dipanggil.
Sebelum setiap putaran model, Orvena menjumlahkan instruksi, skema alat yang dimuat, dan cadangan ruang 900 token. Jika totalnya melebihi jendela dikurangi 512 token, Orvena membuang alat konektor, mulai dari yang paling baru, kecuali alat yang masih harus dipanggil oleh permintaan itu, lalu skill yang paling lama. Jika operasi yang dibutuhkan masih tidak muat, giliran itu berhenti dengan "The required connector operation is too large for this model's context window." (operasi konektor yang dibutuhkan terlalu besar untuk jendela konteks model ini).
Deskripsi alat dipotong menjadi 500 karakter, dan hasilnya ditandai sebagai data tak tepercaya, yang memberi tahu model untuk memperlakukan teks dari sebuah halaman atau isu sebagai konten, bukan instruksi. Hasil yang melebihi batas akan dipadatkan: kolom paginasi didahulukan, tautan dan hash panjang dibuang, objek dalam daftar menyimpan paling banyak 12 kolom, dan string panjang dipersingkat, disertai catatan yang memberi tahu model tentang hal itu.
Dalam percakapan panjang, Orvena mempertahankan giliran terbaru secara utuh dalam jendela mesin dan membuang giliran yang paling lama. Orvena tidak meringkasnya. Jika itu pun tidak muat, Apple Intelligence menampilkan "Percakapan ini terlalu panjang untuk Apple Intelligence. Mulai percakapan baru, atau beralih ke model Orvena yang sudah diunduh di layar Model."
Persetujuan sebelum ada yang berubah atau keluar
Orvena mengklasifikasikan setiap alat MCP berdasarkan petunjuk (hint) yang dideklarasikan servernya: alat baca saja menampilkan "Membaca data tanpa mengubahnya.", alat destruktif "Menghapus, membatalkan, atau melakukan tindakan yang tidak dapat dibatalkan.", dan sisanya "Membuat atau mengubah data."
- Alat baca dan tulis bertanya saat pertama kali dipakai. Panelnya, berjudul "SETUJUI TINDAKAN INI", memiliki "Jangan izinkan" dan "Izinkan", dengan "Izinkan sekali" atau "Selalu izinkan" di menunya.
- Alat destruktif bertanya setiap kali, hanya dengan "Izinkan sekali".
- Panel itu mencantumkan argumen persisnya, dengan token, kata sandi, dan kolom lain yang mirip kredensial ditampilkan sebagai [REDACTED CREDENTIAL], dan menyebutkan ke mana data itu dikirim, misalnya "Mengirim data yang diperlukan untuk tindakan ini ke Notion."
- Jika giliran yang sama sudah membaca sesuatu yang bersifat pribadi, seperti kalender Anda atau hasil konektor lain, persetujuannya berjudul "Send data to" (kirim data ke) diikuti nama layanannya. Setelah data Kesehatan, Orvena bertanya setiap kali.
Private Cloud Compute bertanya satu kali, saat Anda memilihnya di Model, dan menyebutkan bahwa setiap jawaban mengirim "percakapan Anda, beserta hasil alat yang diperlukan, ke server Apple." Persetujuan konektor kemudian menampilkan "Notion → Private Cloud Compute" sebagai tujuan. OpenRouter bertanya sebelum permintaan pertama dalam sebuah percakapan, lalu bertanya lagi dengan "Gunakan OpenRouter dengan data sensitif?" begitu ada hasil konektor dalam riwayat. Izin yang tersimpan ada di Pengaturan, Berbagi data, tempat Anda bisa mencabutnya.
Ke mana data dikirim
Lalu lintas konektor berjalan dari iPhone langsung ke layanannya, tanpa server Orvena di antaranya. Layanan dan server masuknya menerima argumen yang Anda setujui, konten yang dikembalikannya, dan lalu lintas proses masuk. Token tetap berada di Rantai Kunci iPhone, hanya di perangkat ini. Dengan Apple Intelligence atau model Orvena, hasilnya dibaca di ponsel; dengan Private Cloud Compute, hasil yang dibutuhkan sebuah jawaban dikirim ke Apple, dan dengan OpenRouter ke OpenRouter setelah Anda menyetujuinya. Pengaturan, Aktivitas menyimpan nama alat, hasil akhirnya, dan tujuannya hingga 30 hari, tetapi tidak pernah argumennya. Tombol Putuskan menghapus kredensial dan alat lokal, dan konfirmasinya mengingatkan Anda untuk juga mencabut akses di layanan itu, misalnya "Anda mungkin masih perlu mencabut Orvena di pengaturan akun Notion." Gambaran yang lebih luas ada di apa yang membuat asisten AI benar-benar privat.
Pemecahan masalah
| Yang Anda lihat | Yang perlu diperiksa |
|---|---|
| "Enter a complete HTTPS server URL." (masukkan URL server HTTPS yang lengkap) | Awali alamat dengan https:// dan sertakan nama host. |
| "Server mengembalikan respons yang tidak dapat digunakan Orvena." | Hapus bagian user:password@ dan apa pun setelah # dari alamat. Jika alamatnya sudah bersih, server mengirim respons yang tidak dapat dibaca Orvena. |
| "Couldn't reach the server. Check your connection and server address." (server tidak dapat dijangkau; periksa koneksi dan alamat server) | Alamat, DNS, dan sertifikat TLS, dari lokasi ponsel saat itu. |
| "Server menolak sambungan ini. Periksa info masuk atau tokennya." | Periksa tokennya, atau buat token baru dan hubungkan lagi. |
| "This server doesn't support compatible sign-in. Use a token if it offers one." (server ini tidak mendukung proses masuk yang kompatibel; gunakan token jika tersedia) | Tempel token ke "Bearer token (optional)". |
| "Perlu masuk" atau "Koneksi gagal" | Hubungkan ulang atau Coba lagi di menu •••. |
| "The latest tool result is too large for this model's context window. Try a narrower request." (hasil alat terakhir terlalu besar untuk jendela konteks model ini; persempit permintaan Anda) | Minta satu halaman atau satu isu saja, atau pilih mesin dengan jendela yang lebih besar. |
| "Tindakan mungkin sudah selesai. Periksa layanan sebelum mencoba lagi." | Periksa di layanan itu sebelum mengulangi tindakan. |
| "Pemulihan tindakan jarak jauh perlu ditinjau" | Tindakan jarak jauh baru dijeda. Periksa setiap layanan, lalu ketuk "Saya sudah memeriksa setiap tujuan". |
Pertanyaan umum
Bisakah saya menjalankan server MCP di iPhone?
Tidak di dalam Orvena. Orvena adalah klien MCP yang terhubung ke server jarak jauh lewat HTTPS menggunakan MCP streamable HTTP. Server stdio lokal tidak bisa berjalan di dalam Orvena, jadi jalankan server itu di tempat lain di balik jembatan HTTPS dan tambahkan alamatnya di Server Anda sendiri.
Bisakah Apple Intelligence menggunakan alat MCP?
Di Orvena, bisa. Di iOS 27, Orvena memberikan alat dari server yang Anda hubungkan kepada model Apple di perangkat dan Private Cloud Compute, setelah dikonversi ke format framework Foundation Models milik Apple. Pada satu waktu, Orvena hanya memuat satu atau dua layanan dan paling banyak delapan operasinya, sehingga definisi alat tetap cukup kecil untuk jendela konteks di perangkat.
Bagaimana cara menghubungkan Home Assistant ke asisten AI di iPhone lewat MCP?
Tambahkan integrasi Model Context Protocol Server di Home Assistant dan buat token akses jangka panjang (long-lived access token) di profil Anda, bagian Security. Di Orvena, ketuk Hubungkan pada Home Assistant, masukkan alamat HTTPS yang berakhiran /api/mcp, lalu tempel tokennya. Alamat http biasa ditolak, termasuk di jaringan rumah Anda.
Bisakah saya memakai server MCP Notion di iPhone?
Bisa. Notion adalah salah satu dari enam konektor yang tercantum di Orvena. Ketuk Hubungkan di Pengaturan, Koneksi, masuk ke Notion, lalu setujui aksesnya. Orvena memakai server yang dihosting Notion di mcp.notion.com dan meminta izin sebelum alat Notion dijalankan untuk pertama kalinya. Koneksi termasuk dalam Premium Unlock.
Apakah setiap tindakan MCP meminta persetujuan?
Tindakan destruktif bertanya setiap kali. Alat yang membaca, membuat, atau mengubah data bertanya saat pertama kali dipakai, dan Anda bisa memilih Selalu izinkan. Izin itu tercantum di Pengaturan, Berbagi data, Alat yang diizinkan, tempat Anda bisa mencabutnya.
Orvena gratis di App Store untuk iPhone 15 Pro dan yang lebih baru. Premium Unlock, satu kali pembelian, menambahkan enam konektor yang tercantum dan server MCP apa pun yang Anda tambahkan.
Unduh di App Store