설치 가이드

Claude Code 마켓플레이스에서 Maguyva 플러그인을 설치하세요:

Maguyva 마켓플레이스를 추가한 다음 플러그인을 설치하세요(각 명령어를 Claude Code 안에서 실행합니다):

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

/plugin install을 실행하면 플러그인 세부 정보가 열리고, 여기서 설치 범위를 선택합니다: 나만(user), 이 저장소에서 작업하는 모든 사람(project), 이 저장소에서 나만(local). 이 세션 내 명령어에는 --scope 플래그가 없습니다.

플러그인은 MAGUYVA_API_KEY 환경 변수를 통해 인증합니다. 셸에서 이를 설정하세요:

export MAGUYVA_API_KEY=mgv_xxxx

프로젝트별 direnv(.envrc) 사용을 권장합니다 — 키는 저장소 단위이므로, 프로젝트별 값이 각 프로젝트의 접근 권한에 맞아떨어집니다. 하나의 키로 모든 작업을 처리한다면 전역 셸 export도 괜찮습니다.

팀의 경우 대신 Claude Code 밖에서, 저장소 루트에서 두 명령어의 셸 버전을 실행할 수도 있습니다:

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

project 범위는 플러그인을 저장소의 .claude/settings.json에 기록하며, 이 파일을 커밋합니다. 이렇게 하면 팀원에게 플러그인이 켜지지만 다운로드되지는 않으므로, 각 팀원이 설치 명령어를 한 번 실행해야 합니다.

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를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Claude Code에 더해 주는 것 →

Claude Code MCP 문서 →

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %AppData%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Claude Desktop 설정 파일에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

claude_desktop_config.json은 로컬 서버만 시작하므로 이 설정은 @maguyva/mcp 브리지(Node.js / npx 필요)를 씁니다. Claude Desktop은 authorization 요청 헤더가 있는 커스텀 커넥터(Customize → Connectors)로 Maguyva에 연결할 수도 있지만, 요청 헤더는 일부 조직에만 열린 베타 기능입니다.

Maguyva가 Claude Desktop에 더해 주는 것 →

Claude Desktop MCP 문서 →

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 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

Maguyva가 Cursor에 더해 주는 것 →

Cursor MCP 문서 →

프로젝트의 .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 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

이것은 VS Code 형식(servers 키)입니다. VS Code는 자신이 시작된 환경에서 MAGUYVA_API_KEY 참조를 읽습니다. 지금은 Add Server 흐름이 GitHub Copilot CLI도 읽는 이식 가능한 .mcp.json(mcpServers 키)을 우선하지만, 이 파일은 VS Code의 입력 변수와 환경 파일을 지원하지 않습니다.

Maguyva가 VS Code / GitHub Copilot에 더해 주는 것 →

VS Code / GitHub Copilot MCP 문서 →

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 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

기본 에이전트인 Devin Local은 버전 3.6부터 이 파일을 읽습니다. 이전 버전은 서버를 기본 설정 파일에 두었다가 시작할 때 이곳으로 옮깁니다. 새 대화가 시작되는 에이전트가 아닌 예전 Cascade 에이전트도 같은 파일을 읽습니다. Devin Desktop은 자신이 시작된 환경에서 MAGUYVA_API_KEY 참조를 읽습니다.

Maguyva가 Devin Desktop (Windsurf)에 더해 주는 것 →

Devin Desktop (Windsurf) MCP 문서 →

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

Codex CLI 설정(~/.codex/config.toml)에 추가하세요:

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

이 설정은 MAGUYVA_API_KEY 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

Maguyva가 Codex에 더해 주는 것 →

Codex MCP 문서 →

~/.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를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 GitHub Copilot CLI에 더해 주는 것 →

GitHub Copilot CLI MCP 문서 →

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

Gemini CLI 설정(~/.gemini/settings.json)에 추가하세요:

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

이 설정은 MAGUYVA_API_KEY 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

Maguyva가 Gemini CLI에 더해 주는 것 →

Gemini CLI MCP 문서 →

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

Cline MCP 설정에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Cline에 더해 주는 것 →

Cline MCP 문서 →

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

Goose 설정에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Goose에 더해 주는 것 →

Goose MCP 문서 →

LM Studio 오른쪽 사이드바에서 Program 탭을 열고 Install → Edit mcp.json을 고른 뒤 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

LM Studio MCP 문서 →

워크스페이스에 .continue/mcpServers/maguyva.yaml로 저장한 뒤(또는 mcpServers 항목을 ~/.continue/config.yaml에 추가한 뒤), ~/.continue/.env에 MAGUYVA_API_KEY를 설정하세요:

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 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

Continue는 에이전트 모드에서만 MCP 서버를 씁니다. 시크릿은 ~/.continue/.env, 다음으로 워크스페이스의 .continue/.env와 .env, 마지막으로 프로세스 환경에서 찾습니다.

Maguyva가 Continue에 더해 주는 것 →

Continue MCP 문서 →

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

Kiro CLI의 MCP 설정(~/.kiro/settings/mcp.json, 프로젝트라면 .kiro/settings/mcp.json)에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Kiro CLI는 Amazon Q Developer CLI를 대체했습니다. 설치할 때 ~/.aws/amazonq/mcp.json의 서버를 ~/.kiro/settings/mcp.json으로 한 번 복사하며, 프로젝트의 .kiro/settings/mcp.json이 사용자 파일보다 우선합니다.

Kiro CLI (Amazon Q Developer CLI) MCP 문서 →

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를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

이 설정은 @maguyva/mcp 브리지를 사용합니다(Node.js / npx 필요). 이 가이드에서는 이 클라이언트 자체 기능을 사용하는 원격 연결 설정을 아직 검증하지 않았으며, 이것이 클라이언트 자체의 원격 연결 지원이 없다는 뜻은 아닙니다. Maguyva는 전적으로 원격에서 실행되며, 로컬에서 실행되는 것은 브리지뿐입니다.

PyCharm MCP 문서 →

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

Zed 설정(~/.config/zed/settings.json)에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Zed에 더해 주는 것 →

Zed MCP 문서 →

Settings → MCP에서 Enable Project MCP를 켠 뒤, 프로젝트 루트의 .trae/mcp.json에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Trae MCP 문서 →

프로젝트 루트의 opencode.json에 추가하세요:

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

이 설정은 MAGUYVA_API_KEY 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

Maguyva가 OpenCode에 더해 주는 것 →

OpenCode MCP 문서 →

macOS: ~/.boltai/mcp.json

BoltAI MCP 설정에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

이 설정은 @maguyva/mcp 브리지를 사용합니다(Node.js / npx 필요). 이 가이드에서는 이 클라이언트 자체 기능을 사용하는 원격 연결 설정을 아직 검증하지 않았으며, 이것이 클라이언트 자체의 원격 연결 지원이 없다는 뜻은 아닙니다. Maguyva는 전적으로 원격에서 실행되며, 로컬에서 실행되는 것은 브리지뿐입니다.

BoltAI MCP 문서 →

librechat.yaml에 추가하고 LibreChat 서버 환경에 MAGUYVA_API_KEY를 설정하세요:

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

이 설정은 MAGUYVA_API_KEY 환경 변수에서 키를 읽습니다. 클라이언트가 실행되는 환경에서 이 변수를 app.maguyva.ai에서 발급받은 API 키로 설정하세요.

LibreChat MCP 문서 →

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

Antigravity MCP 설정에 추가하세요:

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

mgv_xxxx를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Antigravity에 더해 주는 것 →

Antigravity MCP 문서 →

Claude Cowork는 claude_desktop_config.json의 서버를 불러오지 않고, 원격 서버에는 커스텀 커넥터로 연결합니다. Customize → Connectors에서 URL이 https://maguyva.tools/mcp인 커스텀 커넥터를 추가하고 No sign-in을 고른 뒤, 값이 Bearer와 API 키로 된 authorization 요청 헤더를 추가하세요. 요청 헤더는 일부 조직에만 열린 베타 기능입니다. 대화 상자에 Request headers 섹션이 없다면 Cowork는 아직 Maguyva에 인증할 수 없습니다. 문서 보기 →

ChatGPT는 Business, Enterprise, Edu 플랜에서 Settings → Apps → Create를 통해 원격 MCP 서버를 지원합니다. 원격 HTTPS 엔드포인트가 필요합니다 — ChatGPT는 로컬 stdio 서버를 지원하지 않습니다. 설정 방법은 OpenAI의 MCP 가이드를 참고하세요. 문서 보기 →

~/.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를 app.maguyva.ai에서 발급받은 API 키로 교체하세요.

Maguyva가 Warp에 더해 주는 것 →

Warp MCP 문서 →