Langkau ke kandungan

Panduan Pemasangan

Sedia dan berjalan dalam masa kurang 5 minit. Panduan ini merangkumi persediaan untuk 24 klien MCP termasuk Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, dan 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/claude-code-plugin
/plugin install maguyva@maguyva

Pasang untuk akaun pengguna anda. Untuk pasukan, tambah --scope project pada kedua-dua arahan untuk commit plugin ke .claude/settings.json repositori supaya rakan sepasukan mendapatnya secara automatik.

Plugin ini mengesahkan diri melalui environment variable MAGUYVA_API_KEY. Tetapkan dalam shell anda:

export MAGUYVA_API_KEY=mgv_xxxx

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

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

Gantikan mgv_xxxx dengan kunci API anda daripada 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

Tambah ke fail konfigurasi Claude Desktop anda:

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

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

Claude Desktop hanya menyokong pelayan jauh sebagai "connector" OAuth melalui Settings, bukan sebagai entri header-authenticated dalam claude_desktop_config.json, jadi ini menggunakan bridge mcp-remote (memerlukan Node.js / npx).

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

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

Dokumentasi MCP Cursor →

VS Code / GitHub Copilot

Tambah ke .vscode/mcp.json dalam projek anda (atau tetapan pengguna):

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

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

Tambah ke konfigurasi MCP Windsurf anda:

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

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

Dokumentasi MCP 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"

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

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

Dokumentasi MCP Codex →

GitHub Copilot CLI

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

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

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

Gantikan mgv_xxxx dengan kunci API anda daripada 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

Tambah ke tetapan MCP Cline anda:

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

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

Tambah ke tetapan MCP Roo Code anda:

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

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

Dokumentasi MCP Roo Code →

Goose

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

Tambah ke konfigurasi Goose anda:

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

Dokumentasi MCP Goose →

LM Studio

LM Studio menyokong pelayan MCP melalui konfigurasi Agent-nya. Tambah pelayan MCP baharu dalam Settings → Agent → MCP Servers menggunakan format JSON mcpServers piawai. LM Studio menyambung ke pelayan MCP melalui stdio. Lihat dokumen →

Continue

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

Tambah ke konfigurasi Continue anda (~/.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"
      }
    }
  }
}

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

Dokumentasi MCP Continue →

Amazon Q Developer

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

Tambah ke konfigurasi MCP Amazon Q anda:

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

Dokumentasi MCP Amazon Q Developer →

PyCharm

Tambah ke .ai/mcp/mcp.json pada root projek anda, atau tampal dalam 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"
      }
    }
  }
}

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

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

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

Dokumentasi MCP Zed →

Trae

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

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

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

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

Dokumentasi MCP OpenCode →

BoltAI

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

Tambah ke konfigurasi MCP BoltAI anda:

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

Dokumentasi MCP BoltAI →

LibreChat

Tambah ke konfigurasi LibreChat anda:

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

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

Klien ini belum menyokong pelayan MCP jauh dengan header auth tersuai, jadi ia menyambung melalui bridge mcp-remote (memerlukan Node.js / npx). Maguyva berjalan sepenuhnya secara jauh — hanya bridge yang berjalan secara tempatan.

Dokumentasi MCP LibreChat →

Antigravity

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

Tambah ke konfigurasi MCP Antigravity anda:

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

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

Dokumentasi MCP Antigravity →

Claude Cowork

Claude Cowork menggunakan format MCP yang sama seperti klien Anthropic lain:

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

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

Dokumentasi MCP Claude Cowork →

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

Warp menyokong pelayan MCP dalam Agent Mode. Konfigurasi diurus melalui UI Warp (Settings → Agent Mode → MCP Servers) dan disegerakkan melalui Warp Drive. Tampal JSON mcpServers piawai semasa menambah pelayan. Lihat dokumen →

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

Sahkan Persediaan Anda#

Selepas menyambung, cuba tanya ejen anda beberapa soalan:

  • "Repositori apa yang saya ada 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 mengesahkan penyelesaian repositori. Pelayan v3 tidak menyimpan keadaan, jadi penggantian repositori hanya terpakai pada satu panggilan.

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#

  • Sahkan 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#