MCP’yi EuroVDC Sofya VPS’te Kurma Rehberi

Kendi yazdığınız veya üçüncü taraf bir MCP’yi (eurovdc-mcp dışında) Sofya VPS’te nasıl barındıracağınız için bkz. MCP sunucusunu EuroVDC VPS’te barındırma.

Claude, Cursor veya kendi ajan stack’iniz için Model Context Protocol (MCP) sunucusunu Sofya’daki EuroVDC Bulut VPS üzerinde çalıştırmak, tunnel ürününe ihtiyaç duymadan HTTPS ile dışarı açmak anlamına gelir. Bu rehber, açık kaynak eurovdc-mcp deposunu production’a yakın bir düzende kurmanıza yardımcı olur.

EuroVDC’nin herkese açık MCP uç noktası zaten /mcp üzerinde çalışır. Kendi VPS’inizde barındırmak istediğinizde ise süreç, domain, TLS ve süreç yönetimi sizin kontrolünüzdedir. Aşağıdaki adımlar Sofya NVMe bulut planları içindir; aynı mantık diğer EuroVDC VPS’lerde de geçerlidir.

Bu kurulum kime uygun?

• Claude Desktop veya Cursor’a kendi MCP URL’nizi vermek isteyen ekipler
• Tunnel veya üçüncü taraf köprü kullanmadan AB içinde (Sofya) barındırmak isteyenler
• Domain, hosting ve sepet araçlarını ajanlara kendi altyapılarından sunmak isteyenler

1. Sofya Bulut / VPS planı alın

Önce sabit IP’li bir Sofya Bulut Sunucu planı seçin. MCP Node sürecinin yanında Nginx veya Caddy gibi bir reverse proxy çalıştıracağınız için en az 1 vCPU ve 2 GB RAM rahat bir başlangıçtır. Sipariş sonrası SSH ile sunucuya bağlanın ve güncellemeleri uygulayın.

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs git nginx certbot python3-certbot-nginx
node -v && npm -v

2. Depoyu klonlayın ve bağımlılıkları kurun

Uygulama dizinini oluşturup GitHub deposunu alın:

sudo mkdir -p /opt/eurovdc-mcp
sudo chown $USER:$USER /opt/eurovdc-mcp
cd /opt/eurovdc-mcp
git clone https://github.com/eurovdceu/eurovdc-mcp .
npm install
npm run build

Depo README’sindeki ortam değişkenlerini (.env) doldurun. Public EuroVDC API’ye bağlanacaksanız anahtar ve dil parametrelerini dokümantasyondaki örneklere göre ayarlayın. Gizli anahtarları asla Git’e eklemeyin.

3. systemd ile sürekli çalıştırın

Node sürecinin SSH kapanınca düşmemesi için systemd birimi kullanın:

sudo tee /etc/systemd/system/eurovdc-mcp.service > /dev/null <<'EOF'
[Unit]
Description=EuroVDC MCP server
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/eurovdc-mcp
EnvironmentFile=/opt/eurovdc-mcp/.env
ExecStart=/usr/bin/node dist/index.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now eurovdc-mcp
sudo systemctl status eurovdc-mcp --no-pager

Uygulama yerel bir porta (örneğin 3100) dinliyorsa bunu bir sonraki adımda proxy ile dışarı açacaksınız. Port numarasını README ile doğrulayın.

4. TLS reverse proxy ekleyin

MCP istemcileri genelde https://alanadiniz.com/mcp bekler. Nginx örneği:

server {
    listen 80;
    server_name mcp.alanadiniz.com;

    location / {
        proxy_pass http://127.0.0.1:3100;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
    }
}

Sertifikayı Let’s Encrypt ile alın:

sudo certbot --nginx -d mcp.alanadiniz.com

DNS A kaydını Sofya VPS IP’nize yönlendirmeyi unutmayın. Yerel geliştirmede tunnel gerekmez; stdio ile Claude Desktop da bağlanabilir. Canlı kullanımda HTTPS tercih edin.

5. Claude veya Cursor’a bağlayın

Streamable HTTP için istemci yapılandırmasında URL olarak https://mcp.alanadiniz.com/mcp verin. Cursor veya Claude tarafındaki MCP ayarlarında bu adresi kaydedin, ardından araç listesinin geldiğini doğrulayın.

Yerel deneme için stdio yolu README’de anlatıldığı gibi node komutuyla çalışır; production’da HTTPS URL daha yönetilebilir olur.

6. Gecikmeyi Sofya Looking Glass ile kontrol edin

Avrupa müşterileriniz için RTT’yi Sofya Looking Glass üzerinden ölçün. MCP çağrıları kısa JSON-RPC istekleridir; Sofya çıkışlı düşük gecikme, ajan deneyimini doğrudan etkiler.

Hazırlığı doğrulayın

Sunucu ayağa kalktıktan sonra AI Hazırlık Kontrolü ile alan adınızı taratın. /.well-known/mcp.json ve isteğe bağlı MCP initialize adımları skora yansır. EuroVDC ajan dokümantasyonu için AI Ajanları sayfasına bakın.

Sıkça sorulan sorular

Tunnel ürünü şart mı?

Hayır. Kendi VPS’inizde TLS reverse proxy ile yayınladığınızda tunnel gerekmez. Yerelde stdio da yeterlidir.

Minimum sunucu boyutu nedir?

Tek bir MCP süreci için küçük Sofya bulut planı yeterlidir. Trafik ve ek servisler artarsa vCPU ve RAM’i büyütün.

EuroVDC’nin public /mcp uç noktası ile farkı ne?

Public uç nokta EuroVDC’nin yönettiği paylaşımlı MCP’dir. Kendi VPS’inizde kurulum, domain, log ve ölçek üzerinde tam kontrol sağlar.

systemd şart mı?

Şart değil ama önerilir. PM2 veya Docker da kullanılabilir; önemli olan sürecin kalıcı ve yeniden başlatılabilir olmasıdır.

Claude neden bağlanamıyor?

DNS, sertifika, firewall (80/443) ve uygulama portunu kontrol edin. systemctl status ve Nginx error log çoğu sorunu gösterir.

AI hazırlık skorunda MCP satırı neden kırmızı?

Manifest dosyası veya initialize yanıtı eksik olabilir. /.well-known/mcp.json yayınlayıp HTTPS üzerinden initialize’ın 2xx döndüğünü doğrulayın.