Weegloo Docs - Penyiapan lingkungan lainnya

Banyak alat yang mendukung MCP. Alat seperti Claude, Claude Code, Codex, dan Cursor memiliki halaman panduan khusus tersendiri, sedangkan halaman ini membahas cara umum untuk menghubungkan WEEGLOO MCP secara langsung ke alat pendukung MCP lainnya.

Server dan alamat yang dihubungkan sama di semua alat. Namun, untuk menuliskan informasi itu ke dalam konfigurasi, format dan nama kuncinya berbeda-beda di setiap alat. Karena itu, halaman ini tidak menjelaskan format konfigurasi alat tertentu, melainkan menjelaskan "apa yang dihubungkan" dari sudut pandang protokol MCP. Untuk lokasi dan format file konfigurasi yang sebenarnya, periksa juga dokumentasi alat yang ingin Anda hubungkan.

Setelah terhubung, agen LLM dari alat tersebut menggantikan pekerjaan yang biasanya dilakukan orang di studio konten hanya dengan permintaan bahasa alami. Jika Anda menjelaskan dengan kata-kata apa yang ingin Anda buat, agen akan langsung menangani pekerjaan seperti merancang Content Type dan membuat Content atau Media.

Prasyarat

Node.js 18 atau lebih baru: Diperlukan untuk menjalankan server transfer file (weegloo-upload) secara lokal. Anda bisa mengunduhnya di unduh Node.js.
Alat yang mendukung MCP: Alat apa pun yang bisa mendaftarkan server MCP ke konfigurasinya dapat dihubungkan dengan cara yang sama. Periksa lokasi dan format file konfigurasi di dokumentasi alat tersebut.

Dua server dan metode transport

WEEGLOO menyediakan dua server MCP, dan keduanya memakai metode transport yang berbeda. Ada dua cara utama bagi klien MCP untuk terhubung ke server, dan kedua server WEEGLOO masing-masing memakai salah satunya.

weegloo: Server utama untuk membuat, membaca, mengubah, dan menghapus resource. Ini adalah server HTTP jarak jauh yang memakai transport Streamable HTTP dari MCP. Klien terhubung hanya dengan satu alamat endpoint https://ai.weegloo.com/mcp, dan autentikasi ditangani lewat OAuth (lihat Autentikasi di bawah). Kumpulan tool yang bisa dipakai ditentukan oleh nilai ?group= yang ditambahkan di akhir alamat (lihat MCP).
weegloo-upload: Server untuk menangani file, seperti mengunggah Media atau men-deploy Web Hosting. Ini adalah server yang berjalan secara lokal yang memakai transport stdio dari MCP. Klien langsung menjalankan proses server dengan perintah npx -y weegloo-upload dan berkomunikasi lewat standard input/output. Menjalankannya memerlukan Node.js, dan autentikasi dilakukan dengan Personal Access Token yang dimasukkan ke dalam environment variable.

Sebagian besar alat mendaftarkan kedua server dalam satu file konfigurasi.

Autentikasi

Kedua server juga berbeda dalam cara autentikasinya.

weegloo (HTTP jarak jauh): Diautentikasi dengan OAuth standar MCP. Anda tidak memasukkan token ke dalam file konfigurasi.
weegloo-upload (stdio lokal): Tanpa OAuth, Anda langsung memasukkan Personal Access Token ke dalam environment variable AUTH_BEARER_TOKEN.

Server weegloo terhubung dengan cara jarak jauh, dan autentikasinya ditangani lewat OAuth standar MCP. Alurnya adalah sebagai berikut.

Saat alat pertama kali terhubung ke server weegloo, halaman autentikasi WEEGLOO terbuka di browser.
Tempelkan Personal Access Token yang Anda terbitkan di bawah ke halaman itu, lalu setujui koneksinya, maka autentikasi selesai.

Karena ini cara standar MCP, pada alat terbaru yang mendukung OAuth autentikasi ini berlangsung otomatis begitu Anda mendaftarkan alamat server saja.

Halaman autentikasi WEEGLOO yang terbuka di browser saat koneksi pertama tampak seperti berikut.

Layar autentikasi WEEGLOO

Terbitkan Personal Access Token terlebih dahulu dengan tombol di bawah. Tempelkan ke halaman autentikasi di atas, dan gunakan token yang sama untuk AUTH_BEARER_TOKEN pada weegloo-upload.

Token hanya diterbitkan pada saat Anda menekan tombol salin, dan bisa Anda cabut kapan saja di Weegloo Console. Karena token asli tersimpan apa adanya di dalam file konfigurasi, berhati-hatilah agar tidak mempublikasikan file ini ke luar atau mengunggahnya ke repositori bersama.

Contoh konfigurasi

Informasi yang diperlukan saat memindahkan setiap server ke konfigurasi alat adalah sebagai berikut.

weegloo (HTTP jarak jauh): Penanda bahwa transport-nya HTTP dan alamat endpoint https://ai.weegloo.com/mcp.
weegloo-upload (stdio lokal): Perintah eksekusi npx dan argumen -y weegloo-upload, serta environment variable UPLOAD_API_URL dan AUTH_BEARER_TOKEN.

Untuk menyimpan informasi ini, nama kunci dan format file-nya berbeda di setiap alat. Di bawah ini contoh format .mcp.json milik Claude Code. Pada alat lain nama kuncinya bisa berbeda, jadi biarkan nilainya tetap sama dan pindahkan sesuai format alat tersebut.

{
  "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>"
      }
    }
  }
}

Di posisi <Personal Access Token> pada AUTH_BEARER_TOKEN, masukkan token yang Anda salin di atas. Kunci untuk menuliskan alamat server weegloo jarak jauh secara khusus berbeda-beda di tiap alat. Beberapa contohnya adalah sebagai berikut.

Alat	Format konfigurasi	Kunci alamat `weegloo` jarak jauh
Claude Code · Cursor	JSON	`type: "http"` + `url`
Codex	TOML	`url`
Antigravity	JSON	`serverUrl`
Android Studio	JSON	`httpUrl`

Server weegloo-upload lokal sebagian besar memakai kunci command, args, dan env dengan nama yang sama seperti contoh di atas. Namun, di Windows ada juga alat yang mengharuskan command ditulis sebagai cmd dan args sebagai ["/c", "npx", "-y", "weegloo-upload"].

Setelah menyimpan konfigurasi, perubahan baru berlaku setelah Anda memulai ulang alat atau memuat ulang konfigurasi MCP. Jika perlu, ubah kumpulan tool yang bisa dipakai dengan menambahkan grup seperti ?group=all di akhir alamat weegloo (lihat MCP).

Memverifikasi koneksi

Setelah memulai ulang alat, jika tool dari kedua server muncul di daftar tool MCP pada alat tersebut, berarti koneksi sudah berhasil.

weegloo: Muncul tool-tool yang menangani resource. Karena ini server HTTP jarak jauh, saat pertama kali terhubung halaman autentikasi WEEGLOO terbuka di browser. Ikuti petunjuk di layar dan tempelkan token yang Anda salin sebelumnya untuk menyelesaikan autentikasi.
weegloo-upload: Muncul tool-tool yang menangani file.

Setelah terhubung, Anda cukup meminta agen alat tersebut untuk membuat Space atau Content Type.

Yang bisa Anda lakukan

Setelah terhubung, agen LLM dapat langsung melakukan pekerjaan berikut.

Membuat, membaca, mengubah, dan menghapus resource seperti Organization, Space, Content Type, Content, dan Media
Men-deploy situs web statis yang sudah dibangun ke Web Hosting

Langkah selanjutnya

MCP: Membahas gambaran lengkap koneksi, seperti grup server dan server weegloo-upload.
Menerbitkan Personal Access Token: Membahas cara menerbitkan token yang akan dipakai untuk koneksi.
Memindahkan halaman statis dengan AI: Mengikuti alur memindahkan halaman nyata menjadi layanan berbasis konten dengan MCP yang telah dihubungkan.