คู่มือการติดตั้ง

ติดตั้งปลั๊กอิน Maguyva จากมาร์เก็ตเพลสของ Claude Code:

เพิ่มมาร์เก็ตเพลสของ Maguyva แล้วติดตั้งปลั๊กอิน (รันแต่ละคำสั่งภายใน Claude Code):

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

/plugin install จะเปิดรายละเอียดของปลั๊กอิน ซึ่งคุณเลือกขอบเขตการติดตั้งได้: เฉพาะคุณ (user), ทุกคนที่ทำงานในรีโพซิทอรีนี้ (project) หรือเฉพาะคุณในรีโพซิทอรีนี้ (local) คำสั่งภายในเซสชันเหล่านี้ไม่มีแฟล็ก --scope

ปลั๊กอินจะยืนยันตัวตนผ่านตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ตั้งค่ามันไว้ใน shell ของคุณ:

export MAGUYVA_API_KEY=mgv_xxxx

แนะนำให้ใช้ direnv (.envrc) แยกตามโปรเจกต์ — เพราะคีย์ผูกกับแต่ละรีโพซิทอรี ค่าที่แยกตามโปรเจกต์จะตรงกับสิทธิ์การเข้าถึงของแต่ละโปรเจกต์ หรือใช้ shell export แบบโกลบอลก็ได้ถ้าคีย์เดียวครอบคลุมงานทั้งหมดของคุณ

สำหรับทีม คุณสามารถรันคำสั่งทั้งสองในรูปแบบ shell จากไดเรกทอรีรากของรีโพซิทอรีนอก Claude Code แทนได้:

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

ขอบเขต project จะบันทึกปลั๊กอินลงใน .claude/settings.json ของรีโพซิทอรี ซึ่งคุณ commit ไว้ การทำเช่นนี้จะเปิดใช้ปลั๊กอินให้เพื่อนร่วมทีม แต่ไม่ได้ดาวน์โหลดให้ ดังนั้นเพื่อนร่วมทีมแต่ละคนต้องรันคำสั่งติดตั้งหนึ่งครั้ง

claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Claude Code →

เอกสาร MCP ของ Claude Code →

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",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

claude_desktop_config.json เริ่มได้แค่เซิร์ฟเวอร์บนเครื่อง การตั้งค่านี้จึงใช้บริดจ์ @maguyva/mcp (ต้องมี Node.js / npx) Claude Desktop ยังเข้าถึง Maguyva ในรูปแบบคอนเนกเตอร์แบบกำหนดเอง (Customize → Connectors) พร้อมเฮดเดอร์คำขอชื่อ authorization ได้ด้วย แต่เฮดเดอร์คำขอยังเป็นเบตาสำหรับองค์กรจำนวนจำกัด

สิ่งที่ Maguyva เพิ่มให้ Claude Desktop →

เอกสาร MCP ของ Claude Desktop →

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

สิ่งที่ Maguyva เพิ่มให้ Cursor →

เอกสาร MCP ของ Cursor →

เพิ่มใน .vscode/mcp.json ของโปรเจกต์ หรือใน mcp.json ของโปรไฟล์คุณ (รัน MCP: Open User Configuration):

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

นี่คือรูปแบบของ VS Code (คีย์ servers) VS Code อ่านค่าที่อ้างถึง MAGUYVA_API_KEY จากสภาพแวดล้อมที่ใช้เปิดโปรแกรม ปัจจุบันขั้นตอน Add Server เลือกใช้ .mcp.json แบบพกพา (คีย์ mcpServers) ที่ GitHub Copilot CLI อ่านได้ด้วย แต่ไฟล์นั้นไม่รองรับตัวแปรอินพุตหรือไฟล์สภาพแวดล้อมของ VS Code

สิ่งที่ Maguyva เพิ่มให้ VS Code / GitHub Copilot →

เอกสาร MCP ของ VS Code / GitHub Copilot →

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

ตอนนี้ Windsurf คือ Devin Desktop เพิ่มในไฟล์คอนฟิก MCP ของมัน:

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

Devin Local ซึ่งเป็นเอเจนต์ค่าเริ่มต้น อ่านไฟล์นี้ตั้งแต่เวอร์ชัน 3.6 ส่วนเวอร์ชันก่อนหน้าเก็บเซิร์ฟเวอร์ไว้ในไฟล์ตั้งค่าหลักและย้ายมาไว้ที่นี่ตอนเริ่มทำงาน เอเจนต์ Cascade รุ่นเก่าซึ่งบทสนทนาใหม่ไม่ได้เริ่มด้วยก็อ่านไฟล์เดียวกันนี้ Devin Desktop อ่านค่าที่อ้างถึง MAGUYVA_API_KEY จากสภาพแวดล้อมที่ใช้เปิดโปรแกรม

สิ่งที่ Maguyva เพิ่มให้ Devin Desktop (Windsurf) →

เอกสาร MCP ของ Devin Desktop (Windsurf) →

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"
bearer_token_env_var = "MAGUYVA_API_KEY"

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

สิ่งที่ Maguyva เพิ่มให้ Codex →

เอกสาร MCP ของ Codex →

เพิ่มลงใน ~/.copilot/mcp-config.json:

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

copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ GitHub Copilot CLI →

เอกสาร MCP ของ GitHub Copilot 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}"
      }
    }
  }
}

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

สิ่งที่ Maguyva เพิ่มให้ Gemini CLI →

เอกสาร MCP ของ Gemini CLI →

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": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Cline →

เอกสาร MCP ของ Cline →

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

เพิ่มลงใน config ของ Goose:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Goose →

เอกสาร MCP ของ Goose →

ใน LM Studio ให้เปิดแท็บ Program ในแถบด้านขวา เลือก Install → Edit mcp.json แล้วเพิ่ม:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

เอกสาร MCP ของ LM Studio →

บันทึกเป็น .continue/mcpServers/maguyva.yaml ในเวิร์กสเปซ (หรือเพิ่มรายการ mcpServers ใน ~/.continue/config.yaml) แล้วตั้งค่า MAGUYVA_API_KEY ใน ~/.continue/.env:

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

Continue ใช้เซิร์ฟเวอร์ MCP ในโหมดเอเจนต์เท่านั้น โดยหาซีเคร็ตใน ~/.continue/.env ก่อน แล้วจึงเป็น .continue/.env และ .env ของเวิร์กสเปซ และสุดท้ายคือสภาพแวดล้อมของโปรเซส

สิ่งที่ Maguyva เพิ่มให้ Continue →

เอกสาร MCP ของ Continue →

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

เพิ่มในคอนฟิก MCP ของ Kiro CLI (~/.kiro/settings/mcp.json หรือ .kiro/settings/mcp.json ในโปรเจกต์):

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

Kiro CLI มาแทน Amazon Q Developer CLI แล้ว ตอนติดตั้งจะคัดลอกเซิร์ฟเวอร์ของคุณจาก ~/.aws/amazonq/mcp.json ไปยัง ~/.kiro/settings/mcp.json หนึ่งครั้ง และ .kiro/settings/mcp.json ของโปรเจกต์มีลำดับความสำคัญเหนือไฟล์ของผู้ใช้

เอกสาร MCP ของ Kiro CLI (Amazon Q Developer CLI) →

วางใน Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add เป็นคอนฟิก JSON:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

การตั้งค่านี้ใช้บริดจ์ @maguyva/mcp (ต้องมี Node.js / npx) คู่มือนี้ยังไม่ได้ตรวจสอบการกำหนดค่าการเชื่อมต่อระยะไกลแบบเนทีฟสำหรับไคลเอนต์นี้ ซึ่งไม่ได้หมายความว่าไคลเอนต์ไม่รองรับการเชื่อมต่อระยะไกลแบบเนทีฟ Maguyva ทำงานทั้งหมดจากระยะไกล — มีเพียงบริดจ์เท่านั้นที่ทำงานในเครื่อง

เอกสาร MCP ของ PyCharm →

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Zed →

เอกสาร MCP ของ Zed →

เปิด Enable Project MCP ใน Settings → MCP แล้วเพิ่มใน .trae/mcp.json ที่รูทของโปรเจกต์:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

เอกสาร MCP ของ Trae →

เพิ่มลงใน opencode.json ที่รูทของโปรเจกต์:

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

สิ่งที่ Maguyva เพิ่มให้ OpenCode →

เอกสาร MCP ของ OpenCode →

macOS: ~/.boltai/mcp.json

เพิ่มลงใน MCP config ของ BoltAI:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

การตั้งค่านี้ใช้บริดจ์ @maguyva/mcp (ต้องมี Node.js / npx) คู่มือนี้ยังไม่ได้ตรวจสอบการกำหนดค่าการเชื่อมต่อระยะไกลแบบเนทีฟสำหรับไคลเอนต์นี้ ซึ่งไม่ได้หมายความว่าไคลเอนต์ไม่รองรับการเชื่อมต่อระยะไกลแบบเนทีฟ Maguyva ทำงานทั้งหมดจากระยะไกล — มีเพียงบริดจ์เท่านั้นที่ทำงานในเครื่อง

เอกสาร MCP ของ BoltAI →

เพิ่มใน librechat.yaml และตั้งค่า MAGUYVA_API_KEY ในสภาพแวดล้อมของเซิร์ฟเวอร์ LibreChat:

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

การกำหนดค่านี้อ่านคีย์ของคุณจากตัวแปรสภาพแวดล้อม MAGUYVA_API_KEY ให้ตั้งค่าเป็นคีย์ API ของคุณจาก app.maguyva.ai ในสภาพแวดล้อมที่ไคลเอนต์ของคุณเริ่มทำงาน

เอกสาร MCP ของ LibreChat →

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

เพิ่มลงใน MCP config ของ Antigravity:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Antigravity →

เอกสาร MCP ของ Antigravity →

Claude Cowork ไม่โหลดเซิร์ฟเวอร์จาก claude_desktop_config.json แต่เข้าถึงเซิร์ฟเวอร์ระยะไกลในรูปแบบคอนเนกเตอร์แบบกำหนดเอง ใน Customize → Connectors ให้เพิ่มคอนเนกเตอร์แบบกำหนดเองด้วย URL https://maguyva.tools/mcp เลือก No sign-in และเพิ่มเฮดเดอร์คำขอชื่อ authorization ที่มีค่าเป็น Bearer ตามด้วยคีย์ API ของคุณ เฮดเดอร์คำขอยังเป็นเบตาสำหรับองค์กรจำนวนจำกัด หากหน้าต่างไม่มีส่วน Request headers แสดงว่า Cowork ยังยืนยันตัวตนกับ Maguyva ไม่ได้ ดูเอกสาร →

ChatGPT รองรับเซิร์ฟเวอร์ MCP ระยะไกลบนแผน Business, Enterprise และ Edu ผ่าน Settings → Apps → Create ต้องใช้ remote HTTPS endpoint — ChatGPT ไม่รองรับเซิร์ฟเวอร์ stdio ที่รันในเครื่อง ดูคู่มือ MCP ของ OpenAI สำหรับการตั้งค่า ดูเอกสาร →

เพิ่มใน ~/.warp/.mcp.json (หรือ .warp/.mcp.json ในโปรเจกต์) หรือวางใน Settings → Agents → MCP servers → + Add:

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

แทนที่ mgv_xxxx ด้วยคีย์ API ของคุณจาก app.maguyva.ai

สิ่งที่ Maguyva เพิ่มให้ Warp →

เอกสาร MCP ของ Warp →