Siirry sisältöön

Asennusopas

Pääset käyntiin alle 5 minuutissa. Tämä opas sisältää asennuksen 24 MCP-asiakasohjelmalle, mukaan lukien Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, ja Windsurf, ja muita.

Esivaatimukset: Tarvitset API-avaimen osoitteesta app.maguyva.ai ja yhdistetyn GitHub-repositorion.

Ympäristön asetukset#

Aseta ensin API-avain ympäristömuuttujaan. Jätä repository pois, kun MCP-asiakas antaa pyyntökohtaisen oletuksen tai kun avaimella on pääsy täsmälleen yhteen repositoryyn; muussa tapauksessa anna se erikseen.

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

Korvaa mgv_xxxx oikealla API-avaimellasi osoitteesta app.maguyva.ai.

Asiakasohjelman konfigurointi#

Valitse MCP-asiakasohjelmasi alta saadaksesi tarkat asennusohjeet.

Yhteensopivuushuomautus: Maguyva käyttää tavallista MCP:tä. Mikä tahansa MCP:tä tukeva asiakasohjelma voi yhdistää samaan palvelimeen, vaikka emme olisikaan vielä kirjoittaneet sille virallista asennusopasta.

Claude Code

Asenna Maguyva-laajennus Claude Code -markkinapaikalta:

Lisää Maguyva-kauppapaikka ja asenna sitten laajennus (suorita jokainen komennon Claude Code sisällä):

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

Asentaa käyttäjätilillesi. Tiimiä varten lisää --scope project molempiin komentoihin, jotta laajennus tallentuu repositorion tiedostoon .claude/settings.json ja tiimikaverit saavat sen automaattisesti.

Laajennus todentaa ympäristömuuttujan MAGUYVA_API_KEY kautta. Aseta se komentotulkissasi:

export MAGUYVA_API_KEY=mgv_xxxx

Projektikohtainen direnv (.envrc) on suositeltava — avaimet ovat repositoriokohtaisia, joten projektikohtainen arvo vastaa kunkin projektin käyttöoikeuksia. Globaali shell-export toimii, jos yksi avain kattaa kaiken työsi.

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Claude Code MCP-dokumentaatio →

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

Lisää Claude Desktop -sovelluksen määritystiedostoon:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Claude Desktop tukee etäpalvelimia vain OAuth-"liittiminä" (connectors) Asetusten kautta, ei otsaketodennettuna merkintänä tiedostossa claude_desktop_config.json, joten tässä käytetään mcp-remote-siltaa (vaatii Node.js:n / npx:n).

Claude Desktop MCP-dokumentaatio →

Cursor

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

Lisää projektisi juureen tiedostoon .cursor/mcp.json:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Cursor MCP-dokumentaatio →

VS Code / GitHub Copilot

Lisää projektisi tiedostoon .vscode/mcp.json (tai käyttäjäasetuksiin):

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

VS Code / GitHub Copilot MCP-dokumentaatio →

Windsurf

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

Lisää Windsurf-sovelluksen MCP-määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Windsurf MCP-dokumentaatio →

Codex

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

Lisää Codex CLI:n määrityksiin (~/.codex/config.toml):

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

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Codex MCP-dokumentaatio →

GitHub Copilot CLI

Lisää tiedostoon .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"
      }
    }
  }
}

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

GitHub Copilot CLI MCP-dokumentaatio →

Gemini CLI

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

Lisää Gemini CLI:n asetuksiin (~/.gemini/settings.json):

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Gemini CLI MCP-dokumentaatio →

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

Lisää Cline-sovelluksen MCP-asetuksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

Cline MCP-dokumentaatio →

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

Lisää Roo Code -sovelluksen MCP-asetuksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Roo Code MCP-dokumentaatio →

Goose

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

Lisää Goose-sovelluksen määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

Goose MCP-dokumentaatio →

LM Studio

LM Studio tukee MCP-palvelimia Agent-määritysten kautta. Lisää uusi MCP-palvelin kohdassa Settings → Agent → MCP Servers käyttäen tavallista mcpServers JSON -muotoa. LM Studio yhdistää MCP-palvelimiin stdio:n kautta. Dokumentaatio →

Continue

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

Lisää Continue-sovelluksen määrityksiin (~/.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"
      }
    }
  }
}

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

Continue MCP-dokumentaatio →

Amazon Q Developer

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

Lisää Amazon Q:n MCP-määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

Amazon Q Developer MCP-dokumentaatio →

PyCharm

Lisää projektisi juureen tiedostoon .ai/mcp/mcp.json, tai liitä kohtaan 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"
      }
    }
  }
}

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

PyCharm MCP-dokumentaatio →

Zed

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

Lisää Zed-sovelluksen asetuksiin (~/.config/zed/settings.json):

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Zed MCP-dokumentaatio →

Trae

Lisää projektisi juureen tiedostoon .trae/mcp.json:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

Trae MCP-dokumentaatio →

OpenCode

Lisää projektisi juureen tiedostoon opencode.json:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

OpenCode MCP-dokumentaatio →

BoltAI

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

Lisää BoltAI:n MCP-määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

BoltAI MCP-dokumentaatio →

LibreChat

Lisää LibreChat-sovelluksen määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Tämä asiakasohjelma ei vielä tue etä-MCP-palvelinta mukautetulla todennusotsakkeella, joten se yhdistää mcp-remote-sillan kautta (vaatii Node.js:n / npx:n). Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

LibreChat MCP-dokumentaatio →

Antigravity

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

Lisää Antigravity-sovelluksen MCP-määrityksiin:

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

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Antigravity MCP-dokumentaatio →

Claude Cowork

Claude Cowork käyttää samaa MCP-muotoa kuin muut Anthropicin asiakasohjelmat:

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

Korvaa mgv_xxxx API-avaimellasi osoitteesta app.maguyva.ai.

Claude Cowork MCP-dokumentaatio →

ChatGPT

ChatGPT tukee etä-MCP-palvelimia Business-, Enterprise- ja Edu-tilauksissa kohdan Settings → Apps → Create kautta. Etäkäyttöinen HTTPS-päätepiste vaaditaan — ChatGPT ei tue paikallisia stdio-palvelimia. Katso OpenAI:n MCP-opas asennusta varten. Dokumentaatio →

Warp

Warp tukee MCP-palvelimia Agent Mode -tilassa. Määritykset hallitaan Warpin käyttöliittymän kautta (Settings → Agent Mode → MCP Servers) ja synkronoidaan Warp Driven kautta. Liitä tavallinen mcpServers JSON, kun lisäät palvelimen. Dokumentaatio →

Maguyva käyttää tavallista MCP:tä. Mikä tahansa protokollaa tukeva asiakasohjelma voi yhdistää — vaikka yllä ei olisi virallista opasta.24 asiakasohjelmaa dokumentoitu, lisää lisätään säännöllisesti.

Varmista asennuksesi#

Yhdistämisen jälkeen kokeile esittää agentillesi muutama kysymys:

  • "Mitkä repositoriot minulla on yhdistettynä?" — varmistaa, että yhteys toimii
  • "Miten autentikointi hoidetaan tässä koodikannassa?" — testaa semanttista hakua
  • "Etsi kaikki funktiot, jotka kutsuvat tietokantaa" — testaa riippuvuushakua
  • "Mistä UserService-luokka on riippuvainen?" — testaa symbolihakua

Sinun pitäisi nähdä tuloksia tiedostopolkuineen ja rivinumeroineen yhdistetystä repositoriostasi. Jos et näe, tarkista alla oleva troubleshooting section.

Repositorion muoto#

Repositorioita määrittäessäsi:

  • Haaran kanssa: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Oletushaara: "owner/repo"

Vinkki: Tarkista repon tunnistus komennolla repository_context(action="info", repository="..."). v3-palvelin on tilaton, joten repon ohitus koskee vain yhtä kutsua.

Vianmääritys#

API-avainongelmat#

  • Varmista, että avaimesi alkaa mgv_-etuliitteellä
  • Tarkista, että avain on asetettu oikein ympäristössäsi
  • Varmista, ettei avain ole vanhentunut

Repositoriota ei löydy#

  • Varmista, että repositorio on yhdistetty osoitteessa app.maguyva.ai
  • Tarkista, että owner/repo-muoto on oikein
  • Varmista, että sinulla on pääsy repositorioon

MCP-yhteysongelmat#

  • Varmista, että npx on saatavilla PATH-muuttujassasi
  • Tarkista, että API-tokenisi on voimassa eikä vanhentunut
  • Testaa yhteyttä osoitteeseen https://maguyva.tools/mcp
  • Tarkista asiakasohjelmasi MCP-konfiguraation syntaksi

Seuraavat askeleet#