Lumaktaw papunta sa content

Gabay sa Pag-install

Maka-set up ka nang wala pang 5 minuto. Kasama sa gabay na ito ang setup para sa 23 MCP clients kabilang ang Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, at Devin Desktop (Windsurf), at marami pang iba.

Kailangan muna: Kakailanganin mo ng API key mula sa app.maguyva.ai at isang connected na GitHub repository.

Pag-setup ng Environment

#

Una, itakda ang iyong API key sa isang environment variable. Alisin ang repository kapag nagbibigay ang iyong MCP client ng request default o eksaktong isang repository lang ang maa-access ng key; kung hindi, tahasan itong ipasa.

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

Palitan ang mgv_xxxx ng iyong aktwal na API key mula sa app.maguyva.ai.

Configuration ng Client

#

Piliin ang iyong MCP client sa ibaba para sa specific na setup instructions.

Paalala sa compatibility: Gumagamit si Maguyva ng standard na MCP. Kahit anong client na may MCP support ay puwedeng kumonekta sa parehong server, kahit wala pa kaming isinulat na first-party setup guide para dito.

Claude Code

I-install ang Maguyva plugin mula sa Claude Code marketplace:

Idagdag ang Maguyva marketplace, pagkatapos ay i-install ang plugin (patakbuhin ang bawat command sa loob ng Claude Code):

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

Binubuksan ng /plugin install ang details ng plugin, kung saan mo pipiliin ang install scope: ikaw lang (user), lahat ng nagtatrabaho sa repository na ito (project), o ikaw lang sa repository na ito (local). Walang --scope flag ang mga in-session command na ito.

Nag-a-authenticate ang plugin gamit ang MAGUYVA_API_KEY environment variable. I-set ito sa shell mo:

export MAGUYVA_API_KEY=mgv_xxxx

Inirerekomenda ang per-project direnv (.envrc) — repository-scoped ang mga key, kaya tugma ang per-project value sa access ng bawat project. Okay lang ang global shell export kung iisang key lang ang sasapat para sa lahat ng trabaho mo.

Para sa team, puwede mo ring patakbuhin ang shell form ng dalawang command mula sa root ng repository, sa labas ng Claude Code:

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

Itinatala ng project scope ang plugin sa .claude/settings.json ng repository, na iko-commit mo. Ina-on nito ang plugin para sa mga teammate pero hindi nito dina-download, kaya kailangang patakbuhin ng bawat teammate ang install command nang isang beses.

Manual na setup (.mcp.json) — advanced
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}"
      }
    }
  }
}

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Claude Code →

MCP docs para sa Claude Code →

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

Idagdag sa configuration file ng iyong Claude Desktop:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Lokal na server lang ang sinisimulan ng claude_desktop_config.json, kaya ginagamit ng setup na ito ang @maguyva/mcp bridge (kailangan ng Node.js / npx). Kaya rin ng Claude Desktop na abutin ang Maguyva bilang custom connector (Customize → Connectors) na may authorization request header, pero beta pa ang request headers para sa limitadong bilang ng organisasyon.

Ano ang idinadagdag ng Maguyva sa Claude Desktop →

MCP docs para sa Claude Desktop →

Cursor

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

Idagdag sa .cursor/mcp.json sa project root mo:

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Ano ang idinadagdag ng Maguyva sa Cursor →

MCP docs para sa Cursor →

VS Code / GitHub Copilot

Idagdag sa .vscode/mcp.json ng project mo, o sa mcp.json ng profile mo (patakbuhin ang MCP: Open User Configuration):

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Ito ang VS Code format (servers key). Kinukuha ng VS Code ang MAGUYVA_API_KEY reference mula sa environment kung saan ito nagsimula. Mas pinipili na ngayon ng Add Server flow nito ang portable na .mcp.json (mcpServers key) na binabasa rin ng GitHub Copilot CLI; hindi sinusuportahan ng file na iyon ang input variables o environment files ng VS Code.

Ano ang idinadagdag ng Maguyva sa VS Code / GitHub Copilot →

MCP docs para sa VS Code / GitHub Copilot →

Devin Desktop (Windsurf)

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

Devin Desktop na ngayon ang Windsurf. Idagdag sa MCP configuration file nito:

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Binabasa ng Devin Local, ang default na agent, ang file na ito mula sa bersyon 3.6; ang mga naunang bersyon ay nag-iimbak ng mga server sa pangunahing config file at inililipat ang mga ito rito sa pag-start. Binabasa rin ang parehong file ng lumang Cascade agent, na hindi ginagamit sa pagsisimula ng mga bagong conversation. Kinukuha ng Devin Desktop ang MAGUYVA_API_KEY reference mula sa environment kung saan ito nagsimula.

Ano ang idinadagdag ng Maguyva sa Devin Desktop (Windsurf) →

MCP docs para sa Devin Desktop (Windsurf) →

Codex

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

Idagdag sa config ng iyong Codex CLI (~/.codex/config.toml):

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Ano ang idinadagdag ng Maguyva sa Codex →

MCP docs para sa Codex →

GitHub Copilot CLI

Idagdag sa ~/.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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa GitHub Copilot CLI →

MCP docs para sa GitHub Copilot CLI →

Gemini CLI

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

Idagdag sa settings ng iyong Gemini CLI (~/.gemini/settings.json):

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Ano ang idinadagdag ng Maguyva sa Gemini CLI →

MCP docs para sa Gemini CLI →

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

Idagdag sa MCP settings ng iyong Cline:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Cline →

MCP docs para sa Cline →

Goose

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

Idagdag sa config ng iyong Goose:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Goose →

MCP docs para sa Goose →

LM Studio

Sa LM Studio, buksan ang Program tab sa kanang sidebar, piliin ang Install → Edit mcp.json, at idagdag:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

MCP docs para sa LM Studio →

Continue

I-save bilang .continue/mcpServers/maguyva.yaml sa workspace mo (o idagdag ang mcpServers entry sa ~/.continue/config.yaml), saka i-set ang MAGUYVA_API_KEY sa ~/.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 }}

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Sa agent mode lang gumagamit ang Continue ng MCP servers. Hinahanap nito ang secret sa ~/.continue/.env, saka sa .continue/.env at .env ng workspace, at panghuli sa environment ng proseso.

Ano ang idinadagdag ng Maguyva sa Continue →

MCP docs para sa Continue →

Kiro CLI (Amazon Q Developer CLI)

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

Idagdag sa MCP config ng Kiro CLI (~/.kiro/settings/mcp.json, o .kiro/settings/mcp.json sa isang project):

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Pinalitan ng Kiro CLI ang Amazon Q Developer CLI. Kapag in-install mo ito, minsanang kinokopya nito ang mga server mo mula sa ~/.aws/amazonq/mcp.json papunta sa ~/.kiro/settings/mcp.json, at mas inuuna ang .kiro/settings/mcp.json ng project kaysa sa user file.

MCP docs para sa Kiro CLI (Amazon Q Developer CLI) →

PyCharm

I-paste sa Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, bilang JSON configuration: 

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ginagamit ng setup na ito ang @maguyva/mcp bridge (kailangan ng Node.js / npx). Hindi pa nabeberipika sa gabay na ito ang native remote configuration para sa client na ito; hindi nito ibig sabihin na walang native remote support ang client. Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa PyCharm →

Zed

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

Idagdag sa settings ng iyong Zed (~/.config/zed/settings.json):

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Zed →

MCP docs para sa Zed →

Trae

I-on ang Enable Project MCP sa Settings → MCP, saka idagdag sa .trae/mcp.json sa project root mo:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

MCP docs para sa Trae →

OpenCode

Idagdag sa opencode.json sa project root mo:

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

Ano ang idinadagdag ng Maguyva sa OpenCode →

MCP docs para sa OpenCode →

BoltAI

macOS: ~/.boltai/mcp.json

Idagdag sa MCP configuration ng iyong BoltAI:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ginagamit ng setup na ito ang @maguyva/mcp bridge (kailangan ng Node.js / npx). Hindi pa nabeberipika sa gabay na ito ang native remote configuration para sa client na ito; hindi nito ibig sabihin na walang native remote support ang client. Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa BoltAI →

LibreChat

Idagdag sa librechat.yaml at i-set ang MAGUYVA_API_KEY sa environment ng LibreChat server:

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

Binabasa ng config na ito ang key mo mula sa MAGUYVA_API_KEY environment variable. I-set ito sa API key mo mula sa app.maguyva.ai sa environment kung saan nagsisimula ang client mo.

MCP docs para sa LibreChat →

Antigravity

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

Idagdag sa MCP configuration ng iyong Antigravity:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Antigravity →

MCP docs para sa Antigravity →

Claude Cowork

Hindi naglo-load ang Claude Cowork ng mga server mula sa claude_desktop_config.json; naaabot nito ang mga remote server bilang custom connector. Sa Customize → Connectors, magdagdag ng custom connector na may URL na https://maguyva.tools/mcp, piliin ang No sign-in, at magdagdag ng authorization request header na ang value ay Bearer na susundan ng API key mo. Beta pa ang request headers para sa limitadong bilang ng organisasyon; kung walang Request headers section ang dialog, hindi pa makapag-authenticate ang Cowork sa Maguyva. Tingnan ang docs →

ChatGPT

Sinusuportahan ng ChatGPT ang remote MCP servers sa Business, Enterprise, at Edu plans sa pamamagitan ng Settings → Apps → Create. Kailangan ng remote HTTPS endpoint — hindi sinusuportahan ng ChatGPT ang local stdio servers. Tingnan ang MCP guide ng OpenAI para sa setup. Tingnan ang docs →

Warp

Idagdag sa ~/.warp/.mcp.json (o .warp/.mcp.json sa isang project), o i-paste sa Settings → Agents → MCP servers → + Add:

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

Palitan ang mgv_xxxx ng iyong API key mula sa app.maguyva.ai.

Ano ang idinadagdag ng Maguyva sa Warp →

MCP docs para sa Warp →

Gumagamit ang Maguyva ng standard MCP. Anumang client na sumusuporta sa protocol ay maaaring mag-connect — kahit walang first-party guide sa itaas. 23 clients ang naka-document, dumadagdag pa nang regular.

I-validate ang Iyong Setup

#

Pagkatapos mag-connect, subukang magtanong sa iyong agent ng ilang tanong:

  • "Anong mga repository ang na-connect ko?" — vine-verify kung gumagana ang connection
  • "Paano hinahandle ang authentication sa codebase na ito?" — sinusubok ang semantic search
  • "Hanapin ang lahat ng function na tumatawag sa database" — sinusubok ang dependency search
  • "Saan nakadepende ang UserService class?" — sinusubok ang symbol lookup

Dapat makakita ka ng resulta na may file paths at line numbers mula sa iyong connected repository. Kung hindi, tingnan ang troubleshooting section sa ibaba.

Format ng Repository

#

Kapag nagsa-specify ng mga repository:

  • May branch: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Default na branch: "owner/repo"

Tip: Gamitin ang repository_context(action="info", repository="...") para suriin ang pag-resolve ng repository. Ang tahasang pagpili ng repository ay para lamang sa kasalukuyang tawag.

Pag-aayos ng Problema

#

Mga Isyu sa API Key

#
  • I-verify na nagsisimula ang key mo sa mgv_ prefix
  • Tsekin kung tama ang pagkaka-set ng key sa environment mo
  • Siguraduhing hindi pa expired ang key

Hindi Nahanap ang Repository

#
  • I-verify na naka-connect ang repository sa app.maguyva.ai
  • Tsekin kung tama ang format na owner/repo
  • Siguraduhing may access ka sa repository

Mga Isyu sa MCP Connection

#
  • Kung ginagamit ng iyong client ang bridge na @maguyva/mcp, tiyaking available ang npx sa iyong PATH
  • Tsekin kung valid at hindi pa expired ang API token mo
  • Subukan ang connectivity papunta sa https://maguyva.tools/mcp
  • Tsekin ang MCP configuration syntax ng client mo

Mga Susunod na Hakbang

#

Kaugnay

Susunod na babasahin