Перейти до вмісту

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

Почніть роботу менш ніж за 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) для кожного проєкту — ключі прив'язані до репозиторію, тож значення для кожного проєкту відповідає доступу цього проєкту. Глобальний shell-експорт підійде, якщо один ключ покриває всю вашу роботу.

Вручну (.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-сервери. Інструкції з налаштування дивіться в гайді MCP від OpenAI. Дивитися документацію →

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 вашого клієнта

Наступні кроки#