Přeskočit na obsah

Průvodce instalací

Rozjeďte se za méně než 5 minut. Tento průvodce obsahuje nastavení pro 23 MCP klientů, včetně Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, a Devin Desktop (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/agent-plugins
/plugin install maguyva@maguyva

/plugin install otevře podrobnosti pluginu, kde zvolíte rozsah instalace: jen vy (user), všichni, kdo pracují v tomto repozitáři (project), nebo jen vy v tomto repozitáři (local). Tyto příkazy v relaci nemají příznak --scope.

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.

Pro tým můžete místo toho spustit shellovou podobu obou příkazů z kořene repozitáře, mimo Claude Code:

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

Rozsah project zapíše plugin do souboru .claude/settings.json v repozitáři, který commitnete. Tím se plugin týmu zapne, ale nestáhne, takže každý člen týmu spustí instalační příkaz jednou.

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

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

Co Maguyva přidá do Claude Code →

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",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

claude_desktop_config.json spouští jen lokální servery, proto toto nastavení používá most @maguyva/mcp (vyžaduje Node.js / npx). Claude Desktop se k Maguyva umí připojit i jako vlastní konektor (Customize → Connectors) s hlavičkou požadavku authorization, ale hlavičky požadavků jsou v betě pro omezený počet organizací.

Co Maguyva přidá do Claude Desktop →

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 ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Co Maguyva přidá do Cursor →

Dokumentace MCP pro Cursor →

VS Code / GitHub Copilot

Přidejte do .vscode/mcp.json v projektu, nebo do mcp.json svého profilu (spusťte MCP: Open User Configuration):

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

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Tohle je formát VS Code (klíč servers). VS Code vezme odkaz na MAGUYVA_API_KEY z prostředí, ve kterém startuje. Průvodce Add Server teď upřednostňuje přenositelný .mcp.json (klíč mcpServers), který čte i GitHub Copilot CLI; ten soubor nepodporuje vstupní proměnné ani soubory prostředí VS Code.

Co Maguyva přidá do VS Code / GitHub Copilot →

Dokumentace MCP pro 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 se teď jmenuje Devin Desktop. Přidejte do jeho konfiguračního souboru MCP:

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

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Výchozí agent Devin Local čte tento soubor od verze 3.6; starší verze držely servery v hlavním konfiguračním souboru a při startu je přesunou sem. Starší agent Cascade, se kterým nové konverzace nezačínají, čte stejný soubor. Devin Desktop vezme odkaz na MAGUYVA_API_KEY z prostředí, ve kterém startuje.

Co Maguyva přidá do Devin Desktop (Windsurf) →

Dokumentace MCP pro Devin Desktop (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"
bearer_token_env_var = "MAGUYVA_API_KEY"

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Co Maguyva přidá do Codex →

Dokumentace MCP pro Codex →

GitHub Copilot CLI

Přidejte do ~/.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

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

Co Maguyva přidá do GitHub Copilot CLI →

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

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Co Maguyva přidá do Gemini CLI →

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": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

Co Maguyva přidá do Cline →

Dokumentace MCP pro Cline →

Goose

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

Přidejte do konfigurace Goose:

config.yaml 
extensions:
  maguyva:
    name: maguyva
    type: streamable_http
    uri: https://maguyva.tools/mcp
    enabled: true
    headers:
      Authorization: Bearer mgv_xxxx
    timeout: 300

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

Co Maguyva přidá do Goose →

Dokumentace MCP pro Goose →

LM Studio

V LM Studio otevřete kartu Program v pravém postranním panelu, zvolte Install → Edit mcp.json a přidejte:

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

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

Dokumentace MCP pro LM Studio →

Continue

Uložte jako .continue/mcpServers/maguyva.yaml ve workspace (nebo přidejte položku mcpServers do ~/.continue/config.yaml) a pak nastavte MAGUYVA_API_KEY v ~/.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 }}

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Continue používá MCP servery jen v režimu agenta. Secret hledá v ~/.continue/.env, pak v .continue/.env a .env ve workspace a nakonec v prostředí procesu.

Co Maguyva přidá do Continue →

Dokumentace MCP pro Continue →

Kiro CLI (Amazon Q Developer CLI)

macOS: ~/.kiro/settings/mcp.json
Windows: %USERPROFILE%\.kiro\settings\mcp.json
Linux: ~/.kiro/settings/mcp.json

Přidejte do MCP konfigurace Kiro CLI (~/.kiro/settings/mcp.json, nebo .kiro/settings/mcp.json v projektu):

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

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

Kiro CLI nahradilo Amazon Q Developer CLI. Při instalaci jednou zkopíruje vaše servery z ~/.aws/amazonq/mcp.json do ~/.kiro/settings/mcp.json a soubor .kiro/settings/mcp.json v projektu má přednost před uživatelským souborem.

Dokumentace MCP pro Kiro CLI (Amazon Q Developer CLI) →

PyCharm

Vložte do Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add jako konfiguraci JSON: 

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Toto nastavení používá most @maguyva/mcp (vyžaduje Node.js / npx). Konfigurace nativního vzdáleného připojení pro tohoto klienta nebyla pro tuto příručku ověřena; neznamená to, že klient nemá nativní podporu vzdáleného připojení. Maguyva běží zcela vzdáleně — lokálně běží pouze 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 mgv_xxxx"
      }
    }
  }
}

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

Co Maguyva přidá do Zed →

Dokumentace MCP pro Zed →

Trae

Zapněte Enable Project MCP v Settings → MCP a pak přidejte do .trae/mcp.json v kořeni projektu:

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

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

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 {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Co Maguyva přidá do OpenCode →

Dokumentace MCP pro OpenCode →

BoltAI

macOS: ~/.boltai/mcp.json

Přidejte do konfigurace MCP v BoltAI:

mcp.json 
{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Toto nastavení používá most @maguyva/mcp (vyžaduje Node.js / npx). Konfigurace nativního vzdáleného připojení pro tohoto klienta nebyla pro tuto příručku ověřena; neznamená to, že klient nemá nativní podporu vzdáleného připojení. Maguyva běží zcela vzdáleně — lokálně běží pouze most.

Dokumentace MCP pro BoltAI →

LibreChat

Přidejte do librechat.yaml a nastavte MAGUYVA_API_KEY v prostředí serveru LibreChat:

librechat.yaml 
mcpServers:
  maguyva:
    type: streamable-http
    url: https://maguyva.tools/mcp
    headers:
      Authorization: Bearer ${MAGUYVA_API_KEY}
    requiresOAuth: false

Tato konfigurace čte klíč z proměnné prostředí MAGUYVA_API_KEY. Nastavte ji na svůj API klíč z app.maguyva.ai v prostředí, ze kterého se klient spouští.

Dokumentace MCP pro LibreChat →

Antigravity

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

Přidejte do konfigurace MCP v Antigravity:

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

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

Co Maguyva přidá do Antigravity →

Dokumentace MCP pro Antigravity →

Claude Cowork

Claude Cowork nenačítá servery z claude_desktop_config.json; ke vzdáleným serverům se dostane jako k vlastním konektorům. V Customize → Connectors přidejte vlastní konektor s URL https://maguyva.tools/mcp, zvolte No sign-in a přidejte hlavičku požadavku authorization s hodnotou Bearer a vaším API klíčem. Hlavičky požadavků jsou v betě pro omezený počet organizací; pokud dialog nemá sekci Request headers, Cowork se k Maguyva zatím ověřit nedokáže. Zobrazit dokumentaci →

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

Přidejte do ~/.warp/.mcp.json (nebo .warp/.mcp.json v projektu), nebo vložte do Settings → Agents → MCP servers → + Add:

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

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

Co Maguyva přidá do Warp →

Dokumentace MCP pro Warp →

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. 23 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="...") zkontrolujte rozpoznání repozitáře. Přepsání výchozího repozitáře platí jen pro aktuální 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

#
  • Pokud váš klient používá můstek @maguyva/mcp, ověřte, že je npx dostupné v 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

#

Související

Čtěte dál