Siirry sisältöön

Asennusopas

Pääset käyntiin alle 5 minuutissa. Tämä opas sisältää asennuksen 23 MCP-asiakasohjelmalle, mukaan lukien Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, ja Devin Desktop (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 komento Claude Code -sovelluksessa):

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

/plugin install avaa laajennuksen tiedot, joissa valitset asennuksen laajuuden: vain sinä (user), kaikki tässä repositoriossa työskentelevät (project) tai vain sinä tässä repositoriossa (local). Näillä istunnon sisäisillä komennoilla ei ole --scope-lippua.

Laajennus tunnistautuu 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.

Tiimiä varten voit sen sijaan ajaa molempien komentojen shell-muodon repositorion juuresta, Claude Code -sovelluksen ulkopuolella:

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

Laajuus project tallentaa laajennuksen repositorion tiedostoon .claude/settings.json, jonka committaat. Se ottaa laajennuksen käyttöön tiimikavereille mutta ei lataa sitä, joten jokainen tiimikaveri ajaa asennuskomennon kerran.

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

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

Mitä Maguyva tuo Claude Code-työkaluun →

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",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

claude_desktop_config.json käynnistää vain paikallisia palvelimia, joten tämä asetus käyttää @maguyva/mcp-siltaa (vaatii Node.js / npx). Claude Desktop voi myös tavoittaa Maguyvan mukautettuna liittimenä (Customize → Connectors) authorization-pyyntöotsakkeen kanssa, mutta pyyntöotsakkeet ovat betavaiheessa rajatulle joukolle organisaatioita.

Mitä Maguyva tuo Claude Desktop-työkaluun →

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Mitä Maguyva tuo Cursor-työkaluun →

Cursor MCP-dokumentaatio →

VS Code / GitHub Copilot

Lisää projektisi tiedostoon .vscode/mcp.json tai profiilisi tiedostoon mcp.json (aja MCP: Open User Configuration):

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Tämä on VS Coden muoto (avain servers). VS Code ratkaisee viittauksen MAGUYVA_API_KEY ympäristöstä, jossa se käynnistyy. Add Server -kulku suosii nyt siirrettävää .mcp.json-tiedostoa (avain mcpServers), jota myös GitHub Copilot CLI lukee; se tiedosto ei tue VS Coden syötemuuttujia eikä ympäristötiedostoja.

Mitä Maguyva tuo VS Code / GitHub Copilot-työkaluun →

VS Code / GitHub Copilot MCP-dokumentaatio →

Devin Desktop (Windsurf)

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

Windsurf on nyt Devin Desktop. Lisää sen MCP-asetustiedostoon:

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Oletusagentti Devin Local lukee tämän tiedoston versiosta 3.6 alkaen; aiemmat versiot pitivät palvelimet pääasetustiedostossa ja siirtävät ne tänne käynnistyksen yhteydessä. Vanha Cascade-agentti, jolla uudet keskustelut eivät käynnisty, lukee samaa tiedostoa. Devin Desktop -sovellus ratkaisee viittauksen MAGUYVA_API_KEY siitä ympäristöstä, jossa se käynnistyy.

Mitä Maguyva tuo Devin Desktop (Windsurf)-työkaluun →

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Mitä Maguyva tuo Codex-työkaluun →

Codex MCP-dokumentaatio →

GitHub Copilot CLI

Lisää tiedostoon ~/.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

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

Mitä Maguyva tuo GitHub Copilot CLI-työkaluun →

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Mitä Maguyva tuo Gemini CLI-työkaluun →

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": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

Mitä Maguyva tuo Cline-työkaluun →

Cline MCP-dokumentaatio →

Goose

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

Lisää Goose-sovelluksen määrityksiin:

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

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

Mitä Maguyva tuo Goose-työkaluun →

Goose MCP-dokumentaatio →

LM Studio

Avaa LM Studio -sovelluksen oikean sivupalkin Program-välilehti, valitse Install → Edit mcp.json ja lisää:

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

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

LM Studio MCP-dokumentaatio →

Continue

Tallenna työtilaasi nimellä .continue/mcpServers/maguyva.yaml (tai lisää mcpServers-merkintä tiedostoon ~/.continue/config.yaml) ja aseta sitten MAGUYVA_API_KEY tiedostoon ~/.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 }}

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Continue käyttää MCP-palvelimia vain agenttitilassa. Se etsii salaisuutta tiedostosta ~/.continue/.env, sitten työtilan tiedostoista .continue/.env ja .env ja lopuksi prosessin ympäristöstä.

Mitä Maguyva tuo Continue-työkaluun →

Continue MCP-dokumentaatio →

Kiro CLI (Amazon Q Developer CLI)

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

Lisää Kiro CLI:n MCP-asetuksiin (~/.kiro/settings/mcp.json tai projektissa .kiro/settings/mcp.json):

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

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

Kiro CLI korvasi Amazon Q Developer CLI:n. Asennuksen yhteydessä se kopioi palvelimesi kerran tiedostosta ~/.aws/amazonq/mcp.json tiedostoon ~/.kiro/settings/mcp.json, ja projektin .kiro/settings/mcp.json menee käyttäjätiedoston edelle.

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

PyCharm

Liitä kohtaan Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add JSON-asetuksena: 

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

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

Tämä määritys käyttää siltaa @maguyva/mcp (vaatii Node.js / npx). Tässä oppaassa ei ole varmennettu määritystä, joka käyttää tämän asiakasohjelman omaa etäyhteystukea; tämä ei tarkoita, että asiakasohjelmasta puuttuisi tällainen tuki. 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 mgv_xxxx"
      }
    }
  }
}

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

Mitä Maguyva tuo Zed-työkaluun →

Zed MCP-dokumentaatio →

Trae

Kytke Enable Project MCP päälle kohdassa Settings → MCP ja lisää sitten projektin juuren tiedostoon .trae/mcp.json:

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

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

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

Mitä Maguyva tuo OpenCode-työkaluun →

OpenCode MCP-dokumentaatio →

BoltAI

macOS: ~/.boltai/mcp.json

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

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

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

Tämä määritys käyttää siltaa @maguyva/mcp (vaatii Node.js / npx). Tässä oppaassa ei ole varmennettu määritystä, joka käyttää tämän asiakasohjelman omaa etäyhteystukea; tämä ei tarkoita, että asiakasohjelmasta puuttuisi tällainen tuki. Maguyva toimii kokonaan etänä — vain silta toimii paikallisesti.

BoltAI MCP-dokumentaatio →

LibreChat

Lisää tiedostoon librechat.yaml ja aseta MAGUYVA_API_KEY LibreChat-palvelimen ympäristöön:

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

Tämä konfiguraatio lukee avaimesi MAGUYVA_API_KEY-ympäristömuuttujasta. Aseta siihen API-avaimesi palvelusta app.maguyva.ai siinä ympäristössä, josta asiakasohjelmasi käynnistyy.

LibreChat MCP-dokumentaatio →

Antigravity

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

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

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

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

Mitä Maguyva tuo Antigravity-työkaluun →

Antigravity MCP-dokumentaatio →

Claude Cowork

Claude Cowork ei lataa palvelimia tiedostosta claude_desktop_config.json; se tavoittaa etäpalvelimet mukautettuina liittiminä. Lisää kohdassa Customize → Connectors mukautettu liitin URL-osoitteella https://maguyva.tools/mcp, valitse No sign-in ja lisää authorization-pyyntöotsake, jonka arvo on Bearer ja sen perässä API-avaimesi. Pyyntöotsakkeet ovat betavaiheessa rajatulle joukolle organisaatioita; jos ikkunassa ei ole Request headers -osiota, Cowork ei vielä voi tunnistautua Maguyva-palveluun. 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

Lisää tiedostoon ~/.warp/.mcp.json (tai projektissa .warp/.mcp.json) tai liitä kohtaan Settings → Agents → MCP servers → + Add:

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

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

Mitä Maguyva tuo Warp-työkaluun →

Warp MCP-dokumentaatio →

Maguyva käyttää tavallista MCP:tä. Mikä tahansa protokollaa tukeva asiakasohjelma voi yhdistää — vaikka yllä ei olisi virallista opasta. 23 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 repositorion tunnistus komennolla repository_context(action="info", repository="..."). Oletusrepositorion ohitus koskee vain nykyistä 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

#
  • Jos asiakasohjelmasi käyttää siltaa @maguyva/mcp, varmista, että npx on käytettävissä PATH-polussa
  • Tarkista, että API-tokenisi on voimassa eikä vanhentunut
  • Testaa yhteyttä osoitteeseen https://maguyva.tools/mcp
  • Tarkista asiakasohjelmasi MCP-konfiguraation syntaksi

Seuraavat askeleet

#

Aiheeseen liittyvää

Lue seuraavaksi