Pengaturan Xcode | Weegloo Docs

Xcode dapat menjalankan agen coding seperti Claude Code atau Codex di dalam layarnya sendiri. Jika Anda menghubungkan server MCP WEEGLOO ke sini, agen yang berjalan di dalam Xcode dapat langsung membuat, membaca, dan mengubah resource seperti Content Type, Content, dan Media. Alat instalasi turut memasang Skills dan Rules bersama server MCP, sehingga membantu agen menggunakan WEEGLOO API sesuai cara yang dimaksudkan. Skills adalah panduan yang berisi cara melakukan tugas tertentu dengan baik, sedangkan Rules adalah aturan yang harus dipatuhi di sepanjang pekerjaan. Pilih agen yang akan dipakai di dalam Xcode di bawah, lakukan pengaturan sekaligus dengan alat instalasi, lalu selesaikan autentikasi koneksi MCP.

Detail tentang server MCP serta Skills dan Rules masing-masing dibahas di halaman MCP dan Skills dan Rules. Halaman ini hanya membahas cara menghubungkan ke Xcode.

Yang perlu disiapkan

Untuk menjalankan perintah instalasi di bawah, Anda memerlukan Node.js. Pertama, periksa apakah Node.js sudah terpasang dan apakah versinya 18 atau lebih baru dengan perintah berikut.

Terminal

node --version # OK jika v18 atau lebih baru npx --version # OK jika versinya tampil

Jika Node.js sudah terpasang tetapi npx belum, perbarui npm ke versi terbaru dengan perintah di bawah. Saat npm diperbarui, npx pun ikut terpasang.

Terminal

npm install -g npm@latest

Jika Node.js belum terpasang atau versinya terlalu lama, pasang Node.js dengan cara yang sesuai untuk sistem operasi yang Anda gunakan.

Terminal

brew install node

Jika belum ada Homebrew, pasang dulu dari brew.sh, atau unduh Node.js langsung dari nodejs.org.

Terminal

winget install OpenJS.NodeJS.LTS

Jika winget tidak ada atau tidak dikenali, unduh berkas instalasi LTS dari nodejs.org. Setelah dipasang, Anda perlu membuka terminal baru.

Paket bawaan distribusi bisa jadi versi lama, jadi disarankan memasang dengan nvm yang dapat dipakai di berbagai distribusi.

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

Untuk mengunduh berkas instalasi secara langsung, lihat di nodejs.org.

Xcode juga harus sudah terpasang. Jika belum ada, Anda dapat mengunduhnya dari Unduh Xcode.

Menghubungkan

Instalasi dasar cukup dengan menyalin perintah instalasi di halaman ini dan menjalankannya sekali di terminal. Untuk memilih sendiri setiap langkah proses instalasi, buka Instalasi khusus. Koneksi Xcode selalu dipasang pada proyek saat ini, jadi perintah instalasi dijalankan di dalam folder proyek yang ingin dihubungkan.

Alat coding

Pasang MCP · Skills

Salin perintah instalasi lalu jalankan di terminal. Anda harus menjalankannya di dalam folder proyek yang ingin dihubungkan.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --location project \ --token <Personal Access Token>

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Jalankan Claude Code di terminal. Anda harus menjalankannya di dalam folder proyek yang ingin dihubungkan.

Terminal
claude
Saat pertama kali dijalankan, Anda mungkin ditanya apakah ingin mengaktifkan server MCP baru. Jika demikian, pastikan weegloo dan weegloo-upload dalam keadaan tercentang, lalu tekan Enter untuk mengirim.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Ketik /mcp untuk membuka layar pengelolaan server MCP.

Terminal
/mcp
Pilih weegloo dari daftar. Statusnya ditampilkan sebagai needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Jika server tidak muncul di daftar: Jika weegloo dan weegloo-upload tidak muncul di daftar, mungkin Anda belum mengirim di layar aktivasi pada langkah 2 atau statusnya dinonaktifkan. Tutup Claude Code, ketik perintah di bawah pada terminal, lalu jalankan claude lagi. Jika layar yang sama seperti langkah 2 muncul kembali, pastikan weegloo dan weegloo-upload tercentang, lalu tekan Enter untuk mengirim.
Terminal
claude mcp reset-project-choices
Pastikan alamat koneksi adalah https://ai.weegloo.com/mcp, lalu pilih Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Jika Anda memilih Authenticate, halaman autentikasi WEEGLOO seperti di bawah akan terbuka di browser. Salin token dengan tombol Salin token, tempelkan, lalu klik Hubungkan Server. Selesai ketika weegloo berubah menjadi connected.

Anda perlu membuka sesi Xcode Agent yang baru setelah instalasi agar pengaturan diterapkan.

Pasang MCP · Skills

Salin perintah instalasi lalu jalankan di terminal. Anda harus menjalankannya di dalam folder proyek yang ingin dihubungkan.

Terminal

$ npx weegloo@latest -y \ --agent codex \ --host xcode \ --location project \ --token <Personal Access Token>

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Saat Anda menjalankan perintah di bawah pada terminal, halaman autentikasi WEEGLOO akan terbuka di browser.

Terminal
codex mcp login weegloo
Pada halaman autentikasi WEEGLOO yang terbuka, salin token dengan tombol Salin token di bawah, tempelkan, lalu klik Hubungkan Server. Agen yang sudah berjalan perlu dimulai ulang setelah autentikasi selesai agar diterapkan.

Anda perlu membuka sesi Xcode Agent yang baru setelah instalasi agar pengaturan diterapkan.

Jalankan npx weegloo secara interaktif, lalu pasang sambil memilih sendiri item yang ditanyakan.

Alat coding

Menjalankan alat instalasi

Pindah ke folder proyek yang ingin Anda hubungkan, lalu jalankan perintah di bawah di folder tersebut dan pilih item yang ditanyakan satu per satu. Pada tempat yang menanyakan token, salin token dengan tombol Salin token di bawah lalu tempelkan. Pastikan menjalankannya di dalam folder proyek tersebut.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token yang disalin ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Jalankan Claude Code di terminal. Anda harus menjalankannya di dalam folder proyek yang ingin dihubungkan.

Terminal
claude
Saat pertama kali dijalankan, Anda mungkin ditanya apakah ingin mengaktifkan server MCP baru. Jika demikian, pastikan weegloo dan weegloo-upload dalam keadaan tercentang, lalu tekan Enter untuk mengirim.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Ketik /mcp untuk membuka layar pengelolaan server MCP.

Terminal
/mcp
Pilih weegloo dari daftar. Statusnya ditampilkan sebagai needs authentication.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

Jika server tidak muncul di daftar: Jika weegloo dan weegloo-upload tidak muncul di daftar, mungkin Anda belum mengirim di layar aktivasi pada langkah 2 atau statusnya dinonaktifkan. Tutup Claude Code, ketik perintah di bawah pada terminal, lalu jalankan claude lagi. Jika layar yang sama seperti langkah 2 muncul kembali, pastikan weegloo dan weegloo-upload tercentang, lalu tekan Enter untuk mengirim.
Terminal
claude mcp reset-project-choices
Pastikan alamat koneksi adalah https://ai.weegloo.com/mcp, lalu pilih Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Jika Anda memilih Authenticate, halaman autentikasi WEEGLOO seperti di bawah akan terbuka di browser. Salin token dengan tombol Salin token, tempelkan, lalu klik Hubungkan Server. Selesai ketika weegloo berubah menjadi connected.

Anda perlu membuka sesi Xcode Agent yang baru setelah instalasi agar pengaturan diterapkan.

Menjalankan alat instalasi

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← token yang disalin ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Saat Anda menjalankan perintah di bawah pada terminal, halaman autentikasi WEEGLOO akan terbuka di browser.

Terminal
codex mcp login weegloo
Pada halaman autentikasi WEEGLOO yang terbuka, salin token dengan tombol Salin token di bawah, tempelkan, lalu klik Hubungkan Server. Agen yang sudah berjalan perlu dimulai ulang setelah autentikasi selesai agar diterapkan.

Anda perlu membuka sesi Xcode Agent yang baru setelah instalasi agar pengaturan diterapkan.

File konfigurasi server MCP

Alat instalasi membuat dan mengelola file konfigurasi secara otomatis, jadi Anda tidak perlu memeriksanya secara langsung. Isi di bawah ini adalah bahan referensi untuk pengguna yang membutuhkan struktur dan path file konfigurasi yang konkret.

Alat instalasi mendaftarkan server ke file konfigurasi agen yang Anda pilih untuk dipakai di dalam Xcode. Koneksi Xcode selalu dipasang pada proyek saat ini, jadi file-nya pun dibuat di dalam folder proyek. File berbeda tergantung agen yang Anda pilih.

Claude Code: .mcp.json di folder proyek (formatnya sama seperti Pengaturan Claude Code)
Codex: .codex/config.toml di folder proyek (formatnya sama seperti Pengaturan Codex)

Hanya ada satu perbedaan saat dipakai di dalam Xcode. Pada env server weegloo-upload yang menangani file, item PATH turut disertakan. Xcode menjalankan agen dengan PATH yang minimal, sehingga tanpa item ini server tidak dapat menemukan npx yang diperlukan untuk menjalankannya. Untuk Claude Code (.mcp.json), bentuknya seperti berikut.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

Pada PATH ini, lokasi Node saat instalasi dijalankan tertanam apa adanya. Jika Anda menaikkan Node ke versi baru, jalur ini menjadi tidak cocok, jadi setelah memutakhirkan, jalankan kembali alat instalasi untuk memperbarui nilainya.

Skills dan Rules

Skills dan Rules juga mengikuti cara agen yang Anda pilih. Untuk lokasi selengkapnya, lihat bagian Skills dan Rules pada Pengaturan Claude Code dan Pengaturan Codex.

Langkah berikutnya

MCP: membahas hal-hal yang menjadi dasar koneksi, seperti grup server dan server unggah file.
Skills dan Rules: membahas apa itu Skills dan Rules yang turut dipasang oleh alat instalasi.
Menjaga tetap terbaru: membahas cara menyelaraskan Skills dan Rules yang telah dipasang ke versi terbaru.
Memindahkan halaman statis dengan AI: mengikuti alur memindahkan halaman nyata menjadi layanan berbasis konten dengan MCP yang telah dihubungkan.