Model Context Protocol (MCP)v0.4.2

Asisten AI & Konfigurasi MCP

Hubungkan Cloudizero langsung ke agen AI Anda (Claude Desktop, Cursor, Antigravity, Windsurf) untuk mengotomasi ingesti aset, penataan folder, dan alur kerja pengiriman bebas biaya egress.

Eksekusi Stdio Tanpa Instalasi Manual

Cloudizero MCP didistribusikan sebagai eksekusi Node instan melalui npx @cloudizero/mcp. Klien AI Anda menjalankannya sebagai background worker stdio tanpa perlu clone atau build repositori manual.

Memilih Cakupan Kunci API yang Tepat

Saat membuat kunci API di Pengaturan > Kunci API, pilih cakupan sesuai dengan peran agen AI Anda:

Semua Proyek (Akses Global)

Paling cocok untuk: Orkestrasi Umum Akun & Pengaturan Awal.

Dapat membuat proyek baru (cloudizero_create_project)
Dapat melihat dan menelusuri seluruh proyek di akun Anda
Manajemen unggah media dan folder menyeluruh antar proyek

Pilih Proyek Tertentu (Scoped)

Paling cocok untuk: Repositori Aplikasi & Lingkungan Produksi (Prinsip Least Privilege).

Terisolasi ketat hanya pada proyek yang dipilih
Memblokir upaya pembuatan proyek dengan pesan galat deskriptif 403
Mencegah AI melihat atau mengubah aset klien lain yang tidak relevan

Konfigurasi Klien AI

1. Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{
  "mcpServers": {
    "cloudizero": {
      "command": "npx",
      "args": ["-y", "@cloudizero/mcp"],
      "env": {
        "CLOUDIZERO_API_KEY": "cz_live_your_actual_api_key_here"
      }
    }
  }
}

2. Cursor IDE

Tambahkan ke .cursor/mcp.json di root proyek atau pengaturan Cursor:

json

{
  "mcpServers": {
    "cloudizero": {
      "command": "npx",
      "args": ["-y", "@cloudizero/mcp"],
      "env": {
        "CLOUDIZERO_API_KEY": "cz_live_your_actual_api_key_here"
      }
    }
  }
}

3. Google Antigravity / Gemini CLI

Tambahkan ke file mcp.json global atau level proyek Anda:

json

{
  "mcpServers": {
    "cloudizero": {
      "command": "npx",
      "args": ["-y", "@cloudizero/mcp"],
      "env": {
        "CLOUDIZERO_API_KEY": "cz_live_your_actual_api_key_here"
      }
    }
  }
}

Tool MCP yang Tersedia

Daftar tools Model Context Protocol yang dapat dieksekusi oleh model AI:

Nama Tool	Deskripsi	Parameter
cloudizero_list_projects	Mendaftar seluruh proyek yang dapat diakses oleh kunci API, dengan opsi filter berdasarkan ID workspace.	workspaceId (opsional string)
cloudizero_create_project	Membuat proyek baru. Memerlukan kunci API dengan Akses Semua Proyek (Global).	name (string), description (opsional string), workspaceId (opsional string)
cloudizero_update_project	Memperbarui nama atau deskripsi proyek yang sudah ada.	projectId (string), name (opsional string), description (opsional string)
cloudizero_delete_project	Menghapus proyek secara permanen beserta seluruh folder dan file di dalamnya.	projectId (string)
cloudizero_reorder_projects	Memperbarui urutan tampilan proyek menggunakan array terurut ID proyek.	projectIds (string[])
cloudizero_list_contents	Menjelajahi folder dan file dalam proyek atau folder tertentu.	projectId (string), folderId (opsional string)
cloudizero_list_folders	Mendaftar folder virtual dalam suatu proyek, dengan opsi filter berdasarkan ID folder induk.	projectId (string), parentId (opsional string)
cloudizero_create_folder	Membuat folder virtual untuk mengkategorikan aset media.	projectId (string), name (string), parentId (opsional string)
cloudizero_update_folder	Mengubah nama atau memindahkan folder, memperbarui path objek seluruh file di dalamnya.	folderId (string), name (opsional string), parentId (opsional string)
cloudizero_delete_folder	Menghapus folder secara permanen beserta seluruh subfolder dan file di dalamnya secara rekursif.	folderId (string)
cloudizero_get_folder	Mengambil metadata detail folder virtual dan statistik penyimpanan kumulatif (total ukuran file dan jumlah file).	folderId (string)
cloudizero_upload_local_file	Mengunggah file lokal dari mesin developer ke penyimpanan Cloudizero bebas egress.	filePath (string), projectId (string), folderId (opsional), fileName (opsional), mimeType (opsional), autoExtract (opsional boolean)
cloudizero_create_presigned_upload	Menghasilkan URL unggah bertanda tangan (signed PUT URL) untuk unggahan langsung dari browser/mobile ke storage engine tanpa beban egress server.	projectId (string), fileName (string), fileSize (number), mimeType (opsional string), folderId (opsional string), cacheControl (opsional string)
cloudizero_complete_upload	Memfinalisasi unggahan langsung sisi klien dengan memverifikasi aset di storage engine dan mencatat metadata katalog.	fileId (string), projectId (string), fileName (string), fileSize (number), mimeType (string), storageKey (string), folderId (opsional string), autoExtract (opsional boolean)
cloudizero_get_file	Mengambil metadata file dan URL unduhan presigned.	fileId (string)
cloudizero_update_file	Memperbarui metadata file (mengubah nama, memindahkan folder, mengatur status tong sampah, atau mengisi teks alt).	fileId (string), name (opsional string), folderId (opsional string), isTrash (opsional boolean), altText (opsional string)
cloudizero_replace_local_file	Mengganti konten biner file di penyimpanan dengan file lokal baru dengan mempertahankan fileId yang sama.	fileId (string), filePath (string), fileName (opsional string), mimeType (opsional string)
cloudizero_delete_file	Menghapus file secara permanen dari penyimpanan dan basis data.	fileId (string)
cloudizero_get_file_pages	Mengambil daftar halaman gambar yang diekstrak, dimensi, URL thumbnail, dan bab dokumen (misal PDF).	fileId (string)
cloudizero_extract_pdf	Memicu antrean tugas ekstraksi halaman dokumen PDF dan pembuatan thumbnail secara asinkron.	fileId (string)
cloudizero_search_files	Melakukan pencarian multimodal hibrida semantik dan kata kunci di seluruh aset proyek menggunakan bahasa alami.	projectId (string), query (string)
cloudizero_ai_describe_image	Menghasilkan teks alt WCAG, tag SEO, deskripsi visual, palet warna dominan, dan embedding vektor menggunakan AI multimodal.	fileId (string), locale (opsional 'en' \| 'id'), force (opsional boolean)
cloudizero_get_cdn_url	Menghasilkan URL distribusi CDN publik yang bersih dan otoritatif untuk storage key aset, dengan opsi transformasi gambar di edge (lebar, tinggi, kualitas, format, fit).	storageKey (string), width (opsional number), height (opsional number), quality (opsional number), format (opsional 'auto' \| 'webp' \| 'avif' \| 'json'), fit (opsional 'scale-down' \| 'contain' \| 'cover' \| 'crop' \| 'pad')
cloudizero_get_account_quota	Mengambil profil akun, tier paket langganan, dan penggunaan kuota penyimpanan waktu-nyata (byte terpakai, sisa penyimpanan, jumlah proyek dan file).	Tidak ada

Variabel Lingkungan (Environment)

Property	Type	Default	Description
CLOUDIZERO_API_KEY*required	string	—	Kunci API rahasia berawalan cz_live_... yang dibuat dari Dashboard Cloudizero.
CLOUDIZERO_BASE_URL	string	https://api.cloudizero.com	URL dasar API deployment Cloudizero Anda.
CLOUDIZERO_CDN_URL	string	https://cdn.cloudizero.com	Domain CDN publik kustom untuk pengiriman media.