Pengaturan Xcode

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. Pilih agen yang akan Anda pakai di dalam Xcode di bawah, lakukan pengaturan sekaligus dengan alat instalasi, lalu cukup selesaikan autentikasi.

Penjelasan tentang MCP itu sendiri, grup server, dan server unggah file dibahas di MCP. Halaman ini hanya membahas langkah-langkah untuk menghubungkan ke Xcode.

Yang perlu disiapkan

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

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

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

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

Menghubungkan

Pilih agen yang akan Anda pakai di dalam Xcode, lalu ikuti panduan berikut. Koneksi Xcode selalu dipasang pada proyek saat ini, jadi jalankan perintah instalasi di dalam folder proyek yang ingin Anda hubungkan.

Agen yang digunakan di XcodeClaude Code

1

Pasang MCP · Skills

Salin perintah pemasangan lalu jalankan di terminal. Pastikan menjalankannya di dalam folder proyek yang ingin Anda hubungkan.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --token wgl_••••••••••••

Salin perintah

2

Autentikasi MCP

Lakukan autentikasi dengan urutan di bawah.

1. 1.Jalankan Claude Code di terminal. Pastikan menjalankannya di dalam folder proyek yang ingin Anda hubungkan.
   Terminal

   claude
2. 2.Saat pertama dijalankan, Claude Code mungkin menanyakan server MCP baru mana yang akan diaktifkan. Jika muncul, pastikan weegloo dan weegloo-upload tercentang, lalu tekan Enter untuk mengirim.
   Terminal

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

   /mcp
4. 4.Pilih weegloo di daftar. 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 mengirimkannya di layar pengaktifan pada langkah 2, atau keduanya dinonaktifkan. Tutup Claude Code, ketik perintah di bawah di terminal, lalu jalankan claude lagi. Saat 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
5. 5.Pastikan URL-nya 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
6. 6.Saat memilih Authenticate, halaman autentikasi WEEGLOO seperti di bawah terbuka di browser. Salin token dengan tombol Salin token, tempelkan, lalu klik Hubungkan Server. Saat weegloo menjadi connected, selesai.

Salin token

Setelah pemasangan, buka sesi Xcode Agent yang baru agar konfigurasinya diterapkan.

Memeriksa file konfigurasi secara langsung

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.

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.
• Memindahkan halaman statis dengan AI: mengikuti alur memindahkan halaman nyata menjadi layanan berbasis konten dengan MCP yang telah dihubungkan.