Pengaturan Claude

Di dalam Claude Desktop terdapat Claude Code, agen coding, sebagai tab Code. Server MCP WEEGLOO dihubungkan dan digunakan melalui tab Code ini. Melalui koneksi ini, agen pada tab Code 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 pada tab Code 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. Lakukan pengaturan sekaligus dengan alat instalasi, selesaikan autentikasi dengan /mcp dari claude, lalu langsung bisa digunakan di tab Code.

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 tab Code pada Claude Desktop.

Tab Code pada Claude Desktop berjalan dengan Claude Code. WEEGLOO pun terhubung melalui tab Code, dengan pengaturan MCP, Skills, dan Rules yang sama seperti Claude Code. Claude Code harus sudah terpasang agar perintah claude dapat dijalankan di terminal. Jika belum ada, lihat panduan instalasi Claude Code.

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.

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.

Lokasi instalasi
1

Pasang MCP · Skills

Salin perintah instalasi lalu jalankan di terminal.

Terminal
$ npx weegloo@latest -y \ --agent claude \ --token <Personal Access Token>
2

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Langkah ini memerlukan Claude Code CLI (claude). Jika belum ada, pasang Claude Code.

  1. Jalankan Claude Code di terminal.

    Terminal
    claude

  2. Ketik /mcp untuk membuka layar pengelolaan server MCP.

    Terminal
    /mcp

  3. Pilih weegloo dari daftar. Statusnya ditampilkan sebagai needs authentication.

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

  4. 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

  5. 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.

    Layar autentikasi WEEGLOO

1

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 \ --location project \ --token <Personal Access Token>
2

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Langkah ini memerlukan Claude Code CLI (claude). Jika belum ada, pasang Claude Code.

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

    Terminal
    claude

  2. 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

  3. Ketik /mcp untuk membuka layar pengelolaan server MCP.

    Terminal
    /mcp

  4. 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

  5. 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

  6. 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.

    Layar autentikasi WEEGLOO

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

Lokasi instalasi
1

Menjalankan alat instalasi

Jalankan perintah di bawah pada terminal, lalu pilih item yang ditanyakan satu per satu. Pada tempat yang menanyakan token, salin token dengan tombol Salin token di bawah lalu tempelkan.

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? Global … ✔ Installation complete!
2

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Langkah ini memerlukan Claude Code CLI (claude). Jika belum ada, pasang Claude Code.

  1. Jalankan Claude Code di terminal.

    Terminal
    claude

  2. Ketik /mcp untuk membuka layar pengelolaan server MCP.

    Terminal
    /mcp

  3. Pilih weegloo dari daftar. Statusnya ditampilkan sebagai needs authentication.

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

  4. 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

  5. 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.

    Layar autentikasi WEEGLOO

1

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!
2

Autentikasi MCP

Lakukan autentikasi sesuai urutan berikut.

Langkah ini memerlukan Claude Code CLI (claude). Jika belum ada, pasang Claude Code.

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

    Terminal
    claude

  2. 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

  3. Ketik /mcp untuk membuka layar pengelolaan server MCP.

    Terminal
    /mcp

  4. 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

  5. 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

  6. 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.

    Layar autentikasi WEEGLOO

File konfigurasi server MCP

Tab Code menggunakan pengaturan MCP, Skills, dan Rules milik Claude Code apa adanya. Karena itu, server yang terhubung tidak muncul di layar connector, plugin, maupun MCP pada Claude Desktop, dan hanya dapat dipakai di tab Code. Untuk memeriksa server yang terpasang, jalankan claude di terminal lalu ketik /mcp. .mcp.json di bawah juga dibuat dan dikelola secara otomatis oleh alat instalasi sehingga jarang perlu dibuka langsung. Isi konfigurasi di bawah ini adalah bahan referensi untuk pengguna yang membutuhkan struktur dan path file konfigurasi yang konkret.

Server weegloo terhubung ke https://ai.weegloo.com/mcp dengan metode HTTP, sedangkan server weegloo-upload yang menangani file dijalankan dengan npx dan menggunakan Personal Access Token untuk autentikasi.

{
  "mcpServers": {
    "weegloo": {
      "type": "http",
      "url": "https://ai.weegloo.com/mcp"
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

Untuk mengubah grup server, tambahkan nilai group di akhir url server weegloo. Misalnya, untuk menggunakan semua tool, tulis https://ai.weegloo.com/mcp?group=all. Untuk komposisi tool per grup, lihat Grup server MCP.

Skills

Claude Code mendukung Skills sebagai fitur bawaan. Alat instalasi menyusun setiap Skill sebagai satu direktori. Instalasi global memakai ~/.claude/skills/, sedangkan instalasi proyek memakai .claude/skills/ di dalam folder proyek.

Rules

Claude Code mendukung Rules sebagai fitur bawaan. Alat instalasi menyusun setiap aturan sebagai satu file .md. Instalasi global memakai ~/.claude/rules/, sedangkan instalasi proyek memakai .claude/rules/ di dalam folder proyek.

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.