İç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 Windsurf dahil 24 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 deposuna 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 depoya 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/claude-code-plugin
/plugin install maguyva@maguyva

Kullanıcı hesabınız için yükler. Bir takım için, eklentiyi reponun .claude/settings.json dosyasına işleyerek takım arkadaşlarının otomatik olarak almasını sağlamak üzere her iki komuta da --scope project ekleyin.

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 için tek bir anahtar yetiyorsa küresel bir shell export'u da işe yarar.

Manuel (.mcp.json) — gelişmiş
.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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

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

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

Claude Desktop, uzak sunucuları yalnızca Settings üzerinden OAuth "connector"ları olarak destekler, claude_desktop_config.json içinde header ile kimlik doğrulanan bir giriş olarak değil; bu yüzden mcp-remote köprüsünü kullanır (Node.js / npx gerektirir).

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

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

Cursor MCP belgeleri →

VS Code / GitHub Copilot

Projenizdeki .vscode/mcp.json dosyasına ekleyin (ya da kullanıcı ayarlarına):

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

VS Code / GitHub Copilot MCP belgeleri →

Windsurf

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

Windsurf MCP yapılandırmanıza ekleyin:

mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "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.

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"

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

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

Codex MCP belgeleri →

GitHub Copilot CLI

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

.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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

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

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

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": {
      "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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

Cline MCP belgeleri →

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

Roo Code MCP ayarlarınıza ekleyin:

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

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

Roo Code MCP belgeleri →

Goose

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

Goose yapılandırmanıza ekleyin:

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

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

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

Goose MCP belgeleri →

LM Studio

LM Studio, Agent yapılandırması aracılığıyla MCP sunucularını destekler. Settings → Agent → MCP Servers bölümünden standart mcpServers JSON biçimini kullanarak yeni bir MCP sunucusu ekleyin. LM Studio, MCP sunucularına stdio üzerinden bağlanır. Belgelere bakın →

Continue

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

Continue yapılandırmanıza ekleyin (~/.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"
      }
    }
  }
}

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

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

Continue MCP belgeleri →

Amazon Q Developer

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

Amazon Q MCP yapılandırmanıza ekleyin:

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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

Amazon Q Developer MCP belgeleri →

PyCharm

Proje kök dizininizdeki .ai/mcp/mcp.json dosyasına ekleyin ya da Settings > Tools > AI Assistant > MCP içine yapıştırın:

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

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

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). 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 ${MAGUYVA_API_KEY}"
      }
    }
  }
}

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

Zed MCP belgeleri →

Trae

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

.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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

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

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

OpenCode MCP belgeleri →

BoltAI

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

BoltAI MCP yapılandırmanıza ekleyin:

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

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

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

BoltAI MCP belgeleri →

LibreChat

LibreChat yapılandırmanıza ekleyin:

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

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

Bu istemci henüz özel bir auth header'ı ile uzak bir MCP sunucusunu desteklemiyor, bu yüzden mcp-remote köprüsü üzerinden bağlanır (Node.js / npx gerektirir). Maguyva tamamen uzaktan çalışır — yalnızca köprü yerel olarak çalışır.

LibreChat MCP belgeleri →

Antigravity

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

Antigravity MCP yapılandırmanıza ekleyin:

mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "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.

Antigravity MCP belgeleri →

Claude Cowork

Claude Cowork, diğer Anthropic istemcileriyle aynı MCP biçimini kullanır:

{
  "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 ifadesini app.maguyva.ai üzerinden alınan API anahtarınızla değiştirin.

Claude Cowork MCP belgeleri →

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, Agent Mode'da MCP sunucularını destekler. Yapılandırma Warp arayüzü üzerinden yönetilir (Settings → Agent Mode → MCP Servers) ve Warp Drive üzerinden senkronize edilir. Bir sunucu eklerken standart mcpServers JSON'ını yapıştırın. Belgelere bakın →

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

Kurulumunuzu Doğrulayın#

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

  • "Hangi depoları 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ı deponuzdan 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.

Depo Biçimi#

Depoları belirtirken:

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

İpucu: Depo çözümlemesini doğrulamak için repository_context(action="info", repository="...") komutunu kullanın. v3 sunucusu durumsuzdur; bu nedenle depo geçersiz kılmaları yalnızca tek bir ç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

Depo Bulunamadı#

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

MCP Bağlantı Sorunları#

  • npx'in 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#