Zum Inhalt springen

Installationsanleitung

Sei in unter 5 Minuten startklar. Diese Anleitung enthält das Setup für 24 MCP-Clients, darunter Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot und Windsurf und mehr.

Voraussetzungen: Du brauchst einen API-Key von app.maguyva.ai und ein verbundenes GitHub-Repository.

Umgebungseinrichtung#

Legen Sie zuerst Ihren API-Schlüssel in einer Umgebungsvariable fest. Lassen Sie repository weg, wenn Ihr MCP-Client einen Standardwert für die Anfrage bereitstellt oder der Schlüssel auf genau ein Repository zugreifen kann; übergeben Sie es andernfalls ausdrücklich.

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

Ersetze mgv_xxxx durch deinen tatsächlichen API-Key von app.maguyva.ai.

Client-Konfiguration#

Wähle unten deinen MCP-Client für spezifische Einrichtungsanweisungen.

Kompatibilitätshinweis: Maguyva verwendet Standard-MCP. Jeder Client mit MCP-Unterstützung kann sich mit demselben Server verbinden, auch wenn wir noch keine offizielle Einrichtungsanleitung dafür geschrieben haben.

Claude Code

Installiere das Maguyva-Plugin aus dem Claude Code Marketplace:

Füge den Maguyva-Marketplace hinzu und installiere dann das Plugin (führe jeden Befehl innerhalb von Claude Code aus):

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

Installiert für dein Benutzerkonto. Für ein Team füge --scope project zu beiden Befehlen hinzu, um das Plugin in der .claude/settings.json des Repositorys zu committen, damit Teammitglieder es automatisch erhalten.

Das Plugin authentifiziert sich über die Umgebungsvariable MAGUYVA_API_KEY. Setze sie in deiner Shell:

export MAGUYVA_API_KEY=mgv_xxxx

Projektspezifisches direnv (.envrc) wird empfohlen — Keys sind repository-scoped, daher passt ein projektspezifischer Wert zum Zugriff jedes Projekts. Ein globaler Shell-Export funktioniert, wenn ein einziger Key deine gesamte Arbeit abdeckt.

Manuell (.mcp.json) — fortgeschritten
.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"
      }
    }
  }
}

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Claude Code-MCP-Docs →

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

Füge es zu deiner Claude Desktop Konfigurationsdatei hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Claude Desktop unterstützt Remote-Server nur als OAuth-„Connectors“ über die Settings, nicht als header-authentifizierten Eintrag in claude_desktop_config.json — deshalb wird hier die mcp-remote-Bridge verwendet (erfordert Node.js / npx).

Claude Desktop-MCP-Docs →

Cursor

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

Füge es zu .cursor/mcp.json im Stammverzeichnis deines Projekts hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Cursor-MCP-Docs →

VS Code / GitHub Copilot

Füge es zu .vscode/mcp.json in deinem Projekt hinzu (oder zu den Benutzereinstellungen):

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

VS Code / GitHub Copilot-MCP-Docs →

Windsurf

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

Füge es zu deiner Windsurf-MCP-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Windsurf-MCP-Docs →

Codex

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

Füge es zu deiner Codex CLI Konfiguration hinzu (~/.codex/config.toml):

.codex/config.toml
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Codex-MCP-Docs →

GitHub Copilot CLI

Füge es zu .copilot/mcp-config.json hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

GitHub Copilot CLI-MCP-Docs →

Gemini CLI

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

Füge es zu deinen Gemini CLI Einstellungen hinzu (~/.gemini/settings.json):

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Gemini CLI-MCP-Docs →

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

Füge es zu deinen Cline-MCP-Einstellungen hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

Cline-MCP-Docs →

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

Füge es zu deinen Roo Code MCP-Einstellungen hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Roo Code-MCP-Docs →

Goose

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

Füge es zu deiner Goose-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

Goose-MCP-Docs →

LM Studio

LM Studio unterstützt MCP-Server über seine Agent-Konfiguration. Füge unter Settings → Agent → MCP Servers einen neuen MCP-Server im Standard-mcpServers-JSON-Format hinzu. LM Studio verbindet sich über stdio mit MCP-Servern. Docs ansehen →

Continue

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

Füge es zu deiner Continue-Konfiguration hinzu (~/.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"
      }
    }
  }
}

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

Continue-MCP-Docs →

Amazon Q Developer

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

Füge es zu deiner Amazon Q MCP-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

Amazon Q Developer-MCP-Docs →

PyCharm

Füge es zu .ai/mcp/mcp.json im Stammverzeichnis deines Projekts hinzu, oder füge es unter Settings > Tools > AI Assistant > MCP ein:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

PyCharm-MCP-Docs →

Zed

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

Füge es zu deinen Zed-Einstellungen hinzu (~/.config/zed/settings.json):

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Zed-MCP-Docs →

Trae

Füge es zu .trae/mcp.json im Stammverzeichnis deines Projekts hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

Trae-MCP-Docs →

OpenCode

Füge es zu opencode.json im Stammverzeichnis deines Projekts hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

OpenCode-MCP-Docs →

BoltAI

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

Füge es zu deiner BoltAI-MCP-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

BoltAI-MCP-Docs →

LibreChat

Füge es zu deiner LibreChat-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Dieser Client unterstützt noch keinen Remote-MCP-Server mit einem benutzerdefinierten Auth-Header, daher verbindet er sich über die mcp-remote-Bridge (erfordert Node.js / npx). Maguyva läuft vollständig remote — nur die Bridge läuft lokal.

LibreChat-MCP-Docs →

Antigravity

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

Füge es zu deiner Antigravity-MCP-Konfiguration hinzu:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Antigravity-MCP-Docs →

Claude Cowork

Claude Cowork verwendet dasselbe MCP-Format wie andere Anthropic-Clients:

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

Ersetze mgv_xxxx durch deinen API-Key von app.maguyva.ai.

Claude Cowork-MCP-Docs →

ChatGPT

ChatGPT unterstützt Remote-MCP-Server in den Plänen Business, Enterprise und Edu über Settings → Apps → Create. Ein Remote-HTTPS-Endpunkt ist erforderlich — ChatGPT unterstützt keine lokalen stdio-Server. Die Einrichtung ist im MCP-Guide von OpenAI beschrieben. Docs ansehen →

Warp

Warp unterstützt MCP-Server im Agent Mode. Die Konfiguration erfolgt über die Warp-UI (Settings → Agent Mode → MCP Servers) und wird über Warp Drive synchronisiert. Füge beim Hinzufügen eines Servers das Standard-mcpServers-JSON ein. Docs ansehen →

Maguyva verwendet Standard-MCP. Jeder Client, der das Protokoll unterstützt, kann sich verbinden — auch wenn oben keine offizielle Anleitung existiert.24 Clients dokumentiert, weitere kommen regelmäßig dazu.

Überprüfe dein Setup#

Stell deinem Agenten nach dem Verbinden ein paar Fragen:

  • "Welche Repositories habe ich verbunden?" — überprüft, ob die Verbindung funktioniert
  • "Wie wird die Authentifizierung in dieser Codebase gehandhabt?" — testet die semantische Suche
  • "Finde alle Funktionen, die die Datenbank aufrufen" — testet die Abhängigkeitssuche
  • "Wovon hängt die Klasse UserService ab?" — testet Symbol Lookup

Du solltest Ergebnisse mit Dateipfaden und Zeilennummern aus deinem verbundenen Repository sehen. Falls nicht, wirf einen Blick in die troubleshooting section unten.

Repository-Format#

Beim Angeben von Repositories:

  • Mit Branch: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Standard-Branch: "owner/repo"

Tipp: Prüfen Sie mit repository_context(action="info", repository="...") die Repository-Auflösung. Der v3-Server ist zustandslos; Repository-Überschreibungen gelten daher nur für einen Aufruf.

Fehlerbehebung#

API-Key-Probleme#

  • Überprüfe, dass dein Key mit dem Präfix mgv_ beginnt
  • Überprüfe, dass der Key korrekt in deiner Umgebung gesetzt ist
  • Stelle sicher, dass der Key nicht abgelaufen ist

Repository nicht gefunden#

  • Überprüfe, dass das Repository in app.maguyva.ai verbunden ist
  • Überprüfe, dass das Format owner/repo korrekt ist
  • Stelle sicher, dass du Zugriff auf das Repository hast

MCP-Verbindungsprobleme#

  • Überprüfe, dass npx in deinem PATH verfügbar ist
  • Überprüfe, dass dein API-Token gültig und nicht abgelaufen ist
  • Teste die Verbindung zu https://maguyva.tools/mcp
  • Überprüfe die MCP-Konfigurationssyntax deines Clients

Nächste Schritte#