Lompat ke konten

Panduan Instalasi

Siap pakai dalam waktu kurang dari 5 menit. Panduan ini mencakup setup untuk 23 klien MCP, termasuk Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, dan Devin Desktop (Windsurf), dan lainnya.

Prasyarat: Anda memerlukan kunci API dari app.maguyva.ai dan repository GitHub yang sudah terhubung.

Setup Environment

#

Pertama, setel kunci API Anda dalam variabel lingkungan. Jangan sertakan repository ketika klien MCP Anda menyediakan default untuk permintaan tersebut atau kunci dapat mengakses tepat satu repository; jika tidak, berikan secara eksplisit.

macOS/Linux (Bash/Zsh)

# 
# Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc  # reload

Windows (PowerShell)

# 
# Make it persist in your profile:
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE

Ganti mgv_xxxx dengan kunci API asli Anda dari app.maguyva.ai.

Konfigurasi Klien

#

Pilih klien MCP Anda di bawah untuk instruksi setup yang spesifik.

Catatan kompatibilitas: Maguyva menggunakan MCP standar. Klien mana pun yang mendukung MCP bisa terhubung ke server yang sama, meskipun kami belum menulis panduan setupnya secara resmi.

Claude Code

Instal plugin Maguyva dari marketplace Claude Code:

Tambahkan marketplace Maguyva, lalu instal plugin-nya (jalankan tiap perintah di dalam Claude Code):

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

/plugin install membuka detail plugin, tempat Anda memilih cakupan instalasi: hanya Anda (user), semua orang yang bekerja di repository ini (project), atau hanya Anda di repository ini (local). Perintah di dalam sesi ini tidak punya flag --scope.

Plugin-nya melakukan autentikasi lewat variabel lingkungan MAGUYVA_API_KEY. Atur di shell Anda:

export MAGUYVA_API_KEY=mgv_xxxx

direnv (.envrc) per proyek disarankan — key-nya dibatasi untuk repository tertentu, jadi nilai per proyek cocok dengan akses tiap proyek. Shell export global juga cukup kalau satu key mencakup semua pekerjaan Anda.

Untuk tim, Anda juga bisa menjalankan bentuk shell dari kedua perintah dari root repository, di luar Claude Code:

claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project

Cakupan project mencatat plugin di .claude/settings.json milik repository, yang Anda commit. Itu mengaktifkan plugin untuk rekan tim tapi tidak mengunduhnya, jadi setiap rekan tim menjalankan perintah instalasi sekali.

Manual (.mcp.json) — lanjutan
claude mcp add 
claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'
.mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Claude Code →

Dokumentasi MCP Claude Code →

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Tambahkan ke file konfigurasi Claude Desktop Anda:

claude_desktop_config.json 
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

claude_desktop_config.json hanya memulai server lokal, jadi penyiapan ini memakai bridge @maguyva/mcp (memerlukan Node.js / npx). Claude Desktop juga bisa menjangkau Maguyva sebagai konektor kustom (Customize → Connectors) dengan header permintaan authorization, tetapi header permintaan masih beta untuk sejumlah organisasi terbatas.

Yang ditambahkan Maguyva ke Claude Desktop →

Dokumentasi MCP Claude Desktop →

Cursor

macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Tambahkan ke .cursor/mcp.json di root proyek Anda:

.cursor/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Yang ditambahkan Maguyva ke Cursor →

Dokumentasi MCP Cursor →

VS Code / GitHub Copilot

Tambahkan ke .vscode/mcp.json di proyek Anda, atau ke mcp.json profil Anda (jalankan MCP: Open User Configuration):

.vscode/mcp.json 
{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Ini format VS Code (kunci servers). VS Code mengambil referensi MAGUYVA_API_KEY dari lingkungan tempat ia dijalankan. Alur Add Server-nya kini lebih memilih .mcp.json portabel (kunci mcpServers) yang juga dibaca GitHub Copilot CLI; berkas itu tidak mendukung variabel input maupun berkas lingkungan VS Code.

Yang ditambahkan Maguyva ke VS Code / GitHub Copilot →

Dokumentasi MCP VS Code / GitHub Copilot →

Devin Desktop (Windsurf)

macOS: ~/.config/devin/mcp_config.json
Windows: %APPDATA%\devin\mcp_config.json
Linux: ~/.config/devin/mcp_config.json

Windsurf kini bernama Devin Desktop. Tambahkan ke berkas konfigurasi MCP-nya:

mcp_config.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Devin Local, agen default, membaca berkas ini sejak versi 3.6; versi sebelumnya menyimpan server di berkas konfigurasi utama dan memindahkannya ke sini saat dijalankan. Agen Cascade lama, yang tidak dipakai untuk memulai percakapan baru, membaca berkas yang sama. Devin Desktop mengambil referensi MAGUYVA_API_KEY dari lingkungan tempat ia dijalankan.

Yang ditambahkan Maguyva ke Devin Desktop (Windsurf) →

Dokumentasi MCP Devin Desktop (Windsurf) →

Codex

macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml

Tambahkan ke config Codex CLI Anda (~/.codex/config.toml):

.codex/config.toml 
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Yang ditambahkan Maguyva ke Codex →

Dokumentasi MCP Codex →

GitHub Copilot CLI

Tambahkan ke ~/.copilot/mcp-config.json:

~/.copilot/mcp-config.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
copilot mcp add 
copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke GitHub Copilot CLI →

Dokumentasi MCP GitHub Copilot CLI →

Gemini CLI

macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json

Tambahkan ke pengaturan Gemini CLI Anda (~/.gemini/settings.json):

settings.json 
{
  "mcpServers": {
    "maguyva": {
      "httpUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Yang ditambahkan Maguyva ke Gemini CLI →

Dokumentasi MCP Gemini CLI →

Cline

macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Tambahkan ke pengaturan MCP Cline Anda:

cline_mcp_settings.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Cline →

Dokumentasi MCP Cline →

Goose

macOS: ~/.config/goose/config.yaml
Windows: %APPDATA%\Block\goose\config\config.yaml
Linux: ~/.config/goose/config.yaml

Tambahkan ke config Goose Anda:

config.yaml 
extensions:
  maguyva:
    name: maguyva
    type: streamable_http
    uri: https://maguyva.tools/mcp
    enabled: true
    headers:
      Authorization: Bearer mgv_xxxx
    timeout: 300

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Goose →

Dokumentasi MCP Goose →

LM Studio

Di LM Studio, buka tab Program di sidebar kanan, pilih Install → Edit mcp.json, lalu tambahkan:

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Dokumentasi MCP LM Studio →

Continue

Simpan sebagai .continue/mcpServers/maguyva.yaml di workspace Anda (atau tambahkan entri mcpServers ke ~/.continue/config.yaml), lalu atur MAGUYVA_API_KEY di ~/.continue/.env:

.continue/mcpServers/maguyva.yaml 
name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Continue hanya memakai server MCP di mode agen. Ia mencari secret di ~/.continue/.env, lalu di .continue/.env dan .env workspace, lalu di lingkungan proses.

Yang ditambahkan Maguyva ke Continue →

Dokumentasi MCP Continue →

Kiro CLI (Amazon Q Developer CLI)

macOS: ~/.kiro/settings/mcp.json
Windows: %USERPROFILE%\.kiro\settings\mcp.json
Linux: ~/.kiro/settings/mcp.json

Tambahkan ke konfigurasi MCP Kiro CLI (~/.kiro/settings/mcp.json, atau .kiro/settings/mcp.json di sebuah proyek):

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Kiro CLI menggantikan Amazon Q Developer CLI. Saat diinstal, Kiro CLI menyalin server Anda sekali dari ~/.aws/amazonq/mcp.json ke ~/.kiro/settings/mcp.json, dan .kiro/settings/mcp.json milik proyek lebih diutamakan daripada file pengguna.

Dokumentasi MCP Kiro CLI (Amazon Q Developer CLI) →

PyCharm

Tempel di Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, sebagai konfigurasi JSON: 

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Pengaturan ini menggunakan bridge @maguyva/mcp (memerlukan Node.js / npx). Panduan ini belum memverifikasi konfigurasi koneksi remote bawaan untuk klien ini; hal tersebut bukan berarti klien tidak memiliki dukungan koneksi remote bawaan. Maguyva berjalan sepenuhnya di remote — hanya bridge yang berjalan secara lokal.

Dokumentasi MCP PyCharm →

Zed

macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json

Tambahkan ke pengaturan Zed Anda (~/.config/zed/settings.json):

settings.json 
{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Zed →

Dokumentasi MCP Zed →

Trae

Nyalakan Enable Project MCP di Settings → MCP, lalu tambahkan ke .trae/mcp.json di root proyek Anda:

.trae/mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Dokumentasi MCP Trae →

OpenCode

Tambahkan ke opencode.json di root proyek Anda:

opencode.json 
{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Yang ditambahkan Maguyva ke OpenCode →

Dokumentasi MCP OpenCode →

BoltAI

macOS: ~/.boltai/mcp.json

Tambahkan ke konfigurasi MCP BoltAI Anda:

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Pengaturan ini menggunakan bridge @maguyva/mcp (memerlukan Node.js / npx). Panduan ini belum memverifikasi konfigurasi koneksi remote bawaan untuk klien ini; hal tersebut bukan berarti klien tidak memiliki dukungan koneksi remote bawaan. Maguyva berjalan sepenuhnya di remote — hanya bridge yang berjalan secara lokal.

Dokumentasi MCP BoltAI →

LibreChat

Tambahkan ke librechat.yaml dan atur MAGUYVA_API_KEY di lingkungan server LibreChat:

librechat.yaml 
mcpServers:
  maguyva:
    type: streamable-http
    url: https://maguyva.tools/mcp
    headers:
      Authorization: Bearer ${MAGUYVA_API_KEY}
    requiresOAuth: false

Config ini membaca kunci API Anda dari environment variable MAGUYVA_API_KEY. Isi variabel itu dengan kunci API Anda dari app.maguyva.ai di environment tempat klien Anda dijalankan.

Dokumentasi MCP LibreChat →

Antigravity

macOS: ~/.gemini/config/mcp_config.json
Windows: %UserProfile%\.gemini\config\mcp_config.json
Linux: ~/.gemini/config/mcp_config.json

Tambahkan ke konfigurasi MCP Antigravity Anda:

mcp_config.json 
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Antigravity →

Dokumentasi MCP Antigravity →

Claude Cowork

Claude Cowork tidak memuat server dari claude_desktop_config.json; ia menjangkau server jarak jauh sebagai konektor kustom. Di Customize → Connectors, tambahkan konektor kustom dengan URL https://maguyva.tools/mcp, pilih No sign-in, lalu tambahkan header permintaan authorization yang nilainya Bearer diikuti kunci API Anda. Header permintaan masih beta untuk sejumlah organisasi terbatas; jika dialog tidak punya bagian Request headers, Cowork belum bisa melakukan autentikasi ke Maguyva. Lihat dokumentasi →

ChatGPT

ChatGPT mendukung server MCP remote di paket Business, Enterprise, dan Edu lewat Settings → Apps → Create. Endpoint HTTPS remote dibutuhkan — ChatGPT tidak mendukung server stdio lokal. Lihat panduan MCP OpenAI untuk setupnya. Lihat dokumentasi →

Warp

Tambahkan ke ~/.warp/.mcp.json (atau .warp/.mcp.json di sebuah proyek), atau tempel di Settings → Agents → MCP servers → + Add:

~/.warp/.mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

Ganti mgv_xxxx dengan kunci API Anda dari app.maguyva.ai.

Yang ditambahkan Maguyva ke Warp →

Dokumentasi MCP Warp →

Maguyva memakai MCP standar. Klien apa pun yang mendukung protokol ini dapat terhubung — bahkan jika tidak ada panduan resmi di atas. 23 klien telah didokumentasikan, dan terus bertambah secara berkala.

Validasi Setup Anda

#

Setelah terhubung, coba ajukan beberapa pertanyaan ke agen Anda:

  • "Repository apa saja yang sudah saya hubungkan?" — memverifikasi koneksi berfungsi
  • "Bagaimana autentikasi ditangani di codebase ini?" — menguji pencarian semantik
  • "Temukan semua fungsi yang memanggil database" — menguji dependency search
  • "Apa saja yang menjadi dependency class UserService?" — menguji pencarian simbol

Anda seharusnya melihat hasil dengan jalur file dan nomor baris dari repository yang terhubung. Jika tidak, periksa troubleshooting section di bawah.

Format Repository

#

Saat menentukan repository:

  • Dengan branch: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Branch default: "owner/repo"

Tip: gunakan repository_context(action="info", repository="...") untuk memeriksa resolusi repositori. Penggantian repositori secara eksplisit hanya berlaku pada panggilan saat ini.

Pemecahan Masalah

#

Masalah Kunci API

#
  • Pastikan kunci Anda diawali dengan prefix mgv_
  • Periksa apakah kunci sudah diatur dengan benar di environment Anda
  • Pastikan kunci belum kedaluwarsa

Repository Tidak Ditemukan

#
  • Pastikan repository sudah terhubung di app.maguyva.ai
  • Periksa apakah format owner/repo sudah benar
  • Pastikan Anda memiliki akses ke repository tersebut

Masalah Koneksi MCP

#
  • Jika klien memakai penghubung @maguyva/mcp, pastikan npx tersedia di PATH
  • Periksa apakah token API Anda valid dan belum kedaluwarsa
  • Uji konektivitas ke https://maguyva.tools/mcp
  • Periksa sintaks konfigurasi MCP klien Anda

Langkah Berikutnya

#

Terkait

Baca berikutnya