Langkau ke kandungan

Panduan Pemasangan

Mula beroperasi dalam masa kurang 5 minit. Panduan ini merangkumi persediaan untuk 23 klien MCP termasuk Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, dan Devin Desktop (Windsurf), dan banyak lagi.

Prasyarat: Anda perlukan kunci API daripada app.maguyva.ai dan satu repositori GitHub yang disambungkan.

Persediaan Persekitaran

#

Mula-mula, tetapkan kunci API anda dalam pemboleh ubah persekitaran. Abaikan repository apabila klien MCP anda memberikan lalai untuk permintaan tersebut atau apabila kunci boleh mengakses tepat satu repositori; jika tidak, berikannya 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

Gantikan mgv_xxxx dengan kunci API sebenar anda daripada app.maguyva.ai.

Konfigurasi Klien

#

Pilih klien MCP anda di bawah untuk arahan persediaan khusus.

Nota keserasian: Maguyva menggunakan MCP standard. Sebarang klien yang menyokong MCP boleh menyambung ke pelayan yang sama, walaupun kami belum menulis panduan persediaan rasmi untuknya lagi.

Claude Code

Pasang plugin Maguyva daripada marketplace Claude Code:

Tambah marketplace Maguyva, kemudian pasang plugin-nya (jalankan setiap arahan di dalam Claude Code):

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

/plugin install membuka butiran plugin, tempat anda memilih skop pemasangan: anda sahaja (user), semua orang yang bekerja dalam repositori ini (project), atau anda sahaja dalam repositori ini (local). Arahan dalam sesi ini tiada bendera --scope.

Plugin ini mengesahkan diri melalui pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya dalam shell anda:

export MAGUYVA_API_KEY=mgv_xxxx

direnv (.envrc) setiap projek disyorkan — kunci terhad kepada repositori tertentu, jadi nilai setiap projek sepadan dengan akses projek masing-masing. Shell export global turut memadai jika satu kunci merangkumi semua kerja anda.

Untuk pasukan, anda juga boleh menjalankan bentuk shell bagi kedua-dua arahan dari akar repositori, di luar Claude Code:

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

Skop project merekodkan plugin dalam .claude/settings.json repositori, yang anda commit. Ini menghidupkan plugin untuk rakan sepasukan tetapi tidak memuat turunnya, jadi setiap rakan sepasukan menjalankan arahan pemasangan 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}"
      }
    }
  }
}

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada 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

Tambah ke fail konfigurasi Claude Desktop anda:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

claude_desktop_config.json hanya memulakan pelayan setempat, jadi persediaan ini menggunakan jambatan @maguyva/mcp (memerlukan Node.js / npx). Claude Desktop juga boleh mencapai Maguyva sebagai penyambung tersuai (Customize → Connectors) dengan pengepala permintaan authorization, tetapi pengepala permintaan masih beta untuk bilangan organisasi yang terhad.

Apa yang Maguyva tambah pada Claude Desktop →

Dokumentasi MCP Claude Desktop →

Cursor

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

Tambah ke .cursor/mcp.json pada root projek anda:

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Apa yang Maguyva tambah pada Cursor →

Dokumentasi MCP Cursor →

VS Code / GitHub Copilot

Tambah ke .vscode/mcp.json dalam projek 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}"
      }
    }
  }
}

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Ini format VS Code (kunci servers). VS Code menyelesaikan rujukan MAGUYVA_API_KEY daripada persekitaran tempat ia bermula. Aliran Add Server kini mengutamakan .mcp.json mudah alih (kunci mcpServers) yang turut dibaca GitHub Copilot CLI; fail itu tidak menyokong pemboleh ubah input atau fail persekitaran VS Code.

Apa yang Maguyva tambah pada 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 dikenali sebagai Devin Desktop. Tambah ke fail konfigurasi MCP-nya:

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Devin Local, ejen lalai, membaca fail ini sejak versi 3.6; versi terdahulu menyimpan pelayan dalam fail konfigurasi utama dan memindahkannya ke sini semasa bermula. Ejen Cascade lama, yang tidak digunakan untuk memulakan perbualan baharu, membaca fail yang sama. Devin Desktop menyelesaikan rujukan MAGUYVA_API_KEY daripada persekitaran tempat ia bermula.

Apa yang Maguyva tambah pada Devin Desktop (Windsurf) →

Dokumentasi MCP Devin Desktop (Windsurf) →

Codex

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

Tambah ke konfigurasi Codex CLI anda (~/.codex/config.toml):

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Apa yang Maguyva tambah pada Codex →

Dokumentasi MCP Codex →

GitHub Copilot CLI

Tambah 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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada GitHub Copilot CLI →

Dokumentasi MCP GitHub Copilot CLI →

Gemini CLI

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

Tambah ke tetapan Gemini CLI anda (~/.gemini/settings.json):

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Apa yang Maguyva tambah pada 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

Tambah ke tetapan MCP Cline anda:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada Cline →

Dokumentasi MCP Cline →

Goose

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

Tambah ke konfigurasi 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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada Goose →

Dokumentasi MCP Goose →

LM Studio

Dalam LM Studio, buka tab Program di bar sisi kanan, pilih Install → Edit mcp.json dan tambah:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Dokumentasi MCP LM Studio →

Continue

Simpan sebagai .continue/mcpServers/maguyva.yaml dalam ruang kerja anda (atau tambah entri mcpServers ke ~/.continue/config.yaml), kemudian tetapkan MAGUYVA_API_KEY dalam ~/.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 }}

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Continue menggunakan pelayan MCP dalam mod ejen sahaja. Ia mencari rahsia dalam ~/.continue/.env, kemudian dalam .continue/.env dan .env ruang kerja, kemudian dalam persekitaran proses.

Apa yang Maguyva tambah pada 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

Tambah ke konfigurasi MCP Kiro CLI (~/.kiro/settings/mcp.json, atau .kiro/settings/mcp.json dalam projek):

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Kiro CLI menggantikan Amazon Q Developer CLI. Semasa dipasang, ia menyalin pelayan anda sekali dari ~/.aws/amazonq/mcp.json ke ~/.kiro/settings/mcp.json, dan .kiro/settings/mcp.json projek diutamakan berbanding fail pengguna.

Dokumentasi MCP Kiro CLI (Amazon Q Developer CLI) →

PyCharm

Tampal dalam 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"
      }
    }
  }
}

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Persediaan ini menggunakan jambatan @maguyva/mcp (memerlukan Node.js / npx). Konfigurasi sambungan jauh yang menggunakan sokongan natif klien ini belum disahkan dalam panduan ini; ini tidak bermakna klien tersebut tiada sokongan natif untuk sambungan jauh. Maguyva berjalan sepenuhnya dari jauh — hanya jambatan berjalan secara setempat.

Dokumentasi MCP PyCharm →

Zed

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

Tambah ke tetapan Zed anda (~/.config/zed/settings.json):

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada Zed →

Dokumentasi MCP Zed →

Trae

Hidupkan Enable Project MCP dalam Settings → MCP, kemudian tambah ke .trae/mcp.json di akar projek anda:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Dokumentasi MCP Trae →

OpenCode

Tambah ke opencode.json pada root projek anda:

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Apa yang Maguyva tambah pada OpenCode →

Dokumentasi MCP OpenCode →

BoltAI

macOS: ~/.boltai/mcp.json

Tambah ke konfigurasi MCP BoltAI anda:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Persediaan ini menggunakan jambatan @maguyva/mcp (memerlukan Node.js / npx). Konfigurasi sambungan jauh yang menggunakan sokongan natif klien ini belum disahkan dalam panduan ini; ini tidak bermakna klien tersebut tiada sokongan natif untuk sambungan jauh. Maguyva berjalan sepenuhnya dari jauh — hanya jambatan berjalan secara setempat.

Dokumentasi MCP BoltAI →

LibreChat

Tambah ke librechat.yaml dan tetapkan MAGUYVA_API_KEY dalam persekitaran pelayan LibreChat:

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

Konfigurasi ini membaca kunci anda daripada pemboleh ubah persekitaran MAGUYVA_API_KEY. Tetapkannya kepada kunci API anda daripada app.maguyva.ai dalam persekitaran tempat klien anda dimulakan.

Dokumentasi MCP LibreChat →

Antigravity

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

Tambah ke konfigurasi MCP Antigravity anda:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada Antigravity →

Dokumentasi MCP Antigravity →

Claude Cowork

Claude Cowork tidak memuatkan pelayan daripada claude_desktop_config.json; ia mencapai pelayan jauh sebagai penyambung tersuai. Dalam Customize → Connectors, tambah penyambung tersuai dengan URL https://maguyva.tools/mcp, pilih No sign-in dan tambah pengepala permintaan authorization yang nilainya Bearer diikuti kunci API anda. Pengepala permintaan masih beta untuk bilangan organisasi yang terhad; jika dialog tiada bahagian Request headers, Cowork belum boleh membuat pengesahan dengan Maguyva. Lihat dokumen →

ChatGPT

ChatGPT menyokong pelayan MCP jauh pada pelan Business, Enterprise, dan Edu melalui Settings → Apps → Create. Endpoint HTTPS jauh diperlukan — ChatGPT tidak menyokong pelayan stdio tempatan. Lihat panduan MCP OpenAI untuk persediaan. Lihat dokumen →

Warp

Tambah ke ~/.warp/.mcp.json (atau .warp/.mcp.json dalam projek), atau tampal dalam Settings → Agents → MCP servers → + Add:

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

Gantikan mgv_xxxx dengan kunci API anda daripada app.maguyva.ai.

Apa yang Maguyva tambah pada Warp →

Dokumentasi MCP Warp →

Maguyva menggunakan MCP standard. Sebarang klien yang menyokong protokol ini boleh menyambung — walaupun tiada panduan rasmi di atas. 23 klien didokumenkan, lebih banyak ditambah secara berkala.

Sahkan Persediaan Anda

#

Selepas menyambung, cuba tanya ejen anda beberapa soalan:

  • "Repositori manakah yang telah saya sambungkan?" — mengesahkan sambungan berfungsi
  • "Bagaimana pengesahan (authentication) dikendalikan dalam kod ini?" — menguji carian semantik
  • "Cari semua fungsi yang memanggil pangkalan data" — menguji carian kebergantungan
  • "Kelas UserService bergantung kepada apa?" — menguji carian simbol

Anda sepatutnya nampak hasil lengkap dengan laluan fail dan nombor baris daripada repositori yang disambungkan. Jika tidak, semak troubleshooting section di bawah.

Format Repositori

#

Apabila menyatakan repositori:

  • Dengan cabang: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Cabang lalai: "owner/repo"

Petua: gunakan repository_context(action="info", repository="...") untuk menyemak penentuan repositori. Penggantian repositori lalai hanya terpakai pada panggilan semasa.

Penyelesaian Masalah

#

Isu Kunci API

#
  • Sahkan kunci anda bermula dengan awalan mgv_
  • Semak kunci itu ditetapkan dengan betul dalam persekitaran anda
  • Pastikan kunci itu belum luput tempoh

Repositori Tidak Ditemui

#
  • Sahkan repositori itu disambungkan dalam app.maguyva.ai
  • Semak format owner/repo adalah betul
  • Pastikan anda mempunyai akses kepada repositori itu

Isu Sambungan MCP

#
  • Jika klien anda menggunakan jambatan @maguyva/mcp, pastikan npx tersedia dalam PATH anda
  • Semak token API anda sah dan belum luput tempoh
  • Uji ketersambungan ke https://maguyva.tools/mcp
  • Semak sintaks konfigurasi MCP klien anda

Langkah Seterusnya

#

Berkaitan

Baca seterusnya