İçeriğe geç
Geliştirici Kaynakları
Geliştirici Kaynakları

Yerel MCP

RunAPI MCP Sunucusunu Claude Code, Cursor, VS Code, Windsurf veya başka bir stdio istemcisiyle yerel olarak çalıştırın.

Markdown'ı görüntüle

Yerel MCP, MCP istemcinizin makinenizde RunAPI MCP Sunucusunu başlatmasını sağlar. İstemci Uzak MCP’yi desteklemediğinde veya açıkça yerel bir sürece ihtiyaç duyduğunuzda kullanın.

Başlamadan önce

Node.js’yi yükleyin ve npx‘in kullanılabilir olduğunu doğrulayın. MCP istemcinizin yerel stdio sunucularını desteklemesi gerekir.

Aşağıdaki her istemci aynı komutu başlatır:

SHELL 
npx -y @runapi.ai/mcp

Katalog araçlarına oturum açmadan bağlanabilir ve kullanabilirsiniz.

Claude Code

Çalıştırın:

SHELL 
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

RunAPI’yi projelerinizde kullanılabilir kılmak için -s user seçeneğini kullanın. Zaten çalışıyorsa Claude Code’u yeniden başlatın, ardından RunAPI’nin bir MCP sunucusu olarak listelendiğini doğrulayın.

İmleç

Sunucuyu .cursor/mcp.json veya kullanıcı MCP yapılandırmanızdaki mcpServers altına ekleyin:

JSON 
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

Cursor kenar çubuğunda Customize seçeneğini açın, RunAPI’yi bulun ve etkinleştirin. İşlem başlamazsa Output panelini açın ve MCP Logs seçeneğini belirleyin.

VS Code

  1. Komut Paleti’ni açın ve MCP: Add Server komutunu çalıştırın.
  2. Command (stdio) seçeneğini belirleyin ve npx -y @runapi.ai/mcp girin.
  3. Sunucuyu RunAPI olarak adlandırın, yapılandırma kapsamını seçin ve sunucuyu başlatın.
  4. İstendiğinde sunucuya güvenin. Hata durumunda MCP: List Servers komutunu çalıştırın, RunAPI’yi seçin ve Show Output seçeneğini belirleyin.

VS Code, manuel yapılandırmayı üst düzey servers anahtarı altında saklar ve type: "stdio" kullanır.

Windsurf

Bu adımlar Cascade aracısı için geçerlidir. Devin Local, Devin CLI yapılandırmasını kullanır.

  1. Devin Settings > Cascade > MCP Servers bölümünü açın.
  2. ~/.codeium/windsurf/mcp_config.json adresindeki ham MCP yapılandırmasını açın.
  3. Yukarıdaki Cursor örneğinde gösterilen npx komutu ve argümanlarıyla RunAPI’yi ekleyin.
  4. Dosyayı kaydedin, MCP sunucularını yenileyin ve RunAPI’yi etkinleştirin.

Diğer MCP istemcileri

RunAPI adında yerel bir stdio sunucusu ekleyin. Komutunu npx, argümanlarını ise -y ve @runapi.ai/mcp olarak ayarlayın. Yapılandırmayı kaydettikten sonra istemciyi yeniden başlatın veya yenileyin.

Bağlantıyı doğrulayın

İstemcinize sorun:

Hangi RunAPI görüntü modelleri kullanılabilir?

İstemci list_models çağrısı yapmalı ve kullanılabilir görüntü modellerini döndürmelidir. Bu genel keşif aracı kimlik doğrulaması gerektirmez.

Gerektiğinde oturum açın

Oturum açmadan keşif araçlarını kullanmaya devam edin. RunAPI’den ilk kez bir görev oluşturmasını, bir görevi almasını veya bir bakiyeyi kontrol etmesini istediğinizde istemcinin login aracını çağırmasına izin verin. Bu araç RunAPI’yi tarayıcınızda açar ve kimlik bilgisini paylaşılan yerel yapılandırmaya kaydeder.

Bir terminalden oturum açmayı tercih ediyorsanız RunAPI CLI aracını yükleyip şunu çalıştırın:

SHELL 
runapi login

Gözetimsiz veya CI istemcileri için Kimlik Doğrulama Kılavuzu‘nu takip ederek adanmış bir standart API anahtarı oluşturun, ardından istemcinin ortam veya gizli yapılandırması aracılığıyla RUNAPI_API_KEY olarak sağlayın. Ortam anahtarı, Yerel MCP Girişiyle kaydedilen kimlik bilgisine göre öncelik taşır.

Sorun giderme

  • npx bulunamıyor: node --version ve npx --version komutlarının çalıştığını doğrulayın, ardından MCP istemcisini güncellenmiş ortamı alması için tam olarak yeniden başlatın.
  • Yerel sunucu hemen kapanıyor: bir terminalde npx -y @runapi.ai/mcp komutunu çalıştırın, bildirilen Node.js veya paket hatasını düzeltin, ardından istemciyi yeniden başlatın.
  • RunAPI araçları görünmüyor: sunucunun etkin olduğunu ve komutun stdio kullandığını doğrulayın, ardından yukarıda açıklanan istemci günlüğünü kontrol edin.
  • Kimlik doğrulaması gerektiren bir araç başarısız oluyor: istemciden login aracını çağırmasını isteyin. RUNAPI_API_KEY ayarlıysa, Yerel MCP Girişini tekrar denemeden önce güncelleyin veya kaldırın.

Yerel bir Node.js işlemi olmadan bağlantı mı tercih ediyorsunuz? Barındırılan MCP’yi kurun.