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 SHA2562. 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
- MCP-CORE Gateway ekranında status değerini kontrol et.
- AI uygulamasında MCP tool listesinin göründüğünü doğrula.
- Basit, düşük riskli bir tool çağrısı yap.
- Tool Calls ekranında çağrının app, server, tool, latency ve status bilgisiyle göründüğünü doğrula.
Sorun giderme
| Belirti | Muhtemel neden | Ne yap |
|---|---|---|
| Gateway çalışmıyor | Port çakışması veya yetki problemi | Portu 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ğil | Server detayında Required Env alanlarını tamamla. |
| Public URL erişilemiyor | Tunnel kapalı veya firewall engeli | Public URL’i yalnızca kontrollü test için aç; güvenlik uyarılarını kontrol et. |