Spring til indhold

Installationsguide

Kom i gang på under 5 minutter. Denne guide inkluderer opsætning til 24 MCP-klienter, herunder Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, og Windsurf, og flere.

Forudsætninger: Du skal bruge en API-nøgle fra app.maguyva.ai og et forbundet GitHub-repo.

Miljøopsætning#

Angiv først din API-nøgle i en miljøvariabel. Udelad repository, når MCP-klienten angiver en standard for den aktuelle forespørgsel, eller når nøglen har adgang til præcis ét repo; angiv den ellers eksplicit.

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

Erstat mgv_xxxx med din faktiske API-nøgle fra app.maguyva.ai.

Klientkonfiguration#

Vælg din MCP-klient nedenfor for specifikke opsætningsinstruktioner.

Kompatibilitetsnote: Maguyva bruger standard MCP. Enhver klient med MCP-understøttelse kan forbinde til den samme server, selv hvis vi endnu ikke har skrevet en officiel opsætningsguide til den.

Claude Code

Installer Maguyva-pluginet fra Claude Code-markedspladsen:

Tilføj Maguyva-markedspladsen, og installér derefter pluginet (kør hver kommando inde i Claude Code):

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

Installerer til din brugerkonto. For et team skal du tilføje --scope project til begge kommandoer for at committe pluginet til repositoriets .claude/settings.json, så holdkammerater får det automatisk.

Pluginet autentificerer via miljøvariablen MAGUYVA_API_KEY. Sæt den i din shell:

export MAGUYVA_API_KEY=mgv_xxxx

Per-projekt direnv (.envrc) anbefales — nøgler er repository-afgrænsede, så en per-projekt-værdi matcher hvert projekts adgang. En global shell-export virker, hvis én nøgle dækker alt dit arbejde.

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Claude Code MCP-dokumentation →

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

Tilføj til din Claude Desktop-konfigurationsfil:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Claude Desktop understøtter kun eksterne servere som OAuth-"connectors" via Settings, ikke som en header-autentificeret post i claude_desktop_config.json, så dette bruger mcp-remote-broen (kræver Node.js / npx).

Claude Desktop MCP-dokumentation →

Cursor

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

Tilføj til .cursor/mcp.json i din projektrod:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Cursor MCP-dokumentation →

VS Code / GitHub Copilot

Tilføj til .vscode/mcp.json i dit projekt (eller brugerindstillinger):

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

VS Code / GitHub Copilot MCP-dokumentation →

Windsurf

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

Tilføj til din Windsurf MCP-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Windsurf MCP-dokumentation →

Codex

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

Tilføj til din Codex CLI-konfiguration (~/.codex/config.toml):

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

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Codex MCP-dokumentation →

GitHub Copilot CLI

Tilføj til .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"
      }
    }
  }
}

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

GitHub Copilot CLI MCP-dokumentation →

Gemini CLI

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

Tilføj til dine Gemini CLI-indstillinger (~/.gemini/settings.json):

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Gemini CLI MCP-dokumentation →

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

Tilføj til dine Cline MCP-indstillinger:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

Cline MCP-dokumentation →

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

Tilføj til dine Roo Code MCP-indstillinger:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Roo Code MCP-dokumentation →

Goose

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

Tilføj til din Goose-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

Goose MCP-dokumentation →

LM Studio

LM Studio understøtter MCP-servere via sin Agent-konfiguration. Tilføj en ny MCP-server under Settings → Agent → MCP Servers med det almindelige mcpServers JSON-format. LM Studio forbinder til MCP-servere via stdio. Se dokumentation →

Continue

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

Tilføj til din Continue-konfiguration (~/.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"
      }
    }
  }
}

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

Continue MCP-dokumentation →

Amazon Q Developer

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

Tilføj til din Amazon Q MCP-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

Amazon Q Developer MCP-dokumentation →

PyCharm

Tilføj til .ai/mcp/mcp.json i din projektrod, eller indsæt i 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"
      }
    }
  }
}

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

PyCharm MCP-dokumentation →

Zed

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

Tilføj til dine Zed-indstillinger (~/.config/zed/settings.json):

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Zed MCP-dokumentation →

Trae

Tilføj til .trae/mcp.json i din projektrod:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

Trae MCP-dokumentation →

OpenCode

Tilføj til opencode.json i din projektrod:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

OpenCode MCP-dokumentation →

BoltAI

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

Tilføj til din BoltAI MCP-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

BoltAI MCP-dokumentation →

LibreChat

Tilføj til din LibreChat-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Denne klient understøtter endnu ikke en ekstern MCP-server med en brugerdefineret auth-header, så den forbinder via mcp-remote-broen (kræver Node.js / npx). Maguyva kører udelukkende eksternt — kun broen kører lokalt.

LibreChat MCP-dokumentation →

Antigravity

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

Tilføj til din Antigravity MCP-konfiguration:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Antigravity MCP-dokumentation →

Claude Cowork

Claude Cowork bruger samme MCP-format som andre Anthropic-klienter:

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

Erstat mgv_xxxx med din API-nøgle fra app.maguyva.ai.

Claude Cowork MCP-dokumentation →

ChatGPT

ChatGPT understøtter eksterne MCP-servere på Business-, Enterprise- og Edu-planer via Settings → Apps → Create. Et eksternt HTTPS-endpoint er påkrævet — ChatGPT understøtter ikke lokale stdio-servere. Se OpenAIs MCP-guide for opsætning. Se dokumentation →

Warp

Warp understøtter MCP-servere i Agent Mode. Konfiguration håndteres via Warp-brugerfladen (Settings → Agent Mode → MCP Servers) og synkroniseres via Warp Drive. Indsæt det almindelige mcpServers JSON, når du tilføjer en server. Se dokumentation →

Maguyva bruger standard MCP. Enhver klient, der understøtter protokollen, kan forbinde — selvom der ikke findes en officiel guide ovenfor.24 klienter dokumenteret, flere tilføjes løbende.

Validér din opsætning#

Når du er forbundet, så prøv at stille din agent et par spørgsmål:

  • "Hvilke repos har jeg forbundet?" — verificerer, at forbindelsen fungerer
  • "Hvordan håndteres autentificering i denne kodebase?" — tester semantisk søgning
  • "Find alle funktioner, der kalder databasen" — tester afhængighedssøgning
  • "Hvad afhænger UserService-klassen af?" — tester symbolopslag

Du bør se resultater med filstier og linjenumre fra dit forbundne repo. Hvis ikke, så tjek troubleshooting section nedenfor.

Repo-format#

Når du angiver repos:

  • Med branch: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Standardbranch: "owner/repo"

Tip: Brug repository_context(action="info", repository="...") til at kontrollere, hvordan repoet genkendes. v3-serveren er tilstandsløs, så en repo-tilsidesættelse kun gælder for ét kald.

Fejlfinding#

Problemer med API-nøgle#

  • Bekræft at din nøgle starter med præfikset mgv_
  • Tjek at nøglen er sat korrekt i dit miljø
  • Sørg for at nøglen ikke er udløbet

Repo ikke fundet#

  • Bekræft at repoet er forbundet i app.maguyva.ai
  • Tjek at owner/repo-formatet er korrekt
  • Sørg for at du har adgang til repoet

Problemer med MCP-forbindelse#

  • Bekræft at npx er tilgængelig i din PATH
  • Tjek at dit API-token er gyldigt og ikke udløbet
  • Test forbindelsen til https://maguyva.tools/mcp
  • Tjek syntaksen i din klients MCP-konfiguration

Næste skridt#