Посібник із встановлення

Встановіть плагін 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. Встановіть її у своїй оболонці:

export MAGUYVA_API_KEY=mgv_xxxx

Рекомендується використовувати direnv (.envrc) для кожного проєкту — ключі прив'язані до репозиторію, тож значення для кожного проєкту відповідає доступу цього проєкту. Глобальний shell-експорт підійде, якщо один ключ покриває всю вашу роботу.

Для команди можна натомість виконати shell-варіант обох команд із кореня репозиторію, поза 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 на свій 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

Додайте до файлу конфігурації 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

Додайте до конфігурації 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

Додайте до налаштувань 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 у 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

Додайте до конфігурації 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 у workspace (або додайте запис 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 у workspace, потім в оточенні процесу.

Що 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

Додайте до налаштувань 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 у 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 у 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. Потрібен віддалений HTTPS-ендпоінт — 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 →