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

Hosted MCP

Claude Desktop, Cursor, VS Code, Windsurf veya başka bir MCP istemcisini OAuth ile RunAPI'ye bağlayın.

Markdown'ı görüntüle

Hosted MCP, RunAPI araçlarını kullanmanın önerilen yoludur. MCP istemciniz doğrudan RunAPI’ye bağlanır; bu nedenle Node.js yüklemenize veya yerel bir işlemi çalışır halde tutmanıza gerek yoktur.

Bu uç noktayı kullanın:

TEXT 
https://mcp.runapi.ai/mcp

Aşağıdan MCP istemcinizi seçin. İstemci RunAPI’yi tarayıcınızda açtığında oturum açın, kullanılacak Hesabı seçin ve erişimi onaylayın.

Claude Desktop

  1. Settings > Connectors bölümünü açın ve özel bir bağlayıcı ekleyin.
  2. Adını RunAPI koyun ve yukarıdaki uç noktayı girin.
  3. Connect seçeneğini belirleyin ve tarayıcınızda RunAPI yetkilendirmesini tamamlayın.
  4. Bir konuşmada + > Connectors bölümünü açın ve RunAPI’yi etkinleştirin.

RunAPI bir konuşmada görünmüyorsa Ayarlar > Bağlayıcılar bölümüne dönün, yeniden bağlayın ve söz konusu konuşma için etkinleştirildiğini doğrulayın.

İmleç

RunAPI’yi Cursor mcp.json dosyanıza, örneğin proje düzeyindeki .cursor/mcp.json dosyasına ekleyin:

JSON 
{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Cursor kenar çubuğunda Customize seçeneğini açın, RunAPI’yi bulun, etkinleştirin ve tarayıcınızda yetkilendirmeyi tamamlayın.

RunAPI bağlı görünmeli ve araçlarını göstermelidir. Bağlantı veya kimlik doğrulama hataları için Çıktı panelini açın ve MCP Günlükleri‘ni seçin.

VS Code

  1. Komut Paleti’ni açın ve MCP: Add Server komutunu çalıştırın.
  2. HTTP seçeneğini belirleyin, yukarıdaki uç noktayı girin ve sunucuyu RunAPI olarak adlandırın.
  3. Sunucuyu başlatın, istendiğinde güvenin ve tarayıcınızda yetkilendirmeyi tamamlayın.

RunAPI araçları Sohbet’te görünmelidir. Hatalar için MCP: Sunucuları Listele‘yi çalıştırın, RunAPI’yi seçin ve Çıktıyı Göster‘i seçin.

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 ve ~/.codeium/windsurf/mcp_config.json dosyasını ham haliyle düzenleyin.
  2. RunAPI’yi uzak HTTP sunucusu olarak ekleyin:
JSON 
{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}
  1. Dosyayı kaydedin, MCP sunucularını yenileyin, RunAPI’yi etkinleştirin ve tarayıcınızda yetkilendirmeyi tamamlayın.

Araçlar görünmüyorsa MCP ayarlarını açın, RunAPI’nin etkinleştirildiğini doğrulayın ve yeniden bağlayın.

Diğer MCP istemcileri

Yukarıdaki uç noktayı Streamable HTTP sunucusu olarak ekleyin. İstemci, Remote MCP ve tarayıcı tabanlı OAuth desteğine sahip olmalıdır. İstendiğinde yetkilendirmeyi tamamlayın, ardından istemcide RunAPI araçlarını etkinleştirin.

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, bağlantının ve araç yönlendirmesinin çalıştığını doğrular.

Bunun yerine bir API anahtarı kullanın

OAuth önerilen yoldur. Gözetimsiz bir istemci için veya OAuth kullanılamadığında yalnızca özel bir standart API anahtarı kullanın; bir tane oluşturmak için Kimlik Doğrulama Kılavuzu‘nu izleyin. Anahtarı asla uç nokta URL’sine koymayın veya bir depoya işlemeyin.

  • Claude Desktop: Özel bağlayıcılar için İstek başlıkları mevcutsa, değeri Bearer YOUR_API_KEY olan bir Authorization başlığı ekleyin.
  • Cursor: RUNAPI_API_KEY değerini Cursor uygulamasının görebildiği ortama ayarlayın, ardından sunucu headers bölümünde Authorization: Bearer ${env:RUNAPI_API_KEY} kullanın. Uzak sunucular Cursor envFile ayarlarını okumaz.
  • VS Code: VS Code’un anahtarı mcp.json dosyasına yazmak yerine sizden isteyip saklaması için sunucu Authorization başlığından parola türünde bir ${input:...} referansı verin.
  • Windsurf: ~/.codeium/windsurf/mcp_config.json dosyasındaki Authorization başlığından ${env:RUNAPI_API_KEY} veya ${file:...} referansı verin.

İstemci kullanımdan kaldırıldığında veya anahtarın ifşa edilmiş olabileceği durumlarda anahtarı API Anahtarları sayfasından iptal edin.

Sorun giderme

  • Yetkilendirme tamamlanmadı: RunAPI’yi istemciden yeniden bağlayın ve tarayıcı akışını baştan tamamlayın.
  • RunAPI bağlı ancak araçları eksik: sunucunun etkin olduğunu doğrulayın, tam uç noktayı kaldırıp tekrar ekleyin, ardından yeni bir konuşma başlatın.
  • Doğrulama sorusu başarısız oluyor: yukarıdaki ilgili bölümde açıklanan istemci günlüğünü kontrol edin, ardından yeniden denemeden önce RunAPI’yi yeniden bağlayın.

Bunun yerine RunAPI’yi makinenizde başlatacak bir istemciye mi ihtiyacınız var? Yerel MCP’yi Kurun.