Hopp til innhold

Installasjonsguide

Kom i gang på under 5 minutter. Denne guiden inkluderer oppsett for 23 MCP-klienter, blant annet Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, og Devin Desktop (Windsurf), og flere.

Forutsetninger: Du trenger en API-nøkkel fra app.maguyva.ai og et tilkoblet GitHub-repo.

Miljøoppsett

#

Angi først API-nøkkelen i en miljøvariabel. Utelat repository når MCP-klienten oppgir en standard for den aktuelle forespørselen, eller når nøkkelen har tilgang til nøyaktig ett repo; ellers oppgir du den eksplisitt.

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

Erstatt mgv_xxxx med din faktiske API-nøkkel fra app.maguyva.ai.

Klientkonfigurasjon

#

Velg MCP-klienten din nedenfor for spesifikke oppsettsinstruksjoner.

Kompatibilitetsnotat: Maguyva bruker standard MCP. Enhver klient med MCP-støtte kan koble til den samme serveren, selv om vi ennå ikke har skrevet en egen oppsettsguide for den.

Claude Code

Installer Maguyva-pluginet fra Claude Code-markedsplassen:

Legg til Maguyva-markedsplassen, og installer deretter pluginet (kjør hver kommando inne i Claude Code):

/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva

/plugin install åpner detaljene for pluginet, der du velger installasjonsomfang: bare deg (user), alle som jobber i dette repoet (project), eller bare deg i dette repoet (local). Disse kommandoene i økten har ikke noe --scope-flagg.

Pluginet autentiserer via miljøvariabelen MAGUYVA_API_KEY. Sett den i skallet ditt:

export MAGUYVA_API_KEY=mgv_xxxx

Direnv per prosjekt (.envrc) anbefales — nøkler er repo-avgrenset, så en verdi per prosjekt matcher tilgangen til hvert prosjekt. En global skall-eksport fungerer hvis én nøkkel dekker alt arbeidet ditt.

For et team kan du i stedet kjøre skallformen av begge kommandoene fra roten av repoet, utenfor Claude Code:

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

Omfanget project registrerer pluginet i repoets .claude/settings.json, som du committer. Det slår på pluginet for teammedlemmer, men laster det ikke ned, så hvert teammedlem kjører installasjonskommandoen én gang.

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Claude Code →

Claude Code MCP-dokumentasjon →

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

Legg til i konfigurasjonsfilen for Claude Desktop:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

claude_desktop_config.json starter bare lokale servere, så dette oppsettet bruker broen @maguyva/mcp (krever Node.js / npx). Claude Desktop kan også nå Maguyva som en egendefinert kobling (Customize → Connectors) med en authorization-forespørselsheader, men forespørselsheadere er i beta for et begrenset antall organisasjoner.

Dette gir Maguyva Claude Desktop →

Claude Desktop MCP-dokumentasjon →

Cursor

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

Legg til i .cursor/mcp.json i rotmappen til prosjektet ditt:

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Dette gir Maguyva Cursor →

Cursor MCP-dokumentasjon →

VS Code / GitHub Copilot

Legg til i .vscode/mcp.json i prosjektet ditt, eller i profilens mcp.json (kjø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 konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Dette er VS Code-formatet (nøkkelen servers). VS Code henter referansen til MAGUYVA_API_KEY fra miljøet det starter i. Add Server-flyten foretrekker nå den portable .mcp.json (nøkkelen mcpServers), som GitHub Copilot CLI også leser; den filen støtter ikke inndatavariabler eller miljøfiler fra VS Code.

Dette gir Maguyva VS Code / GitHub Copilot →

VS Code / GitHub Copilot MCP-dokumentasjon →

Devin Desktop (Windsurf)

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

Windsurf heter nå Devin Desktop. Legg til i MCP-konfigurasjonsfilen:

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Devin Local, standardagenten, leser denne filen fra versjon 3.6; eldre versjoner lagret servere i hovedkonfigurasjonsfilen og flytter dem hit ved oppstart. Den eldre Cascade-agenten, som nye samtaler ikke starter med, leser den samme filen. Devin Desktop henter referansen til MAGUYVA_API_KEY fra miljøet det starter i.

Dette gir Maguyva Devin Desktop (Windsurf) →

Devin Desktop (Windsurf) MCP-dokumentasjon →

Codex

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

Legg til i konfigurasjonen for Codex CLI (~/.codex/config.toml):

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Dette gir Maguyva Codex →

Codex MCP-dokumentasjon →

GitHub Copilot CLI

Legg til i ~/.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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva GitHub Copilot CLI →

GitHub Copilot CLI MCP-dokumentasjon →

Gemini CLI

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

Legg til i innstillingene for Gemini CLI (~/.gemini/settings.json):

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Dette gir Maguyva Gemini CLI →

Gemini CLI MCP-dokumentasjon →

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

Legg til i MCP-innstillingene for Cline:

cline_mcp_settings.json 
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Cline →

Cline MCP-dokumentasjon →

Goose

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

Legg til i Goose-konfigurasjonen din:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Goose →

Goose MCP-dokumentasjon →

LM Studio

Åpne fanen Program i høyre sidepanel i LM Studio, velg Install → Edit mcp.json, og legg til:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

LM Studio MCP-dokumentasjon →

Continue

Lagre som .continue/mcpServers/maguyva.yaml i arbeidsområdet (eller legg mcpServers-oppføringen i ~/.continue/config.yaml), og sett deretter 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 konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Continue bruker MCP-servere bare i agentmodus. Det leter etter hemmeligheten i ~/.continue/.env, deretter i .continue/.env og .env i arbeidsområdet, og til slutt i prosessmiljøet.

Dette gir Maguyva Continue →

Continue MCP-dokumentasjon →

Kiro CLI (Amazon Q Developer CLI)

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

Legg til i MCP-konfigurasjonen til Kiro CLI (~/.kiro/settings/mcp.json, eller .kiro/settings/mcp.json i et prosjekt):

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Kiro CLI har erstattet Amazon Q Developer CLI. Ved installasjon kopieres serverne dine én gang fra ~/.aws/amazonq/mcp.json til ~/.kiro/settings/mcp.json, og et prosjekts .kiro/settings/mcp.json går foran brukerfilen.

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

PyCharm

Lim inn under Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, som JSON-konfigurasjon: 

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette oppsettet bruker broen @maguyva/mcp (krever Node.js / npx). En konfigurasjon som bruker denne klientens innebygde støtte for ekstern tilkobling, er ikke verifisert i denne veiledningen; dette betyr ikke at klienten mangler slik støtte. Maguyva kjører i sin helhet eksternt — bare broen kjører lokalt.

PyCharm MCP-dokumentasjon →

Zed

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

Legg til i innstillingene for Zed (~/.config/zed/settings.json):

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Zed →

Zed MCP-dokumentasjon →

Trae

Slå på Enable Project MCP under Settings → MCP, og legg deretter til i .trae/mcp.json i prosjektroten:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Trae MCP-dokumentasjon →

OpenCode

Legg til i opencode.json i rotmappen til prosjektet ditt:

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

Dette gir Maguyva OpenCode →

OpenCode MCP-dokumentasjon →

BoltAI

macOS: ~/.boltai/mcp.json

Legg til i MCP-konfigurasjonen for BoltAI:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette oppsettet bruker broen @maguyva/mcp (krever Node.js / npx). En konfigurasjon som bruker denne klientens innebygde støtte for ekstern tilkobling, er ikke verifisert i denne veiledningen; dette betyr ikke at klienten mangler slik støtte. Maguyva kjører i sin helhet eksternt — bare broen kjører lokalt.

BoltAI MCP-dokumentasjon →

LibreChat

Legg til i librechat.yaml og sett MAGUYVA_API_KEY i miljøet til LibreChat-serveren:

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

Denne konfigurasjonen leser nøkkelen din fra miljøvariabelen MAGUYVA_API_KEY. Sett den til API-nøkkelen din fra app.maguyva.ai i miljøet klienten din starter fra.

LibreChat MCP-dokumentasjon →

Antigravity

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

Legg til i MCP-konfigurasjonen for Antigravity:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Antigravity →

Antigravity MCP-dokumentasjon →

Claude Cowork

Claude Cowork laster ikke servere fra claude_desktop_config.json; den når eksterne servere som egendefinerte koblinger. Legg til en egendefinert kobling med URL-en https://maguyva.tools/mcp under Customize → Connectors, velg No sign-in, og legg til en authorization-forespørselsheader med verdien Bearer etterfulgt av API-nøkkelen din. Forespørselsheadere er i beta for et begrenset antall organisasjoner; mangler dialogen delen Request headers, kan Cowork ennå ikke autentisere seg mot Maguyva. Se dokumentasjon →

ChatGPT

ChatGPT støtter eksterne MCP-servere på Business-, Enterprise- og Edu-planene via Settings → Apps → Create. Et eksternt HTTPS-endepunkt er påkrevd — ChatGPT støtter ikke lokale stdio-servere. Se OpenAIs MCP-guide for oppsett. Se dokumentasjon →

Warp

Legg til i ~/.warp/.mcp.json (eller .warp/.mcp.json i et prosjekt), eller lim inn under Settings → Agents → MCP servers → + Add:

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

Erstatt mgv_xxxx med API-nøkkelen din fra app.maguyva.ai.

Dette gir Maguyva Warp →

Warp MCP-dokumentasjon →

Maguyva bruker standard MCP. Enhver klient som støtter protokollen kan koble til — selv om det ikke finnes en offisiell guide ovenfor. 23 klienter er dokumentert, flere legges til jevnlig.

Valider oppsettet ditt

#

Etter tilkobling, prøv å stille agenten din noen spørsmål:

  • "Hvilke repoer har jeg koblet til?" — verifiserer at tilkoblingen fungerer
  • "Hvordan håndteres autentisering i denne kodebasen?" — tester semantisk søk
  • "Finn alle funksjoner som kaller databasen" — tester avhengighetssøk
  • "Hva er UserService-klassen avhengig av?" — tester symboloppslag

Du bør se resultater med filstier og linjenumre fra det tilkoblede repoet ditt. Hvis ikke, sjekk troubleshooting section nedenfor.

Repo-format

#

Når du spesifiserer repoer:

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

Tips: bruk repository_context(action="info", repository="...") for å kontrollere hvordan repositoriet identifiseres. En overstyring av repositoriet gjelder bare det gjeldende anropet.

Feilsøking

#

Problemer med API-nøkkel

#
  • Bekreft at nøkkelen din starter med mgv_-prefikset
  • Sjekk at nøkkelen er riktig satt i miljøet ditt
  • Sørg for at nøkkelen ikke har utløpt

Repo ikke funnet

#
  • Bekreft at repoet er koblet til i app.maguyva.ai
  • Sjekk at owner/repo-formatet er riktig
  • Sørg for at du har tilgang til repoet

MCP-tilkoblingsproblemer

#
  • Hvis klienten din bruker broen @maguyva/mcp, kontroller at npx er tilgjengelig i PATH
  • Sjekk at API-tokenet ditt er gyldig og ikke utløpt
  • Test tilkoblingen til https://maguyva.tools/mcp
  • Sjekk syntaksen i MCP-konfigurasjonen til klienten din

Neste steg

#

Relatert

Les videre