Spring til indhold

Installationsguide

Kom i gang på under 5 minutter. Denne guide inkluderer opsætning til 23 MCP-klienter, herunder Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, og Devin Desktop (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/agent-plugins
/plugin install maguyva@maguyva

/plugin install åbner pluginets detaljer, hvor du vælger installationsomfang: kun dig (user), alle, der arbejder i dette repository (project), eller kun dig i dette repository (local). Disse kommandoer i sessionen har intet --scope-flag.

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.

For et team kan du i stedet køre shell-formen af begge kommandoer fra repositoriets rod, uden for Claude Code:

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

Omfanget project registrerer pluginet i repositoriets .claude/settings.json, som du committer. Det slår pluginet til for holdkammerater, men downloader det ikke, så hver holdkammerat kører installationskommandoen én gang.

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

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

Det tilføjer Maguyva til Claude Code →

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

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

claude_desktop_config.json starter kun lokale servere, så denne opsætning bruger @maguyva/mcp-broen (kræver Node.js / npx). Claude Desktop kan også nå Maguyva som en brugerdefineret connector (Customize → Connectors) med en authorization-request-header, men request-headers er i beta for et begrænset antal organisationer.

Det tilføjer Maguyva til Claude Desktop →

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Det tilføjer Maguyva til Cursor →

Cursor MCP-dokumentation →

VS Code / GitHub Copilot

Føj til .vscode/mcp.json i dit projekt eller til din profils mcp.json (kør MCP: Open User Configuration):

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Dette er VS Code-formatet (nøglen servers). VS Code slår referencen til MAGUYVA_API_KEY op i det miljø, det starter i. Add Server-forløbet foretrækker nu den portable .mcp.json (nøglen mcpServers), som GitHub Copilot CLI også læser; den fil understøtter ikke VS Codes inputvariabler eller miljøfiler.

Det tilføjer Maguyva til VS Code / GitHub Copilot →

VS Code / GitHub Copilot MCP-dokumentation →

Devin Desktop (Windsurf)

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

Windsurf hedder nu Devin Desktop. Føj til dens MCP-konfigurationsfil:

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Devin Local, standardagenten, læser denne fil fra version 3.6; ældre versioner gemte servere i hovedkonfigurationsfilen og flytter dem hertil ved opstart. Den ældre Cascade-agent, som nye samtaler ikke starter med, læser den samme fil. Devin Desktop slår referencen til MAGUYVA_API_KEY op i det miljø, det starter i.

Det tilføjer Maguyva til Devin Desktop (Windsurf) →

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Det tilføjer Maguyva til Codex →

Codex MCP-dokumentation →

GitHub Copilot CLI

Tilføj til ~/.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

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

Det tilføjer Maguyva til GitHub Copilot CLI →

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Det tilføjer Maguyva til Gemini CLI →

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

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

Det tilføjer Maguyva til Cline →

Cline MCP-dokumentation →

Goose

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

Tilføj til din Goose-konfiguration:

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

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

Det tilføjer Maguyva til Goose →

Goose MCP-dokumentation →

LM Studio

Åbn fanen Program i højre sidepanel i LM Studio, vælg Install → Edit mcp.json, og tilføj:

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

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

LM Studio MCP-dokumentation →

Continue

Gem som .continue/mcpServers/maguyva.yaml i dit workspace (eller føj mcpServers-posten til ~/.continue/config.yaml), og sæt så MAGUYVA_API_KEY i ~/.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 }}

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Continue bruger kun MCP-servere i agenttilstand. Det leder efter hemmeligheden i ~/.continue/.env, derefter i .continue/.env og .env i workspacet og til sidst i procesmiljøet.

Det tilføjer Maguyva til Continue →

Continue MCP-dokumentation →

Kiro CLI (Amazon Q Developer CLI)

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

Føj til MCP-konfigurationen for Kiro CLI (~/.kiro/settings/mcp.json, eller .kiro/settings/mcp.json i et projekt):

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

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

Kiro CLI har afløst Amazon Q Developer CLI. Ved installationen kopieres dine servere én gang fra ~/.aws/amazonq/mcp.json til ~/.kiro/settings/mcp.json, og et projekts .kiro/settings/mcp.json har forrang for brugerfilen.

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

PyCharm

Indsæt under Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add som JSON-konfiguration: 

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

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

Denne opsætning bruger broen @maguyva/mcp (kræver Node.js / npx). En konfiguration, der bruger denne klients indbyggede understøttelse af fjernforbindelser, er ikke verificeret i denne vejledning; det betyder ikke, at klienten mangler denne understøttelse. 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 mgv_xxxx"
      }
    }
  }
}

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

Det tilføjer Maguyva til Zed →

Zed MCP-dokumentation →

Trae

Slå Enable Project MCP til under Settings → MCP, og føj derefter til .trae/mcp.json i projektets rod:

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

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

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

Det tilføjer Maguyva til OpenCode →

OpenCode MCP-dokumentation →

BoltAI

macOS: ~/.boltai/mcp.json

Tilføj til din BoltAI MCP-konfiguration:

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

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

Denne opsætning bruger broen @maguyva/mcp (kræver Node.js / npx). En konfiguration, der bruger denne klients indbyggede understøttelse af fjernforbindelser, er ikke verificeret i denne vejledning; det betyder ikke, at klienten mangler denne understøttelse. Maguyva kører udelukkende eksternt — kun broen kører lokalt.

BoltAI MCP-dokumentation →

LibreChat

Føj til librechat.yaml, og sæt MAGUYVA_API_KEY i LibreChat-serverens miljø:

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

Denne konfiguration læser din nøgle fra miljøvariablen MAGUYVA_API_KEY. Sæt den til din API-nøgle fra app.maguyva.ai i det miljø, din klient starter fra.

LibreChat MCP-dokumentation →

Antigravity

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

Tilføj til din Antigravity MCP-konfiguration:

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

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

Det tilføjer Maguyva til Antigravity →

Antigravity MCP-dokumentation →

Claude Cowork

Claude Cowork indlæser ikke servere fra claude_desktop_config.json; den når eksterne servere som brugerdefinerede connectorer. Tilføj under Customize → Connectors en brugerdefineret connector med URL’en https://maguyva.tools/mcp, vælg No sign-in, og tilføj en authorization-request-header, hvis værdi er Bearer efterfulgt af din API-nøgle. Request-headers er i beta for et begrænset antal organisationer; har dialogen ingen sektion Request headers, kan Cowork endnu ikke godkende sig over for Maguyva. Se 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

Føj til ~/.warp/.mcp.json (eller .warp/.mcp.json i et projekt), eller indsæt under Settings → Agents → MCP servers → + Add:

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

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

Det tilføjer Maguyva til Warp →

Warp MCP-dokumentation →

Maguyva bruger standard MCP. Enhver klient, der understøtter protokollen, kan forbinde — selvom der ikke findes en officiel guide ovenfor. 23 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 repositoriet identificeres. En tilsidesættelse af repositorievalget gælder kun det aktuelle 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

#
  • Hvis din klient bruger broen @maguyva/mcp, skal du kontrollere, 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

#

Relateret

Læs videre