Lompat ke konten

Panduan Instalasi

Siap pakai dalam waktu kurang dari 5 menit. Panduan ini mencakup setup untuk 24 klien MCP, termasuk Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, dan 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/claude-code-plugin
/plugin install maguyva@maguyva

Terinstal untuk akun pengguna kamu. Untuk tim, tambahkan --scope project ke kedua perintah supaya plugin-nya ikut ter-commit ke .claude/settings.json milik repository sehingga rekan tim otomatis mendapatkannya.

Plugin-nya melakukan autentikasi lewat environment variable MAGUYVA_API_KEY. Set di shell-mu:

export MAGUYVA_API_KEY=mgv_xxxx

direnv (.envrc) per proyek disarankan — key-nya bersifat repository-scoped, jadi nilai per proyek cocok dengan akses tiap proyek. Shell export global juga cukup kalau satu key mencakup semua pekerjaanmu.

Manual (.mcp.json) — lanjutan
.mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

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-mu:

claude_desktop_config.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Claude Desktop hanya mendukung server remote sebagai "connector" OAuth lewat Settings, bukan sebagai entri header-authenticated di claude_desktop_config.json, jadi ini memakai bridge mcp-remote (butuh Node.js / npx).

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 proyekmu:

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

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

Dokumentasi MCP Cursor →

VS Code / GitHub Copilot

Tambahkan ke .vscode/mcp.json di proyekmu (atau user settings):

.vscode/mcp.json
{
  "servers": {
    "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.

Dokumentasi MCP VS Code / GitHub Copilot →

Windsurf

macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %UserProfile%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json

Tambahkan ke konfigurasi MCP Windsurf-mu:

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

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

Dokumentasi MCP Windsurf →

Codex

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

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

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

[mcp_servers.maguyva.http_headers]
Authorization = "Bearer ${MAGUYVA_API_KEY}"

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

Dokumentasi MCP Codex →

GitHub Copilot CLI

Tambahkan ke .copilot/mcp-config.json:

.copilot/mcp-config.json
{
  "servers": {
    "maguyva": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

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-mu (~/.gemini/settings.json):

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

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

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-mu:

cline_mcp_settings.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP Cline →

Roo Code

macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

Tambahkan ke pengaturan MCP Roo Code-mu:

mcp_settings.json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamable-http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

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

Dokumentasi MCP Roo Code →

Goose

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

Tambahkan ke config Goose-mu:

config.yaml
extensions:
  maguyva:
    name: maguyva
    cmd: npx
    args:
      - -y
      - mcp-remote
      - https://maguyva.tools/mcp
      - --header
      - "Authorization: Bearer ${MAGUYVA_API_KEY}"
    enabled: true
    envs:
      MAGUYVA_API_KEY: mgv_xxxx
    type: stdio

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP Goose →

LM Studio

LM Studio mendukung server MCP lewat konfigurasi Agent-nya. Tambahkan server MCP baru di Settings → Agent → MCP Servers memakai format JSON mcpServers standar. LM Studio terhubung ke server MCP lewat stdio. Lihat dokumentasi →

Continue

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

Tambahkan ke config Continue-mu (~/.continue/config.json):

config.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP Continue →

Amazon Q Developer

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

Tambahkan ke config MCP Amazon Q-mu:

mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP Amazon Q Developer →

PyCharm

Tambahkan ke .ai/mcp/mcp.json di root proyekmu, atau tempel di Settings > Tools > AI Assistant > MCP:

.ai/mcp/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP PyCharm →

Zed

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

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

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

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

Dokumentasi MCP Zed →

Trae

Tambahkan ke .trae/mcp.json di root proyekmu:

.trae/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP Trae →

OpenCode

Tambahkan ke opencode.json di root proyekmu:

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

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

Dokumentasi MCP OpenCode →

BoltAI

macOS: ~/Library/Application Support/BoltAI/mcp_config.json

Tambahkan ke konfigurasi MCP BoltAI-mu:

mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP BoltAI →

LibreChat

Tambahkan ke konfigurasi LibreChat-mu:

librechat.yaml
mcpServers:
  maguyva:
    command: npx
    args:
      - -y
      - mcp-remote
      - https://maguyva.tools/mcp
      - --header
      - "Authorization: Bearer ${MAGUYVA_API_KEY}"
    env:
      MAGUYVA_API_KEY: mgv_xxxx

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

Klien ini belum mendukung server MCP remote dengan header auth kustom, jadi ia terhubung lewat bridge mcp-remote (butuh Node.js / npx). Maguyva berjalan sepenuhnya di remote — hanya bridge-nya yang berjalan lokal.

Dokumentasi MCP LibreChat →

Antigravity

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

Tambahkan ke konfigurasi MCP Antigravity-mu:

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

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

Dokumentasi MCP Antigravity →

Claude Cowork

Claude Cowork memakai format MCP yang sama seperti klien Anthropic lainnya:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Dokumentasi MCP Claude Cowork →

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

Warp mendukung server MCP di Agent Mode. Konfigurasinya dikelola lewat UI Warp (Settings → Agent Mode → MCP Servers) dan disinkron lewat Warp Drive. Tempel JSON mcpServers standar saat menambahkan server. Lihat dokumentasi →

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

Validasi Setup Anda#

Setelah terhubung, coba ajukan beberapa pertanyaan ke agent 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 memverifikasi resolusi repository. Server v3 tidak menyimpan state, jadi override repository berlaku hanya untuk satu panggilan.

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#

  • Pastikan npx tersedia di PATH Anda
  • Periksa apakah token API Anda valid dan belum kedaluwarsa
  • Uji konektivitas ke https://maguyva.tools/mcp
  • Periksa sintaks konfigurasi MCP klien Anda

Langkah Berikutnya#