Οδηγός Εγκατάστασης

Εγκαταστήστε το πρόσθετο Maguyva από το κατάστημα προσθέτων του Claude Code:

Προσθέστε το κατάστημα προσθέτων του Maguyva και μετά εγκαταστήστε το πρόσθετο (εκτελέστε κάθε εντολή μέσα στο Claude Code):

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

Το /plugin install ανοίγει τις λεπτομέρειες του πρόσθετου, όπου επιλέγετε το εύρος εγκατάστασης: μόνο εσείς (user), όλοι όσοι δουλεύουν σε αυτό το αποθετήριο (project) ή μόνο εσείς σε αυτό το αποθετήριο (local). Αυτές οι εντολές μέσα στη συνεδρία δεν δέχονται σημαία --scope.

Το πρόσθετο αυθεντικοποιείται μέσω της μεταβλητής περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κέλυφός σας:

export MAGUYVA_API_KEY=mgv_xxxx

Συνιστάται το direnv ανά έργο (.envrc) — τα κλειδιά έχουν εμβέλεια αποθετηρίου, οπότε μια τιμή ανά έργο ταιριάζει με την πρόσβαση κάθε έργου. Μία καθολική εξαγωγή στο κέλυφος λειτουργεί αν ένα κλειδί καλύπτει όλη τη δουλειά σας.

Για ομάδα, μπορείτε εναλλακτικά να εκτελέσετε τη μορφή κελύφους και των δύο εντολών από τη ρίζα του αποθετηρίου, εκτός Claude Code:

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

Το εύρος project καταγράφει το πρόσθετο στο .claude/settings.json του αποθετηρίου, το οποίο κάνετε commit. Αυτό ενεργοποιεί το πρόσθετο για τους συναδέλφους αλλά δεν το κατεβάζει, οπότε κάθε συνάδελφος εκτελεί μία φορά την εντολή εγκατάστασης.

claude mcp add --transport http maguyva https://maguyva.tools/mcp --header 'Authorization: Bearer ${MAGUYVA_API_KEY}'

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Claude Code →

Τεκμηρίωση MCP Claude Code →

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Το claude_desktop_config.json ξεκινά μόνο τοπικούς διακομιστές, γι’ αυτό αυτή η ρύθμιση χρησιμοποιεί τη γέφυρα @maguyva/mcp (απαιτεί Node.js / npx). Το Claude Desktop μπορεί επίσης να φτάσει στο Maguyva ως προσαρμοσμένος σύνδεσμος (Customize → Connectors) με κεφαλίδα αιτήματος authorization, αλλά οι κεφαλίδες αιτήματος είναι σε δοκιμαστική φάση για περιορισμένο αριθμό οργανισμών.

Τι προσθέτει το Maguyva στο Claude Desktop →

Τεκμηρίωση MCP Claude Desktop →

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Τι προσθέτει το Maguyva στο Cursor →

Τεκμηρίωση MCP Cursor →

Προσθέστε στο .vscode/mcp.json του έργου σας ή στο mcp.json του προφίλ σας (εκτελέστε MCP: Open User Configuration):

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Αυτή είναι η μορφή του VS Code (κλειδί servers). Το VS Code επιλύει την αναφορά MAGUYVA_API_KEY από το περιβάλλον στο οποίο ξεκινά. Η ροή Add Server πλέον προτιμά το φορητό .mcp.json (κλειδί mcpServers), το οποίο διαβάζει και το GitHub Copilot CLI· αυτό το αρχείο δεν υποστηρίζει μεταβλητές εισόδου ή αρχεία περιβάλλοντος του VS Code.

Τι προσθέτει το Maguyva στο VS Code / GitHub Copilot →

Τεκμηρίωση MCP VS Code / GitHub Copilot →

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

Το Windsurf είναι πλέον το Devin Desktop. Προσθέστε στο αρχείο ρυθμίσεων MCP του:

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Ο Devin Local, ο προεπιλεγμένος πράκτορας, διαβάζει αυτό το αρχείο από την έκδοση 3.6· οι παλαιότερες εκδόσεις κρατούσαν τους διακομιστές στο κύριο αρχείο ρυθμίσεων και τους μεταφέρουν εδώ κατά την εκκίνηση. Ο παλαιότερος πράκτορας Cascade, με τον οποίο δεν ξεκινούν οι νέες συνομιλίες, διαβάζει το ίδιο αρχείο. Το Devin Desktop επιλύει την αναφορά MAGUYVA_API_KEY από το περιβάλλον στο οποίο ξεκινά.

Τι προσθέτει το Maguyva στο Devin Desktop (Windsurf) →

Τεκμηρίωση MCP Devin Desktop (Windsurf) →

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Τι προσθέτει το Maguyva στο Codex →

Τεκμηρίωση MCP Codex →

Προσθέστε στο ~/.copilot/mcp-config.json:

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

copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο GitHub Copilot CLI →

Τεκμηρίωση MCP GitHub Copilot 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}"
      }
    }
  }
}

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Τι προσθέτει το Maguyva στο Gemini CLI →

Τεκμηρίωση MCP Gemini CLI →

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Cline →

Τεκμηρίωση MCP Cline →

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

Προσθέστε στις ρυθμίσεις του Goose:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Goose →

Τεκμηρίωση MCP Goose →

Στο LM Studio, ανοίξτε την καρτέλα Program στη δεξιά πλαϊνή στήλη, επιλέξτε Install → Edit mcp.json και προσθέστε:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τεκμηρίωση MCP LM Studio →

Αποθηκεύστε ως .continue/mcpServers/maguyva.yaml στον χώρο εργασίας σας (ή προσθέστε την καταχώριση mcpServers στο ~/.continue/config.yaml) και, στη συνέχεια, ορίστε το MAGUYVA_API_KEY στο ~/.continue/.env:

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Το Continue χρησιμοποιεί διακομιστές MCP μόνο σε λειτουργία πράκτορα. Αναζητά το μυστικό στο ~/.continue/.env, έπειτα στα .continue/.env και .env του χώρου εργασίας και τέλος στο περιβάλλον της διεργασίας.

Τι προσθέτει το Maguyva στο Continue →

Τεκμηρίωση MCP Continue →

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

Προσθέστε στις ρυθμίσεις MCP του Kiro CLI (~/.kiro/settings/mcp.json ή .kiro/settings/mcp.json ενός έργου):

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Το Kiro CLI αντικατέστησε το Amazon Q Developer CLI. Κατά την εγκατάσταση αντιγράφει μία φορά τους διακομιστές σας από το ~/.aws/amazonq/mcp.json στο ~/.kiro/settings/mcp.json, και το .kiro/settings/mcp.json ενός έργου έχει προτεραιότητα έναντι του αρχείου χρήστη.

Τεκμηρίωση MCP Kiro CLI (Amazon Q Developer CLI) →

Επικολλήστε στο Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add, ως ρύθμιση JSON:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Αυτή η ρύθμιση χρησιμοποιεί τη γέφυρα @maguyva/mcp (απαιτεί Node.js / npx). Σε αυτόν τον οδηγό δεν έχει επαληθευτεί διαμόρφωση απομακρυσμένης σύνδεσης με την εγγενή υποστήριξη αυτού του πελάτη· αυτό δεν σημαίνει ότι ο πελάτης δεν διαθέτει εγγενή υποστήριξη απομακρυσμένης σύνδεσης. Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.

Τεκμηρίωση MCP PyCharm →

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Zed →

Τεκμηρίωση MCP Zed →

Ενεργοποιήστε το Enable Project MCP στο Settings → MCP και, στη συνέχεια, προσθέστε στο .trae/mcp.json στη ρίζα του έργου σας:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τεκμηρίωση MCP Trae →

Προσθέστε στο opencode.json στη ρίζα του έργου σας:

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Τι προσθέτει το Maguyva στο OpenCode →

Τεκμηρίωση MCP OpenCode →

macOS: ~/.boltai/mcp.json

Προσθέστε στις ρυθμίσεις MCP του BoltAI:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Αυτή η ρύθμιση χρησιμοποιεί τη γέφυρα @maguyva/mcp (απαιτεί Node.js / npx). Σε αυτόν τον οδηγό δεν έχει επαληθευτεί διαμόρφωση απομακρυσμένης σύνδεσης με την εγγενή υποστήριξη αυτού του πελάτη· αυτό δεν σημαίνει ότι ο πελάτης δεν διαθέτει εγγενή υποστήριξη απομακρυσμένης σύνδεσης. Το Maguyva εκτελείται εξ ολοκλήρου απομακρυσμένα — μόνο η γέφυρα εκτελείται τοπικά.

Τεκμηρίωση MCP BoltAI →

Προσθέστε στο librechat.yaml και ορίστε το MAGUYVA_API_KEY στο περιβάλλον του διακομιστή LibreChat:

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

Αυτή η ρύθμιση διαβάζει το κλειδί σας από τη μεταβλητή περιβάλλοντος MAGUYVA_API_KEY. Ορίστε τη στο κλειδί API σας από το app.maguyva.ai, στο περιβάλλον από το οποίο ξεκινά ο πελάτης σας.

Τεκμηρίωση MCP LibreChat →

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

Προσθέστε στις ρυθμίσεις MCP του Antigravity:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Antigravity →

Τεκμηρίωση MCP Antigravity →

Το Claude Cowork δεν φορτώνει διακομιστές από το claude_desktop_config.json· φτάνει σε απομακρυσμένους διακομιστές ως προσαρμοσμένους συνδέσμους. Στο Customize → Connectors, προσθέστε έναν προσαρμοσμένο σύνδεσμο με το URL https://maguyva.tools/mcp, επιλέξτε No sign-in και προσθέστε μια κεφαλίδα αιτήματος authorization με τιμή Bearer ακολουθούμενη από το κλειδί API σας. Οι κεφαλίδες αιτήματος είναι σε δοκιμαστική φάση για περιορισμένο αριθμό οργανισμών· αν το παράθυρο δεν έχει ενότητα Request headers, το Cowork δεν μπορεί ακόμα να ταυτοποιηθεί στο Maguyva. Δείτε την τεκμηρίωση →

Το ChatGPT υποστηρίζει απομακρυσμένους διακομιστές MCP στα πλάνα Business, Enterprise και Edu μέσω Settings → Apps → Create. Απαιτείται ένα απομακρυσμένο τελικό σημείο HTTPS — το ChatGPT δεν υποστηρίζει τοπικούς διακομιστές stdio. Δείτε τον οδηγό MCP της OpenAI για τη ρύθμιση. Δείτε την τεκμηρίωση →

Προσθέστε στο ~/.warp/.mcp.json (ή στο .warp/.mcp.json ενός έργου) ή επικολλήστε το στο Settings → Agents → MCP servers → + Add:

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

Αντικαταστήστε το mgv_xxxx με το κλειδί API σας από app.maguyva.ai.

Τι προσθέτει το Maguyva στο Warp →

Τεκμηρίωση MCP Warp →