คู่มือการติดตั้ง
เริ่มใช้งานได้ภายในไม่ถึง 5 นาที คู่มือนี้ครอบคลุมการตั้งค่าสำหรับไคลเอนต์ MCP 24 รายการ รวมถึง Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot และ Windsurf และอื่นๆ
สิ่งที่ต้องมีก่อน: คุณจะต้องมีคีย์ API จาก app.maguyva.ai และรีโพซิทอรี GitHub ที่เชื่อมต่อไว้แล้ว
การตั้งค่าสภาพแวดล้อม#
ขั้นแรก ให้ตั้งค่าคีย์ API ในตัวแปรสภาพแวดล้อม ไม่ต้องระบุ repository เมื่อไคลเอนต์ MCP กำหนดค่าเริ่มต้นสำหรับคำขอนั้น หรือเมื่อคีย์เข้าถึงได้เพียง repository เดียว มิฉะนั้นให้ส่งค่าอย่างชัดเจน
macOS/Linux (Bash/Zsh)#
# Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc # or ~/.bashrc
source ~/.zshrc # reloadWindows (PowerShell)#
# Make it persist in your profile:
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILEแทนที่ mgv_xxxx ด้วยคีย์ API จริงของคุณจาก app.maguyva.ai
การตั้งค่าไคลเอนต์#
เลือกไคลเอนต์ MCP ของคุณด้านล่าง เพื่อดูคำแนะนำการตั้งค่าเฉพาะ
หมายเหตุความเข้ากันได้: Maguyva ใช้ MCP มาตรฐาน ไคลเอนต์ตัวไหนที่รองรับ MCP ก็เชื่อมต่อกับเซิร์ฟเวอร์เดียวกันได้ แม้เราจะยังไม่ได้เขียนคู่มือตั้งค่าอย่างเป็นทางการให้ก็ตาม
Claude Code
ติดตั้งปลั๊กอิน Maguyva จากมาร์เก็ตเพลสของ Claude Code:
เพิ่มมาร์เก็ตเพลสของ Maguyva แล้วติดตั้งปลั๊กอิน (รันแต่ละคำสั่งภายใน Claude Code):
/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyvaติดตั้งสำหรับบัญชีผู้ใช้ของคุณ สำหรับทีม ให้เพิ่ม --scope project ในทั้งสองคำสั่ง เพื่อ commit ปลั๊กอินลงใน .claude/settings.json ของ repository ให้เพื่อนร่วมทีมได้รับมันโดยอัตโนมัติ
ปลั๊กอินจะยืนยันตัวตนผ่านตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ตั้งค่ามันไว้ใน shell ของคุณ:
export MAGUYVA_API_KEY=mgv_xxxxแนะนำให้ใช้ direnv (.envrc) แยกตามโปรเจกต์ — เพราะคีย์ผูกกับแต่ละ repository ค่าที่แยกตามโปรเจกต์จะตรงกับสิทธิ์การเข้าถึงของแต่ละโปรเจกต์ หรือใช้ shell export แบบโกลบอลก็ได้ถ้าคีย์เดียวครอบคลุมงานทั้งหมดของคุณ
กำหนดค่าด้วยตนเอง (.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"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
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
เพิ่มลงในไฟล์ config ของ Claude Desktop:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Claude Desktop รองรับเซิร์ฟเวอร์ระยะไกลแบบ "คอนเนคเตอร์" ผ่าน OAuth ทาง Settings เท่านั้น ไม่ใช่แบบยืนยันตัวตนด้วยเฮดเดอร์ใน claude_desktop_config.json ดังนั้นตรงนี้จึงใช้บริดจ์ mcp-remote (ต้องมี Node.js / npx)
Cursor
macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json
เพิ่มลงใน .cursor/mcp.json ที่รูทของโปรเจกต์:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
VS Code / GitHub Copilot
เพิ่มลงใน .vscode/mcp.json ในโปรเจกต์ของคุณ (หรือการตั้งค่าผู้ใช้):
{
"servers": {
"maguyva": {
"type": "http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Windsurf
macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %UserProfile%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json
เพิ่มลงใน MCP config ของ Windsurf:
{
"mcpServers": {
"maguyva": {
"serverUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Codex
macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml
เพิ่มลงใน config ของ Codex CLI (~/.codex/config.toml):
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
[mcp_servers.maguyva.http_headers]
Authorization = "Bearer ${MAGUYVA_API_KEY}"แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
GitHub Copilot CLI
เพิ่มลงใน .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"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Gemini CLI
macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json
เพิ่มลงใน settings ของ Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"maguyva": {
"httpUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
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
เพิ่มลงใน MCP settings ของ Cline:
{
"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
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
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
เพิ่มลงใน MCP settings ของ Roo Code:
{
"mcpServers": {
"maguyva": {
"type": "streamable-http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
},
"alwaysAllow": [],
"disabled": false
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Goose
macOS: ~/.config/goose/config.yaml
Windows: %AppData%\goose\config.yaml
Linux: ~/.config/goose/config.yaml
เพิ่มลงใน config ของ Goose:
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แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
LM Studio
LM Studio รองรับเซิร์ฟเวอร์ MCP ผ่านการตั้งค่า Agent เพิ่มเซิร์ฟเวอร์ MCP ใหม่ที่ Settings → Agent → MCP Servers โดยใช้รูปแบบ JSON มาตรฐาน mcpServers LM Studio เชื่อมต่อกับเซิร์ฟเวอร์ MCP ผ่าน stdio ดูเอกสาร →
Continue
macOS: ~/.continue/config.json
Windows: %UserProfile%\.continue\config.json
Linux: ~/.continue/config.json
เพิ่มลงใน config ของ Continue (~/.continue/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"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
Amazon Q Developer
macOS: ~/.aws/amazonq/mcp.json
Windows: %UserProfile%\.aws\amazonq\mcp.json
Linux: ~/.aws/amazonq/mcp.json
เพิ่มลงใน MCP config ของ Amazon Q:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
PyCharm
เพิ่มลงใน .ai/mcp/mcp.json ที่รูทของโปรเจกต์ หรือวางไว้ใน Settings > Tools > AI Assistant > MCP:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
Zed
macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json
เพิ่มลงใน settings ของ Zed (~/.config/zed/settings.json):
{
"context_servers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Trae
เพิ่มลงใน .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"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
OpenCode
เพิ่มลงใน opencode.json ที่รูทของโปรเจกต์:
{
"mcp": {
"maguyva": {
"type": "remote",
"url": "https://maguyva.tools/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
BoltAI
macOS: ~/Library/Application Support/BoltAI/mcp_config.json
เพิ่มลงใน MCP config ของ BoltAI:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
LibreChat
เพิ่มลงใน config ของ LibreChat:
mcpServers:
maguyva:
command: npx
args:
- -y
- mcp-remote
- https://maguyva.tools/mcp
- --header
- "Authorization: Bearer ${MAGUYVA_API_KEY}"
env:
MAGUYVA_API_KEY: mgv_xxxxแทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ไคลเอนต์ตัวนี้ยังไม่รองรับเซิร์ฟเวอร์ MCP ระยะไกลที่ใช้เฮดเดอร์ยืนยันตัวตนแบบกำหนดเอง จึงเชื่อมต่อผ่านบริดจ์ mcp-remote (ต้องมี Node.js / npx) Maguyva รันบนรีโมตทั้งหมด — มีแค่บริดจ์เท่านั้นที่รันบนเครื่องของคุณ
Antigravity
macOS: ~/.gemini/antigravity/mcp_config.json
Windows: %UserProfile%\.gemini\antigravity\mcp_config.json
Linux: ~/.gemini/antigravity/mcp_config.json
เพิ่มลงใน MCP config ของ Antigravity:
{
"mcpServers": {
"maguyva": {
"serverUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
Claude Cowork
Claude Cowork ใช้รูปแบบ MCP เดียวกับไคลเอนต์อื่น ๆ ของ Anthropic:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai
ChatGPT
ChatGPT รองรับเซิร์ฟเวอร์ MCP ระยะไกลบนแผน Business, Enterprise และ Edu ผ่าน Settings → Apps → Create ต้องใช้ remote HTTPS endpoint — ChatGPT ไม่รองรับเซิร์ฟเวอร์ stdio ที่รันในเครื่อง ดูคู่มือ MCP ของ OpenAI สำหรับการตั้งค่า ดูเอกสาร →
Warp
Warp รองรับเซิร์ฟเวอร์ MCP ใน Agent Mode การตั้งค่าจัดการผ่าน Warp UI (Settings → Agent Mode → MCP Servers) และซิงค์ผ่าน Warp Drive วาง JSON มาตรฐาน mcpServers เมื่อเพิ่มเซิร์ฟเวอร์ ดูเอกสาร →
Maguyva ใช้ MCP มาตรฐาน ไคลเอนต์ใดก็ตามที่รองรับโปรโตคอลนี้สามารถเชื่อมต่อได้ แม้จะไม่มีคู่มือทางการด้านบนก็ตาม มีไคลเอนต์ที่บันทึกไว้แล้ว 24 รายการ และเพิ่มขึ้นอย่างสม่ำเสมอ
ตรวจสอบการตั้งค่าของคุณ#
หลังจากเชื่อมต่อแล้ว ลองถามคำถามสองสามข้อกับเอเจนต์ของคุณ:
- "ฉันเชื่อมต่อรีโพซิทอรีอะไรไว้บ้าง?" — ตรวจสอบว่าการเชื่อมต่อทำงานอยู่
- "โค้ดเบสนี้จัดการการยืนยันตัวตนอย่างไร?" — ทดสอบการค้นหาเชิงความหมาย
- "หาฟังก์ชันทั้งหมดที่เรียกใช้ฐานข้อมูล" — ทดสอบการค้นหาการพึ่งพา
- "คลาส UserService พึ่งพาอะไรบ้าง?" — ทดสอบการค้นหาสัญลักษณ์
คุณควรเห็นผลลัพธ์ที่มีพาธไฟล์และเลขบรรทัดจากรีโพซิทอรีที่เชื่อมต่อไว้ หากไม่เห็น ให้ตรวจสอบ troubleshooting section ด้านล่าง
รูปแบบรีโพซิทอรี#
เมื่อระบุรีโพซิทอรี:
- ระบุแบรนช์:
"owner/repo:branch"(e.g.,"owner/repository:develop") - แบรนช์เริ่มต้น:
"owner/repo"
เคล็ดลับ: ใช้ repository_context(action="info", repository="...") เพื่อตรวจสอบการจับคู่พื้นที่เก็บโค้ด เซิร์ฟเวอร์ v3 ไม่มีสถานะ ดังนั้นการแทนที่พื้นที่เก็บโค้ดจึงมีผลกับการเรียกเพียงครั้งเดียว
การแก้ไขปัญหา#
ปัญหาเกี่ยวกับคีย์ API#
- ตรวจสอบว่าคีย์ของคุณขึ้นต้นด้วย
mgv_ - ตรวจสอบว่าคีย์ถูกตั้งค่าอย่างถูกต้องในสภาพแวดล้อมของคุณ
- ตรวจสอบว่าคีย์ยังไม่หมดอายุ
ไม่พบรีโพซิทอรี#
- ตรวจสอบว่ารีโพซิทอรีเชื่อมต่อไว้ใน app.maguyva.ai แล้ว
- ตรวจสอบว่ารูปแบบ owner/repo ถูกต้อง
- ตรวจสอบว่าคุณมีสิทธิ์เข้าถึงรีโพซิทอรีนี้
ปัญหาการเชื่อมต่อ MCP#
- ตรวจสอบว่า
npxอยู่ใน PATH ของคุณ - ตรวจสอบว่าโทเคน API ของคุณถูกต้องและยังไม่หมดอายุ
- ทดสอบการเชื่อมต่อไปยัง
https://maguyva.tools/mcp - ตรวจสอบไวยากรณ์การตั้งค่า MCP ของไคลเอนต์คุณ
ขั้นตอนถัดไป#
- คู่มืออ้างอิง MCP API - เอกสาร API ฉบับสมบูรณ์
- วิธีการทำงาน - ทำความเข้าใจการปรับบริบทให้เหมาะสม
- การแก้ไขปัญหา - แก้ปัญหาการตั้งค่าและการเชื่อมต่อ