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

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

Начните работу менее чем за 5 минут. Это руководство включает настройку для 24 MCP-клиентов, включая Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot и 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/claude-code-plugin
/plugin install maguyva@maguyva

Устанавливается для вашего пользовательского аккаунта. Для команды добавьте --scope project к обеим командам, чтобы закоммитить плагин в .claude/settings.json репозитория, и тогда коллеги получат его автоматически.

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

export MAGUYVA_API_KEY=mgv_xxxx

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

Вручную (.mcp.json) — для продвинутых
.mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Документация 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",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Claude Desktop поддерживает удалённые серверы только как OAuth-«коннекторы» через Settings, а не как запись с аутентификацией по заголовку в claude_desktop_config.json, поэтому здесь используется мост mcp-remote (требует Node.js / npx).

Документация 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 ${MAGUYVA_API_KEY}"
      }
    }
  }
}

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

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

VS Code / GitHub Copilot

Добавьте в .vscode/mcp.json в своём проекте (или в пользовательские настройки):

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

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

Документация MCP для VS Code / GitHub Copilot →

Windsurf

macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %UserProfile%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json

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

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

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

Документация MCP для 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"

[mcp_servers.maguyva.http_headers]
Authorization = "Bearer ${MAGUYVA_API_KEY}"

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

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

GitHub Copilot CLI

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

.copilot/mcp-config.json
{
  "servers": {
    "maguyva": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Документация 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}"
      }
    }
  }
}

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

Документация 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": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

Roo Code

macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
Windows: %AppData%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

Добавьте в настройки MCP для Roo Code:

mcp_settings.json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamable-http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

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

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

Goose

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

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

config.yaml
extensions:
  maguyva:
    name: maguyva
    cmd: npx
    args:
      - -y
      - mcp-remote
      - https://maguyva.tools/mcp
      - --header
      - "Authorization: Bearer ${MAGUYVA_API_KEY}"
    enabled: true
    envs:
      MAGUYVA_API_KEY: mgv_xxxx
    type: stdio

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

LM Studio

LM Studio поддерживает MCP-серверы через конфигурацию Agent. Добавьте новый MCP-сервер в Settings → Agent → MCP Servers, используя стандартный JSON-формат mcpServers. LM Studio подключается к MCP-серверам через stdio. Документация →

Continue

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

Добавьте в конфигурацию Continue (~/.continue/config.json):

config.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

Amazon Q Developer

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

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

mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

PyCharm

Добавьте в .ai/mcp/mcp.json в корне проекта или вставьте в Settings > Tools > AI Assistant > MCP:

.ai/mcp/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует 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 ${MAGUYVA_API_KEY}"
      }
    }
  }
}

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

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

Trae

Добавьте в .trae/mcp.json в корне проекта:

.trae/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

OpenCode

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

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

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

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

BoltAI

macOS: ~/Library/Application Support/BoltAI/mcp_config.json

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

mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

LibreChat

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

librechat.yaml
mcpServers:
  maguyva:
    command: npx
    args:
      - -y
      - mcp-remote
      - https://maguyva.tools/mcp
      - --header
      - "Authorization: Bearer ${MAGUYVA_API_KEY}"
    env:
      MAGUYVA_API_KEY: mgv_xxxx

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

Этот клиент пока не поддерживает удалённый MCP-сервер с пользовательским заголовком аутентификации, поэтому подключение идёт через мост mcp-remote (требует Node.js / npx). Maguyva полностью работает удалённо — локально запускается только мост.

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

Antigravity

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

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

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

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

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

Claude Cowork

Claude Cowork использует тот же формат MCP, что и другие клиенты Anthropic:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

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

ChatGPT

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

Warp

Warp поддерживает MCP-серверы в Agent Mode. Конфигурация управляется через интерфейс Warp (Settings → Agent Mode → MCP Servers) и синхронизируется через Warp Drive. При добавлении сервера вставьте стандартный JSON mcpServers. Документация →

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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