Οδηγός Εγκατάστασης
Ξεκινήστε μέσα σε λιγότερο από 5 λεπτά. Αυτός ο οδηγός περιλαμβάνει εγκατάσταση για 24 πελάτες MCP, συμπεριλαμβανομένων των Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot, και Windsurf, και άλλων.
Προαπαιτούμενα: Θα χρειαστείτε ένα κλειδί API από app.maguyva.ai και ένα συνδεδεμένο αποθετήριο GitHub.
Ρύθμιση Περιβάλλοντος#
Αρχικά, ορίστε το κλειδί API σε μια μεταβλητή περιβάλλοντος. Παραλείψτε το repository όταν ο MCP client παρέχει προεπιλογή για το συγκεκριμένο αίτημα ή όταν το κλειδί έχει πρόσβαση σε ακριβώς ένα αποθετήριο· διαφορετικά, δώστε το ρητά.
macOS/Linux (Bash/Zsh)#
# Add to your shell profile for persistence:
echo 'export MAGUYVA_API_KEY="mgv_xxxx"' >> ~/.zshrc # or ~/.bashrc
source ~/.zshrc # reloadWindows (PowerShell)#
# Make it persist in your profile:
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILEΑντικαταστήστε το mgv_xxxx με το πραγματικό κλειδί API σας από app.maguyva.ai.
Διαμόρφωση Πελάτη#
Επιλέξτε τον πελάτη MCP σας παρακάτω για συγκεκριμένες οδηγίες εγκατάστασης.
Σημείωση συμβατότητας: Η Maguyva χρησιμοποιεί τυπικό MCP. Οποιοσδήποτε πελάτης με υποστήριξη MCP μπορεί να συνδεθεί στον ίδιο διακομιστή, ακόμα κι αν δεν έχουμε γράψει ακόμα έναν επίσημο οδηγό εγκατάστασης για αυτόν.
Claude Code
Εγκαταστήστε το πρόσθετο Maguyva από το κατάστημα προσθέτων του Claude Code:
Προσθέστε το κατάστημα προσθέτων του Maguyva και μετά εγκαταστήστε το πρόσθετο (εκτελέστε κάθε εντολή μέσα στο Claude Code):
/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyvaΕγκαθιστά για τον λογαριασμό χρήστη σας. Για ομάδα, προσθέστε --scope project και στις δύο εντολές ώστε το πρόσθετο να καταχωρηθεί στο .claude/settings.json του αποθετηρίου, ώστε οι συνάδελφοι να το λαμβάνουν αυτόματα.
Το πρόσθετο αυθεντικοποιείται μέσω της μεταβλητής περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κέλυφός σας:
export MAGUYVA_API_KEY=mgv_xxxxΣυνιστάται το direnv ανά έργο (.envrc) — τα κλειδιά έχουν εμβέλεια αποθετηρίου, οπότε μια τιμή ανά έργο ταιριάζει με την πρόσβαση κάθε έργου. Μία καθολική εξαγωγή στο κέλυφος λειτουργεί αν ένα κλειδί καλύπτει όλη τη δουλειά σας.
Χειροκίνητα (.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"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
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
Προσθέστε στο αρχείο ρυθμίσεων του Claude Desktop:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Το Claude Desktop υποστηρίζει απομακρυσμένους διακομιστές μόνο ως «connectors» OAuth μέσω του Settings, όχι ως καταχώρηση με αυθεντικοποίηση κεφαλίδας στο claude_desktop_config.json, οπότε αυτό χρησιμοποιεί τη γέφυρα mcp-remote (απαιτεί Node.js / npx).
Cursor
macOS: ~/.cursor/mcp.json
Windows: %UserProfile%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json
Προσθέστε στο .cursor/mcp.json στη ρίζα του έργου σας:
{
"mcpServers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
VS Code / GitHub Copilot
Προσθέστε στο .vscode/mcp.json του έργου σας (ή στις ρυθμίσεις χρήστη):
{
"servers": {
"maguyva": {
"type": "http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Windsurf
macOS: ~/.codeium/windsurf/mcp_config.json
Windows: %UserProfile%\.codeium\windsurf\mcp_config.json
Linux: ~/.codeium/windsurf/mcp_config.json
Προσθέστε στις ρυθμίσεις MCP του Windsurf:
{
"mcpServers": {
"maguyva": {
"serverUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Codex
macOS: ~/.codex/config.toml
Windows: %UserProfile%\.codex\config.toml
Linux: ~/.codex/config.toml
Προσθέστε στις ρυθμίσεις του Codex CLI (~/.codex/config.toml):
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
[mcp_servers.maguyva.http_headers]
Authorization = "Bearer ${MAGUYVA_API_KEY}"Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
GitHub Copilot CLI
Προσθέστε στο .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"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Gemini CLI
macOS: ~/.gemini/settings.json
Windows: %UserProfile%\.gemini\settings.json
Linux: ~/.gemini/settings.json
Προσθέστε στις ρυθμίσεις του Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"maguyva": {
"httpUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
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
Προσθέστε στις ρυθμίσεις MCP του Cline:
{
"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
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
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
Προσθέστε στις ρυθμίσεις MCP του Roo Code:
{
"mcpServers": {
"maguyva": {
"type": "streamable-http",
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
},
"alwaysAllow": [],
"disabled": false
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Goose
macOS: ~/.config/goose/config.yaml
Windows: %AppData%\goose\config.yaml
Linux: ~/.config/goose/config.yaml
Προσθέστε στις ρυθμίσεις του Goose:
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Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
LM Studio
Το LM Studio υποστηρίζει διακομιστές MCP μέσω των ρυθμίσεων Agent του. Προσθέστε έναν νέο διακομιστή MCP στο Settings → Agent → MCP Servers χρησιμοποιώντας την τυπική μορφή JSON mcpServers. Το LM Studio συνδέεται με διακομιστές MCP μέσω stdio. Δείτε την τεκμηρίωση →
Continue
macOS: ~/.continue/config.json
Windows: %UserProfile%\.continue\config.json
Linux: ~/.continue/config.json
Προσθέστε στις ρυθμίσεις του Continue (~/.continue/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"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
Amazon Q Developer
macOS: ~/.aws/amazonq/mcp.json
Windows: %UserProfile%\.aws\amazonq\mcp.json
Linux: ~/.aws/amazonq/mcp.json
Προσθέστε στις ρυθμίσεις MCP του Amazon Q:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
PyCharm
Προσθέστε στο .ai/mcp/mcp.json στη ρίζα του έργου σας, ή επικολλήστε το στο Settings > Tools > AI Assistant > MCP:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
Zed
macOS: ~/.config/zed/settings.json
Windows: %AppData%\Zed\settings.json
Linux: ~/.config/zed/settings.json
Προσθέστε στις ρυθμίσεις του Zed (~/.config/zed/settings.json):
{
"context_servers": {
"maguyva": {
"url": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Trae
Προσθέστε στο .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"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
OpenCode
Προσθέστε στο opencode.json στη ρίζα του έργου σας:
{
"mcp": {
"maguyva": {
"type": "remote",
"url": "https://maguyva.tools/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
BoltAI
macOS: ~/Library/Application Support/BoltAI/mcp_config.json
Προσθέστε στις ρυθμίσεις MCP του BoltAI:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
LibreChat
Προσθέστε στις ρυθμίσεις του LibreChat:
mcpServers:
maguyva:
command: npx
args:
- -y
- mcp-remote
- https://maguyva.tools/mcp
- --header
- "Authorization: Bearer ${MAGUYVA_API_KEY}"
env:
MAGUYVA_API_KEY: mgv_xxxxΑντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Αυτός ο πελάτης δεν υποστηρίζει ακόμη απομακρυσμένο διακομιστή MCP με προσαρμοσμένη κεφαλίδα αυθεντικοποίησης, οπότε συνδέεται μέσω της γέφυρας mcp-remote (απαιτεί Node.js / npx). Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.
Antigravity
macOS: ~/.gemini/antigravity/mcp_config.json
Windows: %UserProfile%\.gemini\antigravity\mcp_config.json
Linux: ~/.gemini/antigravity/mcp_config.json
Προσθέστε στις ρυθμίσεις MCP του Antigravity:
{
"mcpServers": {
"maguyva": {
"serverUrl": "https://maguyva.tools/mcp",
"headers": {
"Authorization": "Bearer ${MAGUYVA_API_KEY}"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
Claude Cowork
Το Claude Cowork χρησιμοποιεί την ίδια μορφή MCP με τους υπόλοιπους πελάτες της Anthropic:
{
"mcpServers": {
"maguyva": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://maguyva.tools/mcp",
"--header",
"Authorization: Bearer ${MAGUYVA_API_KEY}"
],
"env": {
"MAGUYVA_API_KEY": "mgv_xxxx"
}
}
}
}Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.
ChatGPT
Το ChatGPT υποστηρίζει απομακρυσμένους διακομιστές MCP στα πλάνα Business, Enterprise και Edu μέσω Settings → Apps → Create. Απαιτείται ένα απομακρυσμένο τελικό σημείο HTTPS — το ChatGPT δεν υποστηρίζει τοπικούς διακομιστές stdio. Δείτε τον οδηγό MCP της OpenAI για τη ρύθμιση. Δείτε την τεκμηρίωση →
Warp
Το Warp υποστηρίζει διακομιστές MCP σε λειτουργία Agent Mode. Η ρύθμιση γίνεται μέσω του περιβάλλοντος Warp (Settings → Agent Mode → MCP Servers) και συγχρονίζεται μέσω του Warp Drive. Επικολλήστε την τυπική μορφή JSON mcpServers όταν προσθέτετε έναν διακομιστή. Δείτε την τεκμηρίωση →
Το Maguyva χρησιμοποιεί τυπικό MCP. Οποιοσδήποτε πελάτης υποστηρίζει το πρωτόκολλο μπορεί να συνδεθεί — ακόμα κι αν δεν υπάρχει επίσημος οδηγός παραπάνω. 24 πελάτες τεκμηριωμένοι, περισσότεροι προστίθενται τακτικά.
Επικυρώστε τη Ρύθμισή σας#
Μετά τη σύνδεση, δοκιμάστε να κάνετε στον πράκτορά σας μερικές ερωτήσεις:
- "Ποια αποθετήρια έχω συνδεδεμένα;" — επαληθεύει ότι η σύνδεση λειτουργεί
- "Πώς γίνεται ο χειρισμός της αυθεντικοποίησης σε αυτόν τον κώδικα;" — δοκιμάζει τη σημασιολογική αναζήτηση
- "Βρες όλες τις συναρτήσεις που καλούν τη βάση δεδομένων" — δοκιμάζει την αναζήτηση εξαρτήσεων
- "Από τι εξαρτάται η κλάση UserService;" — δοκιμάζει την αναζήτηση συμβόλων
Θα πρέπει να δείτε αποτελέσματα με διαδρομές αρχείων και αριθμούς γραμμών από το συνδεδεμένο αποθετήριό σας. Αν όχι, ελέγξτε το troubleshooting section παρακάτω.
Μορφή Αποθετηρίου#
Κατά τον προσδιορισμό αποθετηρίων:
- Με κλάδο:
"owner/repo:branch"(e.g.,"owner/repository:develop") - Προεπιλεγμένος κλάδος:
"owner/repo"
Συμβουλή: Χρησιμοποιήστε το repository_context(action="info", repository="...") για να ελέγξετε την αντιστοίχιση του αποθετηρίου. Ο διακομιστής v3 δεν διατηρεί κατάσταση, επομένως μια παράκαμψη αποθετηρίου ισχύει μόνο για μία κλήση.
Αντιμετώπιση Προβλημάτων#
Προβλήματα Κλειδιού API#
- Επαληθεύστε ότι το κλειδί σας ξεκινά με το πρόθεμα
mgv_ - Ελέγξτε ότι το κλειδί έχει οριστεί σωστά στο περιβάλλον σας
- Βεβαιωθείτε ότι το κλειδί δεν έχει λήξει
Το Αποθετήριο Δεν Βρέθηκε#
- Επαληθεύστε ότι το αποθετήριο είναι συνδεδεμένο στο app.maguyva.ai
- Ελέγξτε ότι η μορφή owner/repo είναι σωστή
- Βεβαιωθείτε ότι έχετε πρόσβαση στο αποθετήριο
Προβλήματα Σύνδεσης MCP#
- Επαληθεύστε ότι το
npxείναι διαθέσιμο στο PATH σας - Ελέγξτε ότι το διακριτικό API σας είναι έγκυρο και δεν έχει λήξει
- Δοκιμάστε τη συνδεσιμότητα στο
https://maguyva.tools/mcp - Ελέγξτε τη σύνταξη διαμόρφωσης MCP του πελάτη σας
Επόμενα Βήματα#
- Αναφορά MCP API - Πλήρης τεκμηρίωση API
- Πώς Λειτουργεί - Κατανοήστε τη βελτιστοποίηση πλαισίου
- Αντιμετώπιση Προβλημάτων - Επιλύστε προβλήματα εγκατάστασης και σύνδεσης