Lumaktaw papunta sa content

Gabay sa Pag-install

Maka-set up ka sa loob ng 5 minuto. Kasama sa gabay na ito ang setup para sa 24 MCP clients kabilang ang Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, at 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/claude-code-plugin
/plugin install maguyva@maguyva

Nag-i-install ito para sa user account mo. Para sa team, idagdag ang --scope project sa parehong command para ma-commit ang plugin sa .claude/settings.json ng repository, para awtomatikong makuha ito ng mga teammate mo.

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.

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

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

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",
        "mcp-remote",
        "https://maguyva.tools/mcp",
        "--header",
        "Authorization: Bearer ${MAGUYVA_API_KEY}"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

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

Sinusuportahan lang ng Claude Desktop ang remote servers bilang OAuth "connectors" sa pamamagitan ng Settings, hindi bilang header-authenticated entry sa claude_desktop_config.json — kaya gumagamit ito ng mcp-remote bridge (kailangan ng Node.js / npx).

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

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

MCP docs para sa Cursor →

VS Code / GitHub Copilot

Idagdag sa .vscode/mcp.json sa project mo (o sa user settings):

.vscode/mcp.json
{
  "servers": {
    "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.

MCP docs para sa VS Code / GitHub Copilot →

Windsurf

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

Idagdag sa MCP configuration ng iyong Windsurf:

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

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

MCP docs para sa 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"

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

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

MCP docs para sa Codex →

GitHub Copilot CLI

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

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

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

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

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa Cline →

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

Idagdag sa MCP settings ng iyong Roo Code:

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

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

MCP docs para sa Roo Code →

Goose

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

Idagdag sa config ng iyong Goose:

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa Goose →

LM Studio

Sinusuportahan ng LM Studio ang MCP servers sa pamamagitan ng Agent configuration nito. Magdagdag ng bagong MCP server sa Settings → Agent → MCP Servers gamit ang standard na mcpServers JSON format. Kumokonekta ang LM Studio sa MCP servers gamit ang stdio. Tingnan ang docs →

Continue

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

Idagdag sa config ng iyong Continue (~/.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"
      }
    }
  }
}

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa Continue →

Amazon Q Developer

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

Idagdag sa MCP config ng iyong Amazon Q:

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa Amazon Q Developer →

PyCharm

Idagdag sa .ai/mcp/mcp.json sa project root mo, o i-paste sa 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"
      }
    }
  }
}

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). 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 ${MAGUYVA_API_KEY}"
      }
    }
  }
}

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

MCP docs para sa Zed →

Trae

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

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

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

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

MCP docs para sa OpenCode →

BoltAI

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

Idagdag sa MCP configuration ng iyong BoltAI:

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa BoltAI →

LibreChat

Idagdag sa configuration ng iyong LibreChat:

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

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

Hindi pa sinusuportahan ng client na ito ang remote MCP server na may custom auth header, kaya kumokonekta ito sa pamamagitan ng mcp-remote bridge (kailangan ng Node.js / npx). Tumatakbo nang ganap sa remote ang Maguyva — ang bridge lang ang tumatakbo locally.

MCP docs para sa LibreChat →

Antigravity

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

Idagdag sa MCP configuration ng iyong Antigravity:

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

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

MCP docs para sa Antigravity →

Claude Cowork

Gumagamit ang Claude Cowork ng parehong MCP format gaya ng iba pang Anthropic client:

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

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

MCP docs para sa Claude Cowork →

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

Sinusuportahan ng Warp ang MCP servers sa Agent Mode. Mina-manage ang configuration sa Warp UI (Settings → Agent Mode → MCP Servers) at sini-sync sa pamamagitan ng Warp Drive. I-paste ang standard na mcpServers JSON kapag nagdadagdag ng server. Tingnan ang docs →

Gumagamit ang Maguyva ng standard MCP. Anumang client na sumusuporta sa protocol ay maaaring mag-connect — kahit walang first-party guide sa itaas.24 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 naka-connect sa akin?" — ve-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 tiyakin ang repository resolution. Stateless ang v3 server, kaya sa isang call lang nalalapat ang repository override.

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#

  • I-verify na available ang npx sa PATH mo
  • 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#