インストールガイド

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)の利用を推奨します。APIキーはリポジトリ単位で発行されるため、プロジェクトごとに値を設定しておくと、それぞれのアクセス範囲に一致します。1つのキーですべての作業をカバーできるなら、グローバルなシェルの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キーに置き換えてください。

Claude CodeにMaguyvaが加えるもの →

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はMaguyvaにカスタムコネクター(Customize → Connectors)としてauthorizationリクエストヘッダー付きで接続することもできますが、リクエストヘッダーは一部の組織向けのベータ版です。

Claude DesktopにMaguyvaが加えるもの →

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キーを設定してください。

CursorにMaguyvaが加えるもの →

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の入力変数や環境ファイルに対応していません。

VS Code / GitHub CopilotにMaguyvaが加えるもの →

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の参照を、起動時の環境から解決します。

Devin Desktop (Windsurf)にMaguyvaが加えるもの →

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キーを設定してください。

CodexにMaguyvaが加えるもの →

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キーに置き換えてください。

GitHub Copilot CLIにMaguyvaが加えるもの →

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キーを設定してください。

Gemini CLIにMaguyvaが加えるもの →

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キーに置き換えてください。

ClineにMaguyvaが加えるもの →

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キーに置き換えてください。

GooseにMaguyvaが加えるもの →

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として保存し(または~/.continue/config.yamlにmcpServersエントリを追加し)、~/.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、最後にプロセスの環境変数の順で探します。

ContinueにMaguyvaが加えるもの →

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キーに置き換えてください。

ZedにMaguyvaが加えるもの →

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キーを設定してください。

OpenCodeにMaguyvaが加えるもの →

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キーに置き換えてください。

AntigravityにMaguyvaが加えるもの →

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キーに置き換えてください。

WarpにMaguyvaが加えるもの →

WarpのMCPドキュメント →