Naar inhoud springen

Installatiegids

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

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

Omgeving instellen

#

Stel eerst je API-sleutel in een omgevingsvariabele in. Laat repository weg wanneer je 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/agent-plugins
/plugin install maguyva@maguyva

/plugin install opent de details van de plugin, waar je het installatiebereik kiest: alleen jij (user), iedereen die in deze repository werkt (project), of alleen jij in deze repository (local). Deze opdrachten binnen de sessie hebben geen --scope-vlag.

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.

Voor een team kun je in plaats daarvan de shellvorm van beide opdrachten uitvoeren vanuit de root van de repository, buiten Claude Code:

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

Het bereik project legt de plugin vast in de .claude/settings.json van de repository, die je commit. Daarmee staat de plugin aan voor teamgenoten, maar wordt hij niet gedownload, dus elke teamgenoot voert de installatieopdracht één keer uit.

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

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

Wat Maguyva toevoegt aan Claude Code →

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

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

claude_desktop_config.json start alleen lokale servers, dus deze setup gebruikt de @maguyva/mcp-bridge (vereist Node.js / npx). Claude Desktop kan Maguyva ook bereiken als aangepaste connector (Customize → Connectors) met een authorization-requestheader, maar requestheaders zijn een bèta voor een beperkt aantal organisaties.

Wat Maguyva toevoegt aan Claude Desktop →

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Wat Maguyva toevoegt aan Cursor →

Cursor MCP-documentatie →

VS Code / GitHub Copilot

Voeg toe aan .vscode/mcp.json in je project, of aan de mcp.json van je profiel (voer MCP: Open User Configuration uit):

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Dit is het VS Code-formaat (sleutel servers). VS Code lost de verwijzing naar MAGUYVA_API_KEY op uit de omgeving waarin het start. De Add Server-flow geeft nu de voorkeur aan het draagbare .mcp.json (sleutel mcpServers), dat ook GitHub Copilot CLI leest; dat bestand ondersteunt geen invoervariabelen of omgevingsbestanden van VS Code.

Wat Maguyva toevoegt aan VS Code / GitHub Copilot →

VS Code / GitHub Copilot MCP-documentatie →

Devin Desktop (Windsurf)

macOS: ~/.config/devin/mcp_config.json
Windows: %APPDATA%\devin\mcp_config.json
Linux: ~/.config/devin/mcp_config.json

Windsurf heet nu Devin Desktop. Voeg toe aan het MCP-configuratiebestand:

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Devin Local, de standaardagent, leest dit bestand vanaf versie 3.6; eerdere versies bewaarden servers in het hoofdconfiguratiebestand en verplaatsen ze bij het opstarten hierheen. De oude Cascade-agent, waarmee nieuwe gesprekken niet starten, leest hetzelfde bestand. Devin Desktop lost de verwijzing naar MAGUYVA_API_KEY op uit de omgeving waarin het start.

Wat Maguyva toevoegt aan Devin Desktop (Windsurf) →

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Wat Maguyva toevoegt aan Codex →

Codex MCP-documentatie →

GitHub Copilot CLI

Voeg toe aan ~/.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

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

Wat Maguyva toevoegt aan GitHub Copilot CLI →

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Wat Maguyva toevoegt aan Gemini CLI →

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

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

Wat Maguyva toevoegt aan Cline →

Cline MCP-documentatie →

Goose

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

Voeg toe aan je Goose-configuratie:

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

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

Wat Maguyva toevoegt aan Goose →

Goose MCP-documentatie →

LM Studio

Open in LM Studio het tabblad Program in de rechterzijbalk, kies Install → Edit mcp.json en voeg toe:

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

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

LM Studio MCP-documentatie →

Continue

Sla op als .continue/mcpServers/maguyva.yaml in je workspace (of voeg het mcpServers-item toe aan ~/.continue/config.yaml) en stel daarna MAGUYVA_API_KEY in in ~/.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 }}

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Continue gebruikt MCP-servers alleen in de agentmodus. Het zoekt het secret in ~/.continue/.env, dan in .continue/.env en .env in de workspace, en dan in de procesomgeving.

Wat Maguyva toevoegt aan Continue →

Continue MCP-documentatie →

Kiro CLI (Amazon Q Developer CLI)

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

Voeg toe aan de MCP-configuratie van Kiro CLI (~/.kiro/settings/mcp.json, of .kiro/settings/mcp.json in een project):

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

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

Kiro CLI heeft Amazon Q Developer CLI vervangen. Bij de installatie kopieert het je servers eenmalig van ~/.aws/amazonq/mcp.json naar ~/.kiro/settings/mcp.json, en de .kiro/settings/mcp.json van een project gaat voor op het gebruikersbestand.

Kiro CLI (Amazon Q Developer CLI) MCP-documentatie →

PyCharm

Plak in Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, als JSON-configuratie: 

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

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

Deze configuratie gebruikt de brug @maguyva/mcp (vereist Node.js / npx). Een native configuratie voor externe verbindingen met deze client is voor deze handleiding nog niet geverifieerd; dit betekent niet dat de client geen native ondersteuning voor externe verbindingen biedt. 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 mgv_xxxx"
      }
    }
  }
}

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

Wat Maguyva toevoegt aan Zed →

Zed MCP-documentatie →

Trae

Zet Enable Project MCP aan in Settings → MCP en voeg dan toe aan .trae/mcp.json in de root van je project:

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

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

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

Wat Maguyva toevoegt aan OpenCode →

OpenCode MCP-documentatie →

BoltAI

macOS: ~/.boltai/mcp.json

Voeg toe aan je BoltAI MCP-configuratie:

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

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

Deze configuratie gebruikt de brug @maguyva/mcp (vereist Node.js / npx). Een native configuratie voor externe verbindingen met deze client is voor deze handleiding nog niet geverifieerd; dit betekent niet dat de client geen native ondersteuning voor externe verbindingen biedt. Maguyva draait volledig op afstand — alleen de brug draait lokaal.

BoltAI MCP-documentatie →

LibreChat

Voeg toe aan librechat.yaml en stel MAGUYVA_API_KEY in in de omgeving van de LibreChat-server:

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

Deze configuratie leest je sleutel uit de omgevingsvariabele MAGUYVA_API_KEY. Stel die in op je API-sleutel van app.maguyva.ai, in de omgeving waaruit je client start.

LibreChat MCP-documentatie →

Antigravity

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

Voeg toe aan je Antigravity MCP-configuratie:

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

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

Wat Maguyva toevoegt aan Antigravity →

Antigravity MCP-documentatie →

Claude Cowork

Claude Cowork laadt geen servers uit claude_desktop_config.json; het bereikt externe servers als aangepaste connectors. Voeg in Customize → Connectors een aangepaste connector toe met de URL https://maguyva.tools/mcp, kies No sign-in en voeg een authorization-requestheader toe met als waarde Bearer gevolgd door je API-sleutel. Requestheaders zijn een bèta voor een beperkt aantal organisaties; heeft het dialoogvenster geen sectie Request headers, dan kan Cowork zich nog niet bij Maguyva authenticeren. Bekijk 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

Voeg toe aan ~/.warp/.mcp.json (of .warp/.mcp.json in een project), of plak in Settings → Agents → MCP servers → + Add:

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

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

Wat Maguyva toevoegt aan Warp →

Warp MCP-documentatie →

Maguyva gebruikt standaard-MCP. Elke client die het protocol ondersteunt, kan verbinding maken — ook als we er hierboven geen eigen handleiding voor hebben. Er zijn 23 clients gedocumenteerd; er komen regelmatig nieuwe bij.

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 de repositoryresolutie te controleren. Een expliciet gekozen repository geldt alleen voor de huidige 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

#
  • Als je client de brug @maguyva/mcp gebruikt, controleer dan 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

#

Gerelateerd

Lees verder