Hopp til innhold

Installasjonsguide

Kom i gang på under 5 minutter. Denne guiden inkluderer oppsett for 24 MCP-klienter, blant annet Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, og 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/claude-code-plugin
/plugin install maguyva@maguyva

Installerer for brukerkontoen din. For et team, legg til --scope project i begge kommandoene for å committe pluginet til repoets .claude/settings.json, slik at teammedlemmer får det automatisk.

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.

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

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

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",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Claude Desktop støtter kun eksterne servere som OAuth-"connectors" via Settings, ikke som en header-autentisert oppføring i claude_desktop_config.json, så dette bruker mcp-remote-broen (krever Node.js / npx).

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

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

Cursor MCP-dokumentasjon →

VS Code / GitHub Copilot

Legg til i .vscode/mcp.json i prosjektet ditt (eller i brukerinnstillingene):

.vscode/mcp.json
{
  "servers": {
    "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.

VS Code / GitHub Copilot MCP-dokumentasjon →

Windsurf

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

Legg til i MCP-konfigurasjonen for Windsurf:

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

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

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"

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

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

Codex MCP-dokumentasjon →

GitHub Copilot CLI

Legg til i .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"
      }
    }
  }
}

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

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

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

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

Cline MCP-dokumentasjon →

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

Legg til i MCP-innstillingene for Roo Code:

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

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

Roo Code MCP-dokumentasjon →

Goose

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

Legg til i Goose-konfigurasjonen din:

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

Goose MCP-dokumentasjon →

LM Studio

LM Studio støtter MCP-servere via Agent-konfigurasjonen sin. Legg til en ny MCP-server under Settings → Agent → MCP Servers ved å bruke standard mcpServers-JSON-format. LM Studio kobler til MCP-servere over stdio. Se dokumentasjon →

Continue

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

Legg til i konfigurasjonen for Continue (~/.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"
      }
    }
  }
}

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

Continue MCP-dokumentasjon →

Amazon Q Developer

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

Legg til i MCP-konfigurasjonen for Amazon Q:

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

Amazon Q Developer MCP-dokumentasjon →

PyCharm

Legg til i .ai/mcp/mcp.json i rotmappen til prosjektet ditt, eller lim inn 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"
      }
    }
  }
}

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt 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 ${MAGUYVA_API_KEY}"
      }
    }
  }
}

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

Zed MCP-dokumentasjon →

Trae

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

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

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

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

OpenCode MCP-dokumentasjon →

BoltAI

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

Legg til i MCP-konfigurasjonen for BoltAI:

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

BoltAI MCP-dokumentasjon →

LibreChat

Legg til i konfigurasjonen for LibreChat:

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

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

Denne klienten støtter ennå ikke en ekstern MCP-server med en egendefinert auth-header, så den kobler til gjennom mcp-remote-broen (krever Node.js / npx). Maguyva kjører helt eksternt — bare broen kjører lokalt.

LibreChat MCP-dokumentasjon →

Antigravity

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

Legg til i MCP-konfigurasjonen for Antigravity:

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

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

Antigravity MCP-dokumentasjon →

Claude Cowork

Claude Cowork bruker 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"
      }
    }
  }
}

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

Claude Cowork MCP-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

Warp støtter MCP-servere i Agent Mode. Konfigurasjonen håndteres gjennom Warp-brukergrensesnittet (Settings → Agent Mode → MCP Servers) og synkroniseres via Warp Drive. Lim inn standard mcpServers-JSON når du legger til en server. Se dokumentasjon →

Maguyva bruker standard MCP. Enhver klient som støtter protokollen kan koble til — selv om det ikke finnes en offisiell guide ovenfor. 24 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 repoet gjenkjennes. v3-serveren er tilstandsløs, så en repo-overstyring gjelder bare ett kall.

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#

  • Bekreft at npx er tilgjengelig i PATH-en din
  • 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#