Hoppa till innehåll

Installationsguide

Kom igång på under 5 minuter. Den här guiden innehåller konfiguration för 24 MCP-klienter, inklusive Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, och Windsurf, och fler.

Förutsättningar: Du behöver en API-nyckel från app.maguyva.ai och ett anslutet GitHub-repository.

Miljökonfiguration#

Ställ först in API-nyckeln i en miljövariabel. Utelämna repository när MCP-klienten anger ett anropsspecifikt standardrepo eller när nyckeln har åtkomst till exakt ett repo; ange det annars uttryckligen.

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

Ersätt mgv_xxxx med din faktiska API-nyckel från app.maguyva.ai.

Klientkonfiguration#

Välj din MCP-klient nedan för specifika installationsanvisningar.

Kompatibilitetsnotering: Maguyva använder standard-MCP. Vilken klient som helst med MCP-stöd kan ansluta till samma server, även om vi ännu inte har skrivit en förstapartsguide för den.

Claude Code

Installera Maguyva-pluginet från Claude Code-marknadsplatsen:

Lägg till Maguyva-marknadsplatsen och installera sedan pluginet (kör varje kommando i Claude Code):

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

Installeras för ditt användarkonto. För ett team, lägg till --scope project till båda kommandona för att committa pluginet till repositoryts .claude/settings.json så att teammedlemmar får det automatiskt.

Pluginet autentiseras via miljövariabeln MAGUYVA_API_KEY. Ange den i ditt skal:

export MAGUYVA_API_KEY=mgv_xxxx

Per-projekt direnv (.envrc) rekommenderas — nycklar är repository-avgränsade, så ett värde per projekt matchar varje projekts åtkomst. En global skalexport fungerar om en nyckel täcker allt ditt arbete.

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

Ersätt mgv_xxxx med din API-nyckel från 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

Lägg till i 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Claude Desktop stöder fjärrservrar endast som OAuth-"connectors" via Settings, inte som en header-autentiserad post i claude_desktop_config.json, så det här använder mcp-remote-bryggan (kräver Node.js / npx).

Claude Desktop MCP-dokumentation →

Cursor

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

Lägg till i .cursor/mcp.json i projektets rot:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Cursor MCP-dokumentation →

VS Code / GitHub Copilot

Lägg till i .vscode/mcp.json i ditt projekt (eller i användarinställningarna):

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

Ersätt mgv_xxxx med din API-nyckel från 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

Lägg till i din Windsurf MCP-konfiguration:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Windsurf MCP-dokumentation →

Codex

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

Lägg till i 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}"

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Codex MCP-dokumentation →

GitHub Copilot CLI

Lägg till 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

GitHub Copilot CLI MCP-dokumentation →

Gemini CLI

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

Lägg till i dina Gemini CLI-inställningar (~/.gemini/settings.json):

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

Ersätt mgv_xxxx med din API-nyckel från 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

Lägg till i dina Cline MCP-inställningar:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs 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

Lägg till i dina Roo Code MCP-inställningar:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Roo Code MCP-dokumentation →

Goose

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

Lägg till i 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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

Goose MCP-dokumentation →

LM Studio

LM Studio stöder MCP-servrar via sin Agent-konfiguration. Lägg till en ny MCP-server under Settings → Agent → MCP Servers med standardformatet mcpServers JSON. LM Studio ansluter till MCP-servrar via stdio. Se dokumentation →

Continue

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

Lägg till i 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

Continue MCP-dokumentation →

Amazon Q Developer

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

Lägg till i 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

Amazon Q Developer MCP-dokumentation →

PyCharm

Lägg till i .ai/mcp/mcp.json i projektets rot, eller klistra in 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

PyCharm MCP-dokumentation →

Zed

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

Lägg till i dina Zed-inställningar (~/.config/zed/settings.json):

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Zed MCP-dokumentation →

Trae

Lägg till i .trae/mcp.json i projektets rot:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

Trae MCP-dokumentation →

OpenCode

Lägg till i opencode.json i projektets rot:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

OpenCode MCP-dokumentation →

BoltAI

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

Lägg till i 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

BoltAI MCP-dokumentation →

LibreChat

Lägg till i 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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Den här klienten stöder ännu inte en fjärransluten MCP-server med en anpassad autentiseringsheader, så den ansluter via mcp-remote-bryggan (kräver Node.js / npx). Maguyva körs helt fjärranslutet — endast bryggan körs lokalt.

LibreChat MCP-dokumentation →

Antigravity

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

Lägg till i din Antigravity MCP-konfiguration:

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

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Antigravity MCP-dokumentation →

Claude Cowork

Claude Cowork använder samma MCP-format som andra 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"
      }
    }
  }
}

Ersätt mgv_xxxx med din API-nyckel från app.maguyva.ai.

Claude Cowork MCP-dokumentation →

ChatGPT

ChatGPT stöder fjärranslutna MCP-servrar på Business-, Enterprise- och Edu-planer via Settings → Apps → Create. En fjärransluten HTTPS-adress krävs — ChatGPT stöder inte lokala stdio-servrar. Se OpenAIs MCP-guide för installation. Se dokumentation →

Warp

Warp stöder MCP-servrar i Agent Mode. Konfigurationen hanteras via Warp-gränssnittet (Settings → Agent Mode → MCP Servers) och synkas via Warp Drive. Klistra in standardformatet mcpServers JSON när du lägger till en server. Se dokumentation →

Maguyva använder standard-MCP. Alla klienter som stödjer protokollet kan ansluta — även om det inte finns någon förstapartsguide ovan. 24 klienter dokumenterade, fler tillkommer regelbundet.

Validera din installation#

Efter anslutningen kan du prova att ställa några frågor till din agent:

  • "Vilka repositorier har jag anslutna?" — verifierar att anslutningen fungerar
  • "Hur hanteras autentisering i den här kodbasen?" — testar semantisk sökning
  • "Hitta alla funktioner som anropar databasen" — testar beroendesökning
  • "Vad beror klassen UserService på?" — testar symboluppslagning

Du bör se resultat med filsökvägar och radnummer från ditt anslutna repository. Om inte, kontrollera troubleshooting section nedan.

Repositoryformat#

När du anger repositorier:

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

Tips: Använd repository_context(action="info", repository="...") för att kontrollera hur repot matchas. v3-servern är tillståndslös, så en repo-överstyrning gäller endast ett anrop.

Felsökning#

Problem med API-nyckel#

  • Kontrollera att din nyckel börjar med prefixet mgv_
  • Kontrollera att nyckeln är korrekt inställd i din miljö
  • Se till att nyckeln inte har gått ut

Repository hittades inte#

  • Kontrollera att repot är anslutet i app.maguyva.ai
  • Kontrollera att formatet owner/repo är korrekt
  • Se till att du har åtkomst till repot

Problem med MCP-anslutning#

  • Kontrollera att npx finns tillgängligt i din PATH
  • Kontrollera att din API-token är giltig och inte har gått ut
  • Testa anslutningen till https://maguyva.tools/mcp
  • Kontrollera din klients MCP-konfigurationssyntax

Nästa steg#