PoYo MCP Server
Her PoYo modeli AI Agent'ınızın içinde.
Codex, Claude Code, Cursor ve VS Code'un görüntü, video, ses, sohbet ve 3D modellerini araması, güncel Schema ve herkese açık fiyatları okuması ve görevleri PoYo üzerinden çalıştırması için bir kez bağlanın.
MCP, API isteklerini kendiniz yazmadan AI Agent'ınızın PoYo modellerini kullanmasını sağlayan güvenli bir bağlantıdır.
npx -y @poyoapi/mcpVS Code veya yalnızca stdio istemcileri için yerel stdio köprüsü. Node.js 20+ gerekir; aşağıdaki yönlendirmeli kurulumu kullanın.
Yapılandırma
Üç adımda bağlanın. Kategorileri veya modelleri sınırlamanız gerektiğinde gelişmiş yapılandırmayı açın.
API Key hazırlayın
Önce bir PoYo API Key oluşturun. İstemci bağlanırken bunu kullanır.
Gerçek bir API Key'i paylaşılan yapılandırma dosyasına veya URL'ye yapıştırmayın.
İstemciyi seçin ve yapılandırmayı bulun
Yalnızca ilgili yapılandırma konumunu görmek için kullandığınız uygulamayı seçin.
Önerilen giriş
Codex Settings içinde MCP servers bölümünü açın, Add server ve Streamable HTTP seçin.
Resmî istemci talimatlarını görüntüleManuel yapılandırma dosyası
~/.codex/config.tomlGeçerli olduğu alan
Geçerli kullanıcının tüm projeleri
İstemcide MCP yapılandırmasını açın. Görsel bir giriş yoksa yukarıdaki dosyayı açın veya oluşturun.
./ ile başlayan yollar açık projenin içindedir. Gerekiyorsa klasörü veya dosyayı oluşturun.
Yapılandırmayı ekleyin ve doğrulayın
Seçilen istemcinin yapılandırmasını kopyalayın, MCP'yi yeniden yükleyin ve ücretsiz doğrulamayı tamamlayın.
Mevcut yapılandırmayı birleştirin, üzerine yazmayın
Dosyada başka MCP Server kayıtları varsa yalnızca poyo girdisini birleştirin ve mevcut içeriğin tamamını koruyun.
Aşağıdaki yapılandırmayı şuraya ekleyin ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45İstemciyi başlatmadan önce API Key'inizi POYO_API_KEY ortam değişkenine kaydedin. Kaydettikten sonra MCP yapılandırmasını yeniden yüklemesi için yeni bir Codex oturumu başlatın.
POYO_API_KEY nasıl ayarlanır?
Sisteminize uygun komutu kopyalayın, your_api_key yerine gerçek Key'i yazın ve istemciyi aynı terminal oturumundan başlatın.
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"Bu komutlar yalnızca geçerli terminal oturumunda etkilidir. Gerçek Key'i proje dosyalarına, ekran görüntülerine veya açık komut günlüklerine koymayın.
Yapılandırmada Agent yardımı al
Mevcut ayarları koruyan, gerçek Key'i dosyalardan uzak tutan ve yazmadan önce diff gösteren güvenli bir Prompt kopyalayın.
Bağlantıyı doğrulayın
Bu durumları sırayla kontrol edin. Hiçbiri ücretli bir model görevi başlatmaz.
- 1PoYo araçları istemcide görünür: yapılandırma yüklenmiştir.
- 2poyo_account hesap bilgilerini döndürür: API Key çalışır.
- 3poyo_search_models modelleri döndürür: kataloğa erişilebilir.
Bağlantı çalışmıyor mu?
- Araç yok: yapılandırma konumunu doğrulayın ve MCP Server'ı yeniden yükleyin.
- Hesap kontrolü başarısız: POYO_API_KEY'i doğrulayın ve istemciyi aynı ortamdan yeniden başlatın.
- Bağlantı başarısız: https://api.poyo.ai/mcp adresini ve ağ ya da proxy HTTPS erişimini doğrulayın.
Araçlar, hesap ve katalog kontrolleri geçtiğinde PoYo MCP bağlanmıştır.
Varsayılan olarak 8 kompakt araç kullanılabilir
Önceden model seçmek gerekmez. Agent kataloğu arar, ardından Schema ve fiyatları okur.
poyo_search_modelspoyo_get_model_schemapoyo_get_pricingpoyo_chatpoyo_run_modelpoyo_submit_jobpoyo_check_jobpoyo_account
Endpoint
https://api.poyo.ai/mcp[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Yapılandırmalar bir ortam değişkeni veya güvenli giriş kullanır. API Key hiçbir zaman URL'de görünmez.
Bir Agent PoYo MCP ile neler yapabilir?
Görevi doğal dille açıklayın. Agent uygun modeli arar, girişlerini ve fiyatını okur, çalıştırır ve uzun görev tamamlandığında sonucu döndürür.
Modelleri keşfet
Doğal dilde bir görevden güncel görüntü, video, ses, sohbet veya 3D modellerini ara
poyo_search_modelsGirişleri oku
Güncel giriş Schema'sını, örnekleri, protokolleri ve yetenekleri oku
poyo_get_model_schemaFiyatı kontrol et
Ücretli bir istek çalıştırmadan önce güncel herkese açık fiyatı oku
poyo_get_pricingKısa görevleri çalıştır
Kısa bir beklemenin ardından dönebilen sohbet veya üretim görevlerini tamamla
poyo_chatpoyo_run_modelUzun görevleri sürdür
Uzun süreli bir görev gönder, task_id değerini koru ve durum ile çıktıları daha sonra oku
poyo_submit_jobpoyo_check_jobHesabı oku
Modeli çalıştırmadan önce güncel hesap ve kredi bilgilerini oku
poyo_accountMCP, CLI veya REST API ne zaman kullanılmalı?
Agent'ın model seçip çağırması için MCP, terminal veya CI otomasyonu için PoYo CLI, uygulama trafiği veya token bazında çıktı için REST API kullanın.
AI asistanı veya kodlama Agent'ı
Seçim
MCP
Streamable HTTPNeden uygun
Agent'ın bir düzenleyici veya konuşma içinde modelleri keşfetmesini, Schema ve fiyatları okumasını ve araç çağırmasını sağlar.
Terminal betikleri veya CI
Seçim
PoYo CLI
@poyoapi/cliNeden uygun
Shell üzerinden modelleri keşfedin, üretim çalıştırın, görevleri bekleyin ve JSON, JSONL veya CSV çıktısı alın.
Uygulamanızın backend'i
Seçim
REST API
HTTP + JSON / SSENeden uygun
Uygulama trafiğini, token akışını, yoklamayı, Webhook'ları ve toplu görevleri yönetin.
Sık sorulan sorular
MCP bağlantıları, API Key, araç kapsamı, faturalandırma ve uzun görevleri sürdürme hakkında bilgi edinin.
Bir API Key oluşturun, MCP belgelerini izleyerek PoYo'yu istemcinize ekleyin ve ardından hesabınızı, model Schema'sını ve herkese açık fiyatları kontrol edin.