Hoppa till innehåll

Installationsguide

Kom igång på under 5 minuter. Den här guiden innehåller konfiguration för 23 MCP-klienter, inklusive Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, och Devin Desktop (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/agent-plugins
/plugin install maguyva@maguyva

/plugin install öppnar pluginets detaljer, där du väljer installationsomfång: bara du (user), alla som arbetar i det här repositoryt (project) eller bara du i det här repositoryt (local). De här kommandona i sessionen har ingen --scope-flagga.

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.

För ett team kan du i stället köra skalformen av båda kommandona från repositoryts rot, utanför Claude Code:

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

Omfånget project registrerar pluginet i repositoryts .claude/settings.json, som du committar. Det slår på pluginet för teammedlemmar men laddar inte ner det, så varje teammedlem kör installationskommandot en gång.

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

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

Vad Maguyva tillför 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

Lägg till i din Claude Desktop-konfigurationsfil:

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

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

claude_desktop_config.json startar bara lokala servrar, så den här installationen använder bryggan @maguyva/mcp (kräver Node.js / npx). Claude Desktop kan också nå Maguyva som en anpassad koppling (Customize → Connectors) med en authorization-header för förfrågan, men headers för förfrågningar är i beta för ett begränsat antal organisationer.

Vad Maguyva tillför Claude Desktop →

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Vad Maguyva tillför Cursor →

Cursor MCP-dokumentation →

VS Code / GitHub Copilot

Lägg till i .vscode/mcp.json i ditt projekt, eller i 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}"
      }
    }
  }
}

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Det här är VS Code-formatet (nyckeln servers). VS Code löser upp referensen till MAGUYVA_API_KEY från miljön det startar i. Flödet Add Server föredrar nu den portabla .mcp.json (nyckeln mcpServers), som GitHub Copilot CLI också läser; den filen stöder inte VS Codes indatavariabler eller miljöfiler.

Vad Maguyva tillför 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 heter nu Devin Desktop. Lägg till i dess MCP-konfigurationsfil:

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Devin Local, standardagenten, läser den här filen från version 3.6; tidigare versioner höll servrarna i huvudkonfigurationsfilen och flyttar dem hit vid start. Den äldre Cascade-agenten, som nya konversationer inte startar med, läser samma fil. Devin Desktop löser upp referensen till MAGUYVA_API_KEY från miljön det startar i.

Vad Maguyva tillför Devin Desktop (Windsurf) →

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Vad Maguyva tillför Codex →

Codex MCP-dokumentation →

GitHub Copilot CLI

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

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

Vad Maguyva tillför GitHub Copilot CLI →

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Vad Maguyva tillför 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

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

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

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

Vad Maguyva tillför Cline →

Cline MCP-dokumentation →

Goose

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

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

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

Vad Maguyva tillför Goose →

Goose MCP-dokumentation →

LM Studio

Öppna fliken Program i högra sidofältet i LM Studio, välj Install → Edit mcp.json och lägg till:

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

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

LM Studio MCP-dokumentation →

Continue

Spara som .continue/mcpServers/maguyva.yaml i din arbetsyta (eller lägg till mcpServers-posten i ~/.continue/config.yaml) och ange sedan 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 }}

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Continue använder MCP-servrar bara i agentläget. Det letar efter hemligheten i ~/.continue/.env, sedan i .continue/.env och .env i arbetsytan, och sist i processens miljö.

Vad Maguyva tillför 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

Lägg till i Kiro CLI:s MCP-konfiguration (~/.kiro/settings/mcp.json, eller .kiro/settings/mcp.json i ett projekt):

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

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

Kiro CLI har ersatt Amazon Q Developer CLI. Vid installationen kopieras dina servrar en gång från ~/.aws/amazonq/mcp.json till ~/.kiro/settings/mcp.json, och ett projekts .kiro/settings/mcp.json har företräde framför användarfilen.

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

PyCharm

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

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

Den här konfigurationen använder bryggan @maguyva/mcp (kräver Node.js / npx). En konfiguration som använder klientens inbyggda stöd för fjärranslutningar har inte verifierats för den här guiden; det betyder inte att klienten saknar sådant stöd. Maguyva körs helt på distans — 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 mgv_xxxx"
      }
    }
  }
}

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

Vad Maguyva tillför Zed →

Zed MCP-dokumentation →

Trae

Slå på Enable Project MCP under Settings → MCP och lägg sedan till i .trae/mcp.json i projektets rot:

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

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

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

Vad Maguyva tillför OpenCode →

OpenCode MCP-dokumentation →

BoltAI

macOS: ~/.boltai/mcp.json

Lägg till i din BoltAI MCP-konfiguration:

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

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

Den här konfigurationen använder bryggan @maguyva/mcp (kräver Node.js / npx). En konfiguration som använder klientens inbyggda stöd för fjärranslutningar har inte verifierats för den här guiden; det betyder inte att klienten saknar sådant stöd. Maguyva körs helt på distans — endast bryggan körs lokalt.

BoltAI MCP-dokumentation →

LibreChat

Lägg till i librechat.yaml och ange MAGUYVA_API_KEY i LibreChat-serverns miljö:

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

Den här konfigurationen läser din nyckel från miljövariabeln MAGUYVA_API_KEY. Sätt den till din API-nyckel från app.maguyva.ai i den miljö som din klient startar från.

LibreChat MCP-dokumentation →

Antigravity

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

Lägg till i din Antigravity MCP-konfiguration:

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

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

Vad Maguyva tillför Antigravity →

Antigravity MCP-dokumentation →

Claude Cowork

Claude Cowork läser inte in servrar från claude_desktop_config.json; det når fjärrservrar som anpassade kopplingar. Lägg under Customize → Connectors till en anpassad koppling med URL:en https://maguyva.tools/mcp, välj No sign-in och lägg till en authorization-header för förfrågan vars värde är Bearer följt av din API-nyckel. Headers för förfrågningar är i beta för ett begränsat antal organisationer; saknar dialogen avsnittet Request headers kan Cowork ännu inte autentisera sig mot Maguyva. Se 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

Lägg till i ~/.warp/.mcp.json (eller .warp/.mcp.json i ett projekt), eller klistra in under Settings → Agents → MCP servers → + Add:

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

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

Vad Maguyva tillför Warp →

Warp MCP-dokumentation →

Maguyva använder standard-MCP. Alla klienter som stödjer protokollet kan ansluta — även om det inte finns någon förstapartsguide ovan. 23 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 kodarkivet identifieras. Ett uttryckligt val av kodarkiv gäller bara det aktuella anropet.

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

#
  • Om din klient använder bryggan @maguyva/mcp, kontrollera att npx finns 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

#

Relaterat

Läs vidare