Naar inhoud springen

Installatiegids

Binnen 5 minuten aan de slag. Deze gids bevat installatie-instructies voor 24 MCP-clients, waaronder Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, en Windsurf, en meer.

Vereisten: je hebt een API-sleutel van app.maguyva.ai nodig en een verbonden GitHub-repository.

Omgeving instellen#

Stel eerst uw API-sleutel in een omgevingsvariabele in. Laat repository weg wanneer uw MCP-client een standaardwaarde voor het verzoek opgeeft of wanneer de sleutel toegang heeft tot precies één repository; geef deze anders expliciet door.

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

Vervang mgv_xxxx door je eigen API-sleutel van app.maguyva.ai.

Clientconfiguratie#

Kies hieronder je MCP-client voor specifieke installatie-instructies.

Compatibiliteitsopmerking: Maguyva gebruikt standaard MCP. Elke client met MCP-ondersteuning kan verbinding maken met dezelfde server, ook als wij er nog geen first-party installatiehandleiding voor hebben geschreven.

Claude Code

Installeer de Maguyva-plugin vanuit de Claude Code-marketplace:

Voeg de Maguyva-marketplace toe en installeer dan de plugin (voer elke opdracht uit binnen Claude Code):

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

Installeert voor je gebruikersaccount. Voeg voor een team --scope project toe aan beide opdrachten om de plugin vast te leggen in de .claude/settings.json van de repository, zodat teamgenoten hem automatisch krijgen.

De plugin authenticeert via de omgevingsvariabele MAGUYVA_API_KEY. Stel deze in je shell in:

export MAGUYVA_API_KEY=mgv_xxxx

Per-project direnv (.envrc) wordt aanbevolen — sleutels zijn repository-gebonden, dus een waarde per project komt overeen met de toegang van elk project. Een globale shell-export werkt als één sleutel al je werk dekt.

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Claude Code MCP-documentatie →

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

Voeg toe aan je Claude Desktop-configuratiebestand:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Claude Desktop ondersteunt remote servers alleen als OAuth-"connectors" via Settings, niet als een met een header geauthenticeerde vermelding in claude_desktop_config.json, dus dit gebruikt de mcp-remote-brug (vereist Node.js / npx).

Claude Desktop MCP-documentatie →

Cursor

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

Voeg toe aan .cursor/mcp.json in de root van je project:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Cursor MCP-documentatie →

VS Code / GitHub Copilot

Voeg toe aan .vscode/mcp.json in je project (of gebruikersinstellingen):

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

VS Code / GitHub Copilot MCP-documentatie →

Windsurf

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

Voeg toe aan je Windsurf MCP-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Windsurf MCP-documentatie →

Codex

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

Voeg toe aan je Codex CLI-configuratie (~/.codex/config.toml):

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

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Codex MCP-documentatie →

GitHub Copilot CLI

Voeg toe aan .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"
      }
    }
  }
}

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

GitHub Copilot CLI MCP-documentatie →

Gemini CLI

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

Voeg toe aan je Gemini CLI-instellingen (~/.gemini/settings.json):

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Gemini CLI MCP-documentatie →

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

Voeg toe aan je Cline MCP-instellingen:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

Cline MCP-documentatie →

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

Voeg toe aan je Roo Code MCP-instellingen:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Roo Code MCP-documentatie →

Goose

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

Voeg toe aan je Goose-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

Goose MCP-documentatie →

LM Studio

LM Studio ondersteunt MCP-servers via de Agent-configuratie. Voeg een nieuwe MCP-server toe in Settings → Agent → MCP Servers met het standaard mcpServers JSON-formaat. LM Studio verbindt met MCP-servers via stdio. Bekijk documentatie →

Continue

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

Voeg toe aan je Continue-configuratie (~/.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"
      }
    }
  }
}

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

Continue MCP-documentatie →

Amazon Q Developer

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

Voeg toe aan je Amazon Q MCP-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

Amazon Q Developer MCP-documentatie →

PyCharm

Voeg toe aan .ai/mcp/mcp.json in de root van je project, of plak in 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"
      }
    }
  }
}

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

PyCharm MCP-documentatie →

Zed

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

Voeg toe aan je Zed-instellingen (~/.config/zed/settings.json):

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Zed MCP-documentatie →

Trae

Voeg toe aan .trae/mcp.json in de root van je project:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

Trae MCP-documentatie →

OpenCode

Voeg toe aan opencode.json in de root van je project:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

OpenCode MCP-documentatie →

BoltAI

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

Voeg toe aan je BoltAI MCP-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

BoltAI MCP-documentatie →

LibreChat

Voeg toe aan je LibreChat-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Deze client ondersteunt nog geen remote MCP-server met een aangepaste auth-header, dus deze verbindt via de mcp-remote-brug (vereist Node.js / npx). Maguyva draait volledig op afstand — alleen de brug draait lokaal.

LibreChat MCP-documentatie →

Antigravity

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

Voeg toe aan je Antigravity MCP-configuratie:

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

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Antigravity MCP-documentatie →

Claude Cowork

Claude Cowork gebruikt hetzelfde MCP-formaat als 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"
      }
    }
  }
}

Vervang mgv_xxxx door je API-sleutel van app.maguyva.ai.

Claude Cowork MCP-documentatie →

ChatGPT

ChatGPT ondersteunt remote MCP-servers op Business-, Enterprise- en Edu-plannen via Settings → Apps → Create. Een remote HTTPS-endpoint is vereist — ChatGPT ondersteunt geen lokale stdio-servers. Zie de MCP-handleiding van OpenAI voor de installatie. Bekijk documentatie →

Warp

Warp ondersteunt MCP-servers in Agent Mode. De configuratie wordt beheerd via de Warp-interface (Settings → Agent Mode → MCP Servers) en gesynchroniseerd via Warp Drive. Plak de standaard mcpServers JSON bij het toevoegen van een server. Bekijk documentatie →

Maguyva gebruikt standaard-MCP. Elke client die het protocol ondersteunt kan verbinden — ook als er hierboven geen eigen gids staat.24 clients gedocumenteerd, met regelmatig meer toegevoegd.

Controleer je installatie#

Stel je agent na het verbinden een paar vragen:

  • "Welke repositories heb ik verbonden?" — controleert of de verbinding werkt
  • "Hoe wordt authenticatie afgehandeld in deze codebase?" — test semantisch zoeken
  • "Zoek alle functies die de database aanroepen" — test dependency-analyse
  • "Waarvan is de UserService-klasse afhankelijk?" — test symbolen opzoeken

Je zou resultaten moeten zien met bestandspaden en regelnummers uit je verbonden repository. Zo niet, raadpleeg dan de troubleshooting section hieronder.

Repository-indeling#

Bij het opgeven van repositories:

  • Met branch: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Standaardbranch: "owner/repo"

Tip: Gebruik repository_context(action="info", repository="...") om te controleren hoe de repository wordt herkend. De v3-server is staatloos, dus een repository-override geldt voor slechts één aanroep.

Probleemoplossing#

Problemen met de API-sleutel#

  • Controleer of je sleutel begint met het voorvoegsel mgv_
  • Controleer of de sleutel correct is ingesteld in je omgeving
  • Zorg dat de sleutel niet is verlopen

Repository niet gevonden#

  • Controleer of de repository is verbonden in app.maguyva.ai
  • Controleer of de indeling owner/repo correct is
  • Zorg dat je toegang hebt tot de repository

Problemen met de MCP-verbinding#

  • Controleer of npx beschikbaar is in je PATH
  • Controleer of je API-token geldig is en niet is verlopen
  • Test de connectiviteit met https://maguyva.tools/mcp
  • Controleer de syntaxis van de MCP-configuratie van je client

Volgende stappen#