Quick Start

MCP-CORE Personal hızlı başlangıç.

Amaç: Uygulamayı kur, local gateway’i başlat, AI uygulamanı bağla ve ilk tool çağrısını görünür hale getir.

Gereksinimler

  • Windows masaüstü ortamı. macOS ve Linux paketleri henüz aktif değildir.
  • MCP uyumlu AI uygulaması: Claude, Cursor, VS Code veya benzeri client.
  • Kurulacak MCP server’ın gerektirdiği runtime: Node.js, Python, Docker veya özel binary.
  • Gerekli ise API token / access key. Bu değerler UI içinde maskelenmelidir.

1. Uygulamayı kur

İndirme sayfasından Windows installer dosyasını indir. Release notunu, dosya boyutunu ve SHA256 değerini kontrol et.

SHA256 doğrulama

# Windows PowerShell
Get-FileHash .\MCP-CORE-Personal.exe -Algorithm SHA256

2. Local gateway’i başlat

Uygulama açıldığında Gateway ekranında varsayılan local endpoint görünür.

http://localhost:8787/mcp
  • Status değeri Running olmalı.
  • Port çakışması varsa uygulama uyarı vermeli.
  • Public URL kapalı gelmeli; yalnızca kontrollü test için açılmalı.

3. Claude bağlantı örneği

Claude tarafında MCP server config alanına MCP-CORE local gateway’i ekle.

{
  "mcpServers": {
    "mcp-core": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

Uygulama, Claude config çıktısını kopyalanabilir şekilde üretmelidir.

4. Cursor bağlantı örneği

Cursor MCP ayarlarında local gateway endpoint’i kullan.

{
  "mcpServers": {
    "mcp-core": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

Config formatı kullanılan Cursor sürümüne göre değişirse uygulama, sürüm bazlı yönlendirme göstermelidir.

5. VS Code bağlantı örneği

VS Code tarafında workspace veya user düzeyinde mcp.json dosyası kullanılabilir.

{
  "servers": {
    "mcp-core": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

Workspace bazlı kullanım için dosya genellikle repository içindeki .vscode/mcp.json yaklaşımıyla yönetilir.

6. Bağlantıyı doğrula

  1. MCP-CORE Gateway ekranında status değerini kontrol et.
  2. AI uygulamasında MCP tool listesinin göründüğünü doğrula.
  3. Basit, düşük riskli bir tool çağrısı yap.
  4. Tool Calls ekranında çağrının app, server, tool, latency ve status bilgisiyle göründüğünü doğrula.

Sorun giderme

BelirtiMuhtemel nedenNe yap
Gateway çalışmıyorPort çakışması veya yetki problemiPortu değiştir, uygulamayı yeniden başlat.
Tool listesi boşMCP server kurulmamış veya config hatalıFind MCP ekranında server health check çalıştır.
Env eksik hatasıAPI key / token tanımlı değilServer detayında Required Env alanlarını tamamla.
Public URL erişilemiyorTunnel kapalı veya firewall engeliPublic URL’i yalnızca kontrollü test için aç; güvenlik uyarılarını kontrol et.