L’API GPT Image 2.5 è disponibile. Crea e modifica immagini →
PoYoPoYo

PoYo MCP Server

Ogni modello PoYo, nel tuo AI Agent.

Collegati una sola volta affinché Codex, Claude Code, Cursor e VS Code possano cercare modelli di immagini, video, audio, chat e 3D, consultare Schema e prezzi pubblici aggiornati ed eseguire attività tramite PoYo.

MCP è una connessione sicura che consente al tuo AI Agent di usare i modelli PoYo senza dover scrivere richieste API.

npx -y @poyoapi/mcp

Bridge stdio locale per VS Code o client solo stdio. Richiede Node.js 20+; usa la configurazione guidata qui sotto.

Crea API KeyVedi configurazioneLeggi la documentazione MCP

Configurazione

Connettiti in tre passaggi. Apri la configurazione avanzata solo per limitare categorie o modelli.

1

Prepara l’API Key

Crea prima una PoYo API Key. Il client la userà durante la connessione.

Non inserire una vera API Key in un file di configurazione condiviso o in un URL.

Crea API Key
2

Scegli un client e trova la configurazione

Seleziona l’app che usi per vedere un solo percorso pertinente.

Accesso consigliato

Apri le impostazioni di Codex, scegli MCP servers, quindi Add server e Streamable HTTP.

Vedi le istruzioni ufficiali del client

File di configurazione manuale

~/.codex/config.toml

Si applica a

Tutti i progetti dell’utente corrente

Apri la configurazione MCP nel client. Se non esiste un accesso visivo, apri o crea il file indicato sopra.

I percorsi che iniziano con ./ sono nella cartella del progetto aperto. Crea la cartella o il file se necessario.

3

Aggiungi la configurazione e verifica

Copia la configurazione del client selezionato, ricarica MCP e completa una verifica gratuita.

Unisci la configurazione esistente, non sovrascriverla

Se il file contiene già altri MCP Server, unisci solo la voce poyo e conserva tutto il contenuto esistente.

Aggiungi la configurazione seguente a ~/.codex/config.toml

[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45

Salva l’API Key nella variabile d’ambiente POYO_API_KEY prima di avviare il client. Dopo il salvataggio, avvia una nuova sessione Codex per ricaricare la configurazione MCP.

Come imposto POYO_API_KEY?

Copia il comando per il tuo sistema, sostituisci your_api_key con la Key reale e avvia il client dalla stessa sessione del terminale.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Questi comandi valgono solo per la sessione del terminale corrente. Non inserire la Key reale in file di progetto, screenshot o log pubblici.

Leggi la documentazione MCP
Fai aiutare l’Agent con la configurazione

Copia un Prompt con limiti di sicurezza che conserva le impostazioni, tiene la vera Key fuori dai file e mostra il diff prima di scrivere.

Verifica la connessione

Controlla questi stati in ordine. Nessuno avvia un’attività a pagamento.

  1. 1Gli strumenti PoYo compaiono nel client: la configurazione è stata caricata.
  2. 2poyo_account restituisce l’account: l’API Key funziona.
  3. 3poyo_search_models restituisce modelli: il catalogo è accessibile.
La connessione non funziona?
  • Nessuno strumento: verifica il percorso del file e ricarica il MCP Server.
  • Controllo account non riuscito: verifica POYO_API_KEY e riavvia il client dallo stesso ambiente.
  • Connessione non riuscita: verifica https://api.poyo.ai/mcp e che rete o proxy consentano HTTPS.

Quando strumenti, account e catalogo superano il controllo, PoYo MCP è connesso.

Cosa può fare un Agent con PoYo MCP?

Descrivi un'attività in linguaggio naturale. L'Agent cerca un modello adatto, ne legge input e prezzo, lo esegue e restituisce il risultato al termine di un processo lungo.

Scopri modelli

Cerca i modelli correnti di immagini, video, audio, chat o 3D a partire da un'attività in linguaggio naturale

poyo_search_models
Modelli candidati

Leggi gli input

Leggi Schema di input, esempi, protocolli e funzionalità correnti

poyo_get_model_schema
Input validi

Controlla i prezzi

Leggi il prezzo pubblico corrente prima di eseguire una richiesta a pagamento

poyo_get_pricing
Conferma del prezzo

Esegui attività brevi

Completa attività di chat o generazione che possono restituire il risultato dopo una breve attesa

poyo_chatpoyo_run_model
Risultato completo

Continua processi lunghi

Invia un'attività lunga, conserva il relativo task_id e leggi stato e output in seguito

poyo_submit_jobpoyo_check_job
Stato e output

Leggi l'account

Leggi le informazioni correnti su account e crediti prima di eseguire un modello

poyo_account
Stato dell'account

Quando usare MCP, CLI o REST API?

Usa MCP quando un Agent deve scegliere e chiamare modelli, PoYo CLI per l'automazione da terminale o CI e REST API per il traffico applicativo o l'output token per token.

01

Assistente AI o Agent di programmazione

Scegli

MCP

Streamable HTTP

Perché è adatto

Consente a un Agent di scoprire modelli, leggere Schema e prezzi e chiamare strumenti in un editor o una conversazione.

Tu controlli

Ambito degli strumenti e permessi del client

Leggi la documentazione
02

Script da terminale o CI

Scegli

PoYo CLI

@poyoapi/cli

Perché è adatto

Scopri modelli, esegui generazioni, attendi i processi e produci JSON, JSONL o CSV dalla shell.

Tu controlli

Flag dei comandi, file di input e formato di output

Leggi la documentazione
03

Backend della tua applicazione

Scegli

REST API

HTTP + JSON / SSE

Perché è adatto

Gestisci traffico applicativo, streaming dei token, polling, Webhook e processi batch.

Tu controlli

Ciclo di vita della richiesta ed esperienza del prodotto

Leggi la documentazione

Domande frequenti

Scopri connessioni MCP, API Key, ambito degli strumenti, fatturazione e ripristino dei processi lunghi.

Crea una API Key, segui la documentazione MCP per aggiungere PoYo al client, quindi controlla account, Schema del modello e prezzi pubblici.

Crea API KeyLeggi la documentazione MCP