Перейти к содержимому

Руководство по установке

Начните работу менее чем за 5 минут. Это руководство включает настройку для 23 MCP-клиентов, включая Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot и Devin Desktop (Windsurf) и другие.

Предварительные требования: вам понадобится API-ключ из app.maguyva.ai и подключённый репозиторий GitHub.

Настройка окружения

#

Сначала задайте ключ API в переменной среды. Не указывайте repository, если MCP-клиент задаёт значение по умолчанию для запроса или ключ имеет доступ ровно к одному репозиторию; в остальных случаях передайте его явно.

macOS/Linux (Bash/Zsh)

# 
# Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc  # reload

Windows (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/agent-plugins
/plugin install maguyva@maguyva

/plugin install открывает сведения о плагине, где вы выбираете область установки: только вы (user), все, кто работает в этом репозитории (project), или только вы в этом репозитории (local). У этих команд внутри сеанса нет флага --scope.

Плагин аутентифицируется через переменную окружения MAGUYVA_API_KEY. Задайте её в своей оболочке:

export MAGUYVA_API_KEY=mgv_xxxx

Рекомендуется direnv на уровне проекта (.envrc) — ключи привязаны к репозиторию, поэтому значение для каждого проекта соответствует доступу этого проекта. Глобальный export в оболочке подойдёт, если один ключ покрывает всю вашу работу.

Для команды можно вместо этого выполнить shell-вариант обеих команд из корня репозитория, вне Claude Code:

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

Область project записывает плагин в .claude/settings.json репозитория, который вы коммитите. Это включает плагин для коллег, но не скачивает его, поэтому каждый коллега один раз выполняет команду установки.

Вручную (.mcp.json) — для продвинутых
claude mcp add 
claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'
.mcp.json 
{
  "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 →

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

Добавьте в конфигурационный файл Claude Desktop:

claude_desktop_config.json 
{
  "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 →

Cursor

macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Добавьте в .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 →

VS Code / GitHub Copilot

Добавьте в .vscode/mcp.json проекта или в mcp.json профиля (выполните MCP: Open User Configuration):

.vscode/mcp.json 
{
  "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 →

Devin Desktop (Windsurf)

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

Windsurf теперь называется Devin Desktop. Добавьте в его файл конфигурации MCP:

mcp_config.json 
{
  "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) →

Codex

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

Добавьте в конфигурацию Codex CLI (~/.codex/config.toml):

.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 →

GitHub Copilot CLI

Добавьте в ~/.copilot/mcp-config.json:

~/.copilot/mcp-config.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
copilot mcp add 
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 →

Gemini CLI

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

Добавьте в настройки Gemini CLI (~/.gemini/settings.json):

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 →

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 для Cline:

cline_mcp_settings.json 
{
  "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 →

Goose

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

Добавьте в конфигурацию Goose:

config.yaml 
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

В LM Studio откройте вкладку Program на правой боковой панели, выберите Install → Edit mcp.json и добавьте:

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

Замените mgv_xxxx на свой API-ключ из app.maguyva.ai.

Документация MCP для LM Studio →

Continue

Сохраните как .continue/mcpServers/maguyva.yaml в workspace (или добавьте запись mcpServers в ~/.continue/config.yaml), затем задайте MAGUYVA_API_KEY в ~/.continue/.env:

.continue/mcpServers/maguyva.yaml 
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 →

Kiro CLI (Amazon Q Developer CLI)

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 в проекте):

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) →

PyCharm

Вставьте в 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 →

Zed

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

Добавьте в настройки Zed (~/.config/zed/settings.json):

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 →

Trae

Включите Enable Project MCP в Settings → MCP, затем добавьте в .trae/mcp.json в корне проекта:

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

Замените mgv_xxxx на свой API-ключ из app.maguyva.ai.

Документация MCP для Trae →

OpenCode

Добавьте в opencode.json в корне проекта:

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 →

BoltAI

macOS: ~/.boltai/mcp.json

Добавьте в конфигурацию MCP для BoltAI:

mcp.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 для BoltAI →

LibreChat

Добавьте в librechat.yaml и задайте MAGUYVA_API_KEY в окружении сервера LibreChat:

librechat.yaml 
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 →

Antigravity

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

Добавьте в конфигурацию MCP для Antigravity:

mcp_config.json 
{
  "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 Cowork не загружает серверы из claude_desktop_config.json; к удалённым серверам он подключается как к пользовательским коннекторам. В Customize → Connectors добавьте пользовательский коннектор с URL https://maguyva.tools/mcp, выберите No sign-in и добавьте заголовок запроса authorization со значением Bearer и вашим API-ключом. Заголовки запросов пока в бете для ограниченного числа организаций; если в диалоге нет раздела Request headers, Cowork пока не может пройти аутентификацию в Maguyva. Документация →

ChatGPT

ChatGPT поддерживает удалённые MCP-серверы на планах Business, Enterprise и Edu через Settings → Apps → Create. Требуется удалённый HTTPS-эндпоинт — ChatGPT не поддерживает локальные stdio-серверы. Инструкции по настройке см. в гайде OpenAI по MCP. Документация →

Warp

Добавьте в ~/.warp/.mcp.json (или .warp/.mcp.json в проекте) либо вставьте в Settings → Agents → MCP servers → + Add:

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

Замените mgv_xxxx на свой API-ключ из app.maguyva.ai.

Что Maguyva даёт Warp →

Документация MCP для Warp →

Maguyva использует стандартный MCP. Подключиться может любой клиент, поддерживающий протокол, — даже если официального руководства выше нет. Задокументировано 23 клиентов, список регулярно пополняется.

Проверьте настройку

#

После подключения задайте агенту несколько вопросов:

  • "Какие репозитории у меня подключены?" — проверяет, что соединение работает
  • "Как в этой кодовой базе реализована аутентификация?" — проверяет семантический поиск
  • "Найди все функции, которые обращаются к базе данных" — проверяет поиск зависимостей
  • "От чего зависит класс UserService?" — проверяет поиск символов

Вы должны увидеть результаты с путями к файлам и номерами строк из вашего подключённого репозитория. Если этого не произошло, посмотрите раздел troubleshooting section ниже.

Формат репозитория

#

При указании репозиториев:

  • С указанием ветки: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Ветка по умолчанию: "owner/repo"

Совет: проверьте разрешение репозитория с помощью repository_context(action="info", repository="..."). Переопределение репозитория действует только для текущего вызова.

Устранение неполадок

#

Проблемы с API-ключом

#
  • Убедитесь, что ваш ключ начинается с префикса mgv_
  • Проверьте, что ключ правильно задан в переменных окружения
  • Убедитесь, что срок действия ключа не истёк

Репозиторий не найден

#
  • Убедитесь, что репозиторий подключён в app.maguyva.ai
  • Проверьте, что формат owner/repo указан правильно
  • Убедитесь, что у вас есть доступ к репозиторию

Проблемы с подключением по MCP

#
  • Если клиент использует мост @maguyva/mcp, убедитесь, что npx доступен в PATH
  • Проверьте, что ваш API-токен действителен и не истёк
  • Проверьте соединение с https://maguyva.tools/mcp
  • Проверьте синтаксис MCP-конфигурации вашего клиента

Дальнейшие шаги

#

По теме

Читать дальше