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/mcp

VS 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.

1

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.

API Key oluştur
2

İ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üle

Manuel yapılandırma dosyası

~/.codex/config.toml

Geç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.

3

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.

MCP belgelerini oku
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.

  1. 1PoYo araçları istemcide görünür: yapılandırma yüklenmiştir.
  2. 2poyo_account hesap bilgilerini döndürür: API Key çalışır.
  3. 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.

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_models
Aday modeller

Girişleri oku

Güncel giriş Schema'sını, örnekleri, protokolleri ve yetenekleri oku

poyo_get_model_schema
Geçerli girişler

Fiyatı kontrol et

Ücretli bir istek çalıştırmadan önce güncel herkese açık fiyatı oku

poyo_get_pricing
Fiyat onayı

Kısa görevleri çalıştır

Kısa bir beklemenin ardından dönebilen sohbet veya üretim görevlerini tamamla

poyo_chatpoyo_run_model
Tam sonuç

Uzun 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_job
Durum ve çıktı

Hesabı oku

Modeli çalıştırmadan önce güncel hesap ve kredi bilgilerini oku

poyo_account
Hesap durumu

MCP, 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.

01

AI asistanı veya kodlama Agent'ı

Seçim

MCP

Streamable HTTP

Neden 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.

Kontrol ettikleriniz

Araç kapsamı ve istemci izinleri

Belgeleri oku
02

Terminal betikleri veya CI

Seçim

PoYo CLI

@poyoapi/cli

Neden uygun

Shell üzerinden modelleri keşfedin, üretim çalıştırın, görevleri bekleyin ve JSON, JSONL veya CSV çıktısı alın.

Kontrol ettikleriniz

Komut bayrakları, giriş dosyaları ve çıktı biçimi

Belgeleri oku
03

Uygulamanızın backend'i

Seçim

REST API

HTTP + JSON / SSE

Neden uygun

Uygulama trafiğini, token akışını, yoklamayı, Webhook'ları ve toplu görevleri yönetin.

Kontrol ettikleriniz

İstek yaşam döngüsü ve ürün deneyimi

Belgeleri oku

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.