Přeskočit na obsah

Průvodce instalací

Rozjeďte se za méně než 5 minut. Tento průvodce obsahuje nastavení pro 24 MCP klientů, včetně Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, a Windsurf a dalších.

Požadavky: Budete potřebovat API klíč z app.maguyva.ai a připojený GitHub repozitář.

Nastavení prostředí#

Nejprve nastavte klíč API v proměnné prostředí. repository vynechte, pokud klient MCP poskytuje výchozí hodnotu pro daný požadavek nebo pokud má klíč přístup právě k jednomu repozitáři; jinak jej zadejte explicitně.

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

Nahraďte mgv_xxxx svým skutečným API klíčem z app.maguyva.ai.

Konfigurace klienta#

Níže vyberte svého MCP klienta pro konkrétní pokyny k nastavení.

Poznámka ke kompatibilitě: Maguyva používá standardní MCP. Kterýkoli klient s podporou MCP se může připojit ke stejnému serveru, i když jsme pro něj zatím nenapsali vlastní návod k nastavení.

Claude Code

Nainstalujte plugin Maguyva z marketplace Claude Code:

Přidejte marketplace Maguyva a poté nainstalujte plugin (každý příkaz spusťte uvnitř Claude Code):

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

Nainstaluje se pro váš uživatelský účet. Pro tým přidejte --scope project k oběma příkazům, aby se plugin zapsal do .claude/settings.json repozitáře a týmoví kolegové ho dostali automaticky.

Plugin se autentizuje pomocí proměnné prostředí MAGUYVA_API_KEY. Nastavte ji ve svém shellu:

export MAGUYVA_API_KEY=mgv_xxxx

Doporučujeme direnv (.envrc) pro jednotlivé projekty — klíče jsou vázané na repozitář, takže hodnota pro každý projekt odpovídá jeho přístupu. Globální export v shellu funguje, pokud jeden klíč pokrývá veškerou vaši práci.

Ruční konfigurace (.mcp.json) — pokročilé
.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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro 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

Přidejte do konfiguračního souboru 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Claude Desktop podporuje vzdálené servery jen jako OAuth „konektory“ přes Settings, ne jako položku s autentizací přes hlavičku v claude_desktop_config.json, takže se zde používá most mcp-remote (vyžaduje Node.js / npx).

Dokumentace MCP pro Claude Desktop →

Cursor

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

Přidejte do .cursor/mcp.json v kořeni vašeho projektu:

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Cursor →

VS Code / GitHub Copilot

Přidejte do .vscode/mcp.json ve vašem projektu (nebo do uživatelských nastavení):

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro VS Code / GitHub Copilot →

Windsurf

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

Přidejte do konfigurace MCP ve Windsurf:

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Windsurf →

Codex

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

Přidejte do konfigurace 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}"

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Codex →

GitHub Copilot CLI

Přidejte do .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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro GitHub Copilot CLI →

Gemini CLI

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

Přidejte do nastavení Gemini CLI (~/.gemini/settings.json):

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro 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

Přidejte do nastavení MCP v 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
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro 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

Přidejte do nastavení MCP v Roo Code:

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Roo Code →

Goose

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

Přidejte do konfigurace 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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro Goose →

LM Studio

LM Studio podporuje MCP servery prostřednictvím konfigurace Agent. Přidejte nový MCP server v Settings → Agent → MCP Servers pomocí standardního formátu JSON mcpServers. LM Studio se k MCP serverům připojuje přes stdio. Zobrazit dokumentaci →

Continue

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

Přidejte do konfigurace 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro Continue →

Amazon Q Developer

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

Přidejte do konfigurace MCP v 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro Amazon Q Developer →

PyCharm

Přidejte do .ai/mcp/mcp.json v kořeni vašeho projektu, nebo vložte do 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro PyCharm →

Zed

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

Přidejte do nastavení Zed (~/.config/zed/settings.json):

settings.json
{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGUYVA_API_KEY}"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Zed →

Trae

Přidejte do .trae/mcp.json v kořeni vašeho projektu:

.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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro Trae →

OpenCode

Přidejte do opencode.json v kořeni vašeho projektu:

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro OpenCode →

BoltAI

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

Přidejte do konfigurace MCP v 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro BoltAI →

LibreChat

Přidejte do konfigurace 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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Tento klient zatím nepodporuje vzdálený MCP server s vlastní autentizační hlavičkou, takže se připojuje přes most mcp-remote (vyžaduje Node.js / npx). Maguyva běží celá vzdáleně — lokálně běží jen most.

Dokumentace MCP pro LibreChat →

Antigravity

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

Přidejte do konfigurace MCP v Antigravity:

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

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Antigravity →

Claude Cowork

Claude Cowork používá stejný formát MCP jako ostatní klienti 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"
      }
    }
  }
}

Nahraďte mgv_xxxx svým API klíčem z app.maguyva.ai.

Dokumentace MCP pro Claude Cowork →

ChatGPT

ChatGPT podporuje vzdálené MCP servery v plánech Business, Enterprise a Edu přes Settings → Apps → Create. Je vyžadován vzdálený HTTPS endpoint — ChatGPT nepodporuje lokální stdio servery. Nastavení najdete v příručce OpenAI k MCP. Zobrazit dokumentaci →

Warp

Warp podporuje MCP servery v Agent Mode. Konfigurace se spravuje přes UI Warp (Settings → Agent Mode → MCP Servers) a synchronizuje přes Warp Drive. Při přidávání serveru vložte standardní JSON mcpServers. Zobrazit dokumentaci →

Maguyva používá standardní MCP. Připojit se může jakýkoliv klient podporující tento protokol — i když výše není žádný oficiální návod.24 klientů zdokumentováno, další pravidelně přibývají.

Ověřte své nastavení#

Po připojení zkuste agentovi položit pár otázek:

  • "Jaké repozitáře mám připojené?" — ověří, že připojení funguje
  • "Jak je v této kódové základně řešená autentizace?" — otestuje sémantické vyhledávání
  • "Najdi všechny funkce, které volají databázi" — otestuje vyhledávání závislostí
  • "Na čem závisí třída UserService?" — otestuje vyhledávání symbolů

Měli byste vidět výsledky s cestami k souborům a čísly řádků z vašeho připojeného repozitáře. Pokud ne, podívejte se níže na troubleshooting section.

Formát repozitáře#

Při zadávání repozitářů:

  • S větví: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Výchozí větev: "owner/repo"

Tip: Pomocí repository_context(action="info", repository="...") ověřte rozpoznání repozitáře. Server v3 je bezstavový, takže přepsání repozitáře platí jen pro jedno volání.

Řešení problémů#

Problémy s API klíčem#

  • Ověřte, že váš klíč začíná prefixem mgv_
  • Zkontrolujte, že je klíč správně nastaven ve vašem prostředí
  • Ujistěte se, že klíči nevypršela platnost

Repozitář nenalezen#

  • Ověřte, že je repozitář připojený v app.maguyva.ai
  • Zkontrolujte, že formát owner/repo je správný
  • Ujistěte se, že máte k repozitáři přístup

Problémy s MCP připojením#

  • Ověřte, že je npx dostupné ve vaší PATH
  • Zkontrolujte, že je váš API token platný a nevypršel
  • Otestujte konektivitu na https://maguyva.tools/mcp
  • Zkontrolujte syntaxi MCP konfigurace vašeho klienta

Další kroky#