İçeriğe atla

Kurulum Kılavuzu

5 dakikadan kısa sürede kurulumu tamamlayın. Bu kılavuz, Claude Code, Claude Desktop, Cursor, VS Code / GitHub Copilot ve Devin Desktop (Windsurf) dahil 23 MCP istemcisi ve daha fazlası için kurulum içerir.

Ön koşullar: app.maguyva.ai üzerinden bir API anahtarına ve bağlı bir GitHub reposuna ihtiyacınız olacak.

Ortam Kurulumu

#

Önce API anahtarınızı bir ortam değişkenine ayarlayın. MCP istemciniz bir istek varsayılanı sağladığında veya anahtar tam olarak bir repoya erişebildiğinde repository öğesini atlayın; aksi halde açıkça iletin.

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden aldığınız gerçek API anahtarınızla değiştirin.

İstemci Yapılandırması

#

Belirli kurulum talimatları için aşağıdan MCP istemcinizi seçin.

Uyumluluk notu: Maguyva standart MCP kullanır. Henüz özel bir kurulum rehberi yazmamış olsak bile, MCP desteği olan herhangi bir istemci aynı sunucuya bağlanabilir.

Claude Code

Maguyva eklentisini Claude Code marketplace'inden yükleyin:

Maguyva marketplace'ini ekleyin, ardından eklentiyi yükleyin (her komutu Claude Code içinde çalıştırın):

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

/plugin install eklentinin ayrıntılarını açar; kurulum kapsamını orada seçersiniz: yalnızca siz (user), bu repoda çalışan herkes (project) veya bu repoda yalnızca siz (local). Oturum içindeki bu komutların --scope bayrağı yoktur.

Eklenti, MAGUYVA_API_KEY ortam değişkeni üzerinden kimlik doğrular. Bunu shell'inizde ayarlayın:

export MAGUYVA_API_KEY=mgv_xxxx

Proje başına direnv (.envrc) önerilir — anahtarlar repo kapsamlıdır, bu yüzden proje başına bir değer her projenin erişimiyle eşleşir. Tüm çalışmanız için tek bir anahtar yetiyorsa küresel bir shell export'u da işe yarar.

Bir takım için bunun yerine iki komutun shell biçimini Claude Code dışında, reponun kök dizininden çalıştırabilirsiniz:

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

project kapsamı eklentiyi reponun .claude/settings.json dosyasına kaydeder ve bu dosyayı siz commit'lersiniz. Bu, eklentiyi takım arkadaşlarınız için etkinleştirir ama indirmez; bu yüzden her takım arkadaşı kurulum komutunu bir kez çalıştırır.

Manuel (.mcp.json) — gelişmiş
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}"
      }
    }
  }
}

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Claude Code için ne katar →

Claude Code MCP belgeleri →

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 yapılandırma dosyanıza ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

claude_desktop_config.json yalnızca yerel sunucuları başlatır; bu yüzden bu kurulum @maguyva/mcp köprüsünü kullanır (Node.js / npx gerektirir). Claude Desktop, Maguyva’ya bir authorization istek başlığıyla özel bağlayıcı olarak da (Customize → Connectors) ulaşabilir, ancak istek başlıkları sınırlı sayıda kuruluş için betadadır.

Maguyva, Claude Desktop için ne katar →

Claude Desktop MCP belgeleri →

Cursor

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

Proje kök dizininizdeki .cursor/mcp.json dosyasına ekleyin:

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Maguyva, Cursor için ne katar →

Cursor MCP belgeleri →

VS Code / GitHub Copilot

Projenizdeki .vscode/mcp.json dosyasına ya da profilinizin mcp.json dosyasına ekleyin (MCP: Open User Configuration komutunu çalıştırın):

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Bu, VS Code biçimidir (servers anahtarı). VS Code, MAGUYVA_API_KEY referansını başlatıldığı ortamdan çözer. Add Server akışı artık GitHub Copilot CLI’ın da okuduğu taşınabilir .mcp.json dosyasını (mcpServers anahtarı) tercih ediyor; bu dosya VS Code girdi değişkenlerini veya ortam dosyalarını desteklemez.

Maguyva, VS Code / GitHub Copilot için ne katar →

VS Code / GitHub Copilot MCP belgeleri →

Devin Desktop (Windsurf)

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

Windsurf artık Devin Desktop. MCP yapılandırma dosyasına ekleyin:

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Varsayılan ajan Devin Local bu dosyayı 3.6 sürümünden itibaren okur; önceki sürümler sunucuları ana yapılandırma dosyasında tutuyordu ve başlangıçta buraya taşır. Yeni konuşmaların başlatılmadığı eski Cascade ajanı da aynı dosyayı okur. Devin Desktop, MAGUYVA_API_KEY referansını başlatıldığı ortamdan çözer.

Maguyva, Devin Desktop (Windsurf) için ne katar →

Devin Desktop (Windsurf) MCP belgeleri →

Codex

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

Codex CLI yapılandırmanıza ekleyin (~/.codex/config.toml):

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Maguyva, Codex için ne katar →

Codex MCP belgeleri →

GitHub Copilot CLI

~/.copilot/mcp-config.json dosyasına ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, GitHub Copilot CLI için ne katar →

GitHub Copilot CLI MCP belgeleri →

Gemini CLI

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

Gemini CLI ayarlarınıza ekleyin (~/.gemini/settings.json):

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Maguyva, Gemini CLI için ne katar →

Gemini CLI MCP belgeleri →

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

Cline MCP ayarlarınıza ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Cline için ne katar →

Cline MCP belgeleri →

Goose

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

Goose yapılandırmanıza ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Goose için ne katar →

Goose MCP belgeleri →

LM Studio

LM Studio’da sağ kenar çubuğundaki Program sekmesini açın, Install → Edit mcp.json seçeneğini seçin ve şunu ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

LM Studio MCP belgeleri →

Continue

Çalışma alanınızda .continue/mcpServers/maguyva.yaml olarak kaydedin (ya da mcpServers girdisini ~/.continue/config.yaml dosyasına ekleyin), ardından ~/.continue/.env içinde MAGUYVA_API_KEY değerini ayarlayın:

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Continue MCP sunucularını yalnızca ajan modunda kullanır. Secret’ı önce ~/.continue/.env, sonra çalışma alanındaki .continue/.env ve .env, en son da süreç ortamında arar.

Maguyva, Continue için ne katar →

Continue MCP belgeleri →

Kiro CLI (Amazon Q Developer CLI)

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

Kiro CLI'ın MCP yapılandırmasına (~/.kiro/settings/mcp.json ya da bir projede .kiro/settings/mcp.json) ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Kiro CLI, Amazon Q Developer CLI'ın yerini aldı. Kurulum sırasında sunucularınızı ~/.aws/amazonq/mcp.json dosyasından ~/.kiro/settings/mcp.json dosyasına bir kez kopyalar; bir projenin .kiro/settings/mcp.json dosyası kullanıcı dosyasından önceliklidir.

Kiro CLI (Amazon Q Developer CLI) MCP belgeleri →

PyCharm

Settings | Tools | AI Assistant | Model Context Protocol (MCP) → Add bölümüne JSON yapılandırması olarak yapıştırın: 

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Bu kurulum @maguyva/mcp köprüsünü kullanır (Node.js / npx gerektirir). Bu kılavuzda, bu istemcinin yerleşik desteğini kullanan bir uzak bağlantı yapılandırması doğrulanmamıştır; bu, istemcinin yerleşik uzak bağlantı desteği olmadığı anlamına gelmez. Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

PyCharm MCP belgeleri →

Zed

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

Zed ayarlarınıza ekleyin (~/.config/zed/settings.json):

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Zed için ne katar →

Zed MCP belgeleri →

Trae

Settings → MCP altında Enable Project MCP seçeneğini açın, ardından proje kök dizininizdeki .trae/mcp.json dosyasına ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Trae MCP belgeleri →

OpenCode

Proje kök dizininizdeki opencode.json dosyasına ekleyin:

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

Maguyva, OpenCode için ne katar →

OpenCode MCP belgeleri →

BoltAI

macOS: ~/.boltai/mcp.json

BoltAI MCP yapılandırmanıza ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Bu kurulum @maguyva/mcp köprüsünü kullanır (Node.js / npx gerektirir). Bu kılavuzda, bu istemcinin yerleşik desteğini kullanan bir uzak bağlantı yapılandırması doğrulanmamıştır; bu, istemcinin yerleşik uzak bağlantı desteği olmadığı anlamına gelmez. Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

BoltAI MCP belgeleri →

LibreChat

librechat.yaml dosyasına ekleyin ve LibreChat sunucusunun ortamında MAGUYVA_API_KEY değerini ayarlayın:

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

Bu yapılandırma anahtarınızı MAGUYVA_API_KEY ortam değişkeninden okur. İstemcinizin başlatıldığı ortamda bu değişkeni app.maguyva.ai adresinden aldığınız API anahtarına ayarlayın.

LibreChat MCP belgeleri →

Antigravity

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

Antigravity MCP yapılandırmanıza ekleyin:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Antigravity için ne katar →

Antigravity MCP belgeleri →

Claude Cowork

Claude Cowork sunucuları claude_desktop_config.json dosyasından yüklemez; uzak sunuculara özel bağlayıcılar olarak ulaşır. Customize → Connectors bölümünde https://maguyva.tools/mcp URL’siyle özel bir bağlayıcı ekleyin, No sign-in seçeneğini seçin ve değeri Bearer ile ardından API anahtarınız olan bir authorization istek başlığı ekleyin. İstek başlıkları sınırlı sayıda kuruluş için betadadır; iletişim kutusunda Request headers bölümü yoksa Cowork henüz Maguyva’ya kimlik doğrulaması yapamaz. Belgelere bakın →

ChatGPT

ChatGPT, Business, Enterprise ve Edu planlarında Settings → Apps → Create üzerinden uzak MCP sunucularını destekler. Uzak bir HTTPS uç noktası gereklidir — ChatGPT yerel stdio sunucularını desteklemez. Kurulum için OpenAI'nin MCP rehberine bakın. Belgelere bakın →

Warp

~/.warp/.mcp.json dosyasına (ya da bir projedeki .warp/.mcp.json dosyasına) ekleyin veya Settings → Agents → MCP servers → + Add alanına yapıştırın:

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

mgv_xxxx ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Maguyva, Warp için ne katar →

Warp MCP belgeleri →

Maguyva standart MCP kullanır. Protokolü destekleyen herhangi bir istemci bağlanabilir — yukarıda birinci taraf bir kılavuz olmasa bile. 23 istemci belgelenmiştir, düzenli olarak yenileri eklenir.

Kurulumunuzu Doğrulayın

#

Bağlandıktan sonra, ajanınıza birkaç soru sormayı deneyin:

  • "Hangi repoları bağladım?" — bağlantının çalıştığını doğrular
  • "Bu kod tabanında kimlik doğrulama nasıl işleniyor?" — semantik aramayı test eder
  • "Veritabanını çağıran tüm işlevleri bul" — bağımlılık aramasını test eder
  • "UserService sınıfı neye bağımlı?" — sembol bulmayı test eder

Bağlı reponuzdan dosya yolları ve satır numaraları içeren sonuçlar görmelisiniz. Görmüyorsanız, aşağıdaki troubleshooting section bölümünü kontrol edin.

Repo Biçimi

#

Repoları belirtirken:

  • Dal ile: "owner/repo:branch" (e.g., "owner/repository:develop")
  • Varsayılan dal: "owner/repo"

İpucu: Repo çözümlemesini kontrol etmek için repository_context(action="info", repository="...") kullanın. Repoyu geçersiz kılan açık seçim yalnızca mevcut çağrı için geçerlidir.

Sorun Giderme

#

API Anahtarı Sorunları

#
  • Anahtarınızın mgv_ öneki ile başladığını doğrulayın
  • Anahtarın ortamınızda doğru şekilde ayarlandığını kontrol edin
  • Anahtarın süresinin dolmadığından emin olun

Repo Bulunamadı

#
  • Reponun app.maguyva.ai üzerinde bağlı olduğunu doğrulayın
  • owner/repo biçiminin doğru olduğunu kontrol edin
  • Repoya erişiminiz olduğundan emin olun

MCP Bağlantı Sorunları

#
  • İstemciniz @maguyva/mcp köprüsünü kullanıyorsa npx komutunun PATH içinde kullanılabilir olduğunu doğrulayın
  • API tokeninizin geçerli ve süresi dolmamış olduğunu kontrol edin
  • https://maguyva.tools/mcp adresine bağlantıyı test edin
  • İstemcinizin MCP yapılandırma sözdizimini kontrol edin

Sonraki Adımlar

#

İlgili

Sıradaki okuma