PoYo MCP Server
Alle PoYo-modeller, rett i AI-agenten din.
Koble til én gang, så kan Codex, Claude Code, Cursor og VS Code søke etter bilde-, video-, lyd-, chat- og 3D-modeller, se gjeldende skjemaer og offentlige priser og kjøre oppgaver via PoYo.
MCP er en sikker tilkobling som lar AI-assistenten din bruke PoYo-modeller uten at du trenger å skrive API-forespørsler.
npx -y @poyoapi/mcpLokal stdio-bro for VS Code eller klienter som bare støtter stdio. Krever Node.js 20+; bruk oppsettet nedenfor for veiledet tilkobling.
Konfigurasjon
Koble til i tre trinn. Åpne avansert konfigurasjon bare når du trenger å begrense verktøykategorier eller modeller.
Klargjør API-nøkkelen din
Opprett først en PoYo-API-nøkkel. Du bruker den når klienten kobler til.
Ikke lim inn en ekte API-nøkkel i en delt konfigurasjonsfil eller URL.
Velg en klient og finn konfigurasjonen
Velg appen du bruker for å se den relevante konfigurasjonsplasseringen.
Anbefalt inngangspunkt
Åpne Codex Settings, velg MCP servers, deretter Add server og velg Streamable HTTP.
Se den offisielle veiledningen for klientenManuell konfigurasjonsfil
~/.codex/config.tomlGjelder for
Alle prosjekter for gjeldende bruker
Åpne MCP-konfigurasjonen i klienten. Hvis det ikke finnes et visuelt inngangspunkt, åpner eller oppretter du filen ovenfor.
Stier som begynner med ./, ligger i prosjektmappen som er åpen nå. Opprett mappen eller filen ved behov.
Legg til konfigurasjonen og verifiser
Kopier konfigurasjonen for den valgte klienten, last inn MCP på nytt og fullfør en gratis verifisering.
Slå sammen med eksisterende konfigurasjon – ikke overskriv den
Hvis filen allerede inneholder andre MCP-servere, slår du bare sammen poyo-serveroppføringen og beholder alt eksisterende innhold. Overskriving kan deaktivere andre tilkoblinger.
Legg til konfigurasjonen nedenfor i ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Lagre API-nøkkelen din som miljøvariabelen POYO_API_KEY før du starter klienten. Når du har lagret, starter du en ny Codex-økt slik at MCP-konfigurasjonen lastes inn på nytt.
Hvordan setter jeg POYO_API_KEY?
Kopier kommandoen for systemet ditt, erstatt your_api_key med den ekte nøkkelen, og start klienten fra den samme terminaløkten.
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"Disse kommandoene påvirker bare den gjeldende terminaløkten. Ikke legg en ekte nøkkel i prosjektfiler, skjermbilder eller offentlige kommandologger.
La agenten hjelpe deg med konfigurasjonen
Kopier en sikkert avgrenset prompt som ber agenten beholde eksisterende innstillinger, holde den ekte nøkkelen utenfor filer og vise diffen før den skriver.
Verifiser tilkoblingen
Kontroller disse tilstandene i rekkefølge. Ingen av dem starter en betalt modelloppgave.
- 1PoYo-verktøyene vises i klienten, noe som bekrefter at konfigurasjonen er lastet inn.
- 2poyo_account returnerer kontoinformasjon, noe som bekrefter at API-nøkkelen fungerer.
- 3poyo_search_models returnerer modeller, noe som bekrefter tilgang til katalogen.
Fungerer ikke tilkoblingen?
- Ingen verktøy: Bekreft plasseringen av konfigurasjonen, og last deretter inn MCP-serveren på nytt.
- Kontosjekken mislyktes: Bekreft at POYO_API_KEY er satt, og start deretter klienten på nytt fra det samme miljøet.
- Tilkoblingen mislyktes: Bekreft at endepunktet er https://api.poyo.ai/mcp, og at nettverket eller proxyen din tillater HTTPS-tilgang.
Når verktøy-, konto- og katalogsjekkene er bestått, er PoYo MCP tilkoblet.
8 kompakte verktøy er tilgjengelige som standard
Du trenger ikke velge modeller først. Agenten søker i katalogen og leser deretter skjemaer og priser.
poyo_search_modelspoyo_get_model_schemapoyo_get_pricingpoyo_chatpoyo_run_modelpoyo_submit_jobpoyo_check_jobpoyo_account
Endepunkt
https://api.poyo.ai/mcp[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Konfigurasjonene bruker en miljøvariabel eller sikker inndata. API-nøkkelen vises aldri i URL-en.
Hva kan en agent gjøre med PoYo MCP?
Beskriv en oppgave med naturlig språk. Agenten søker etter en passende modell, leser inndataene og prisen, kjører den og returnerer resultatet når en lang jobb er ferdig.
Finn modeller
Søk etter gjeldende bilde-, video-, lyd-, chat- eller 3D-modeller ut fra en oppgave beskrevet med naturlig språk
poyo_search_modelsLes inndata
Les gjeldende inndataskjema, eksempler, protokoller og funksjoner
poyo_get_model_schemaSjekk priser
Les gjeldende offentlige pris før en betalt forespørsel kjøres
poyo_get_pricingKjør korte oppgaver
Fullfør chat- eller genereringsoppgaver som kan returnere etter kort ventetid
poyo_chatpoyo_run_modelFortsett lange jobber
Send inn en langvarig oppgave, behold task_id-en og les status og utdata senere
poyo_submit_jobpoyo_check_jobLes konto
Les gjeldende konto- og kredittinformasjon før modellen kjøres
poyo_accountNår bør du bruke MCP, CLI eller REST-API-et?
Bruk MCP når en agent skal velge og kalle modeller, PoYo CLI for automatisering i terminal eller CI, og REST-API-et for applikasjonstrafikk eller utdata token for token.
AI-assistent eller kodeagent
Velg
MCP
Streamable HTTPHvorfor det passer
La en agent finne modeller, lese skjemaer og priser og kalle verktøy i en editor eller samtale.
Terminalskript eller CI
Velg
PoYo CLI
@poyoapi/cliHvorfor det passer
Finn modeller, kjør genereringer, vent på jobber og skriv ut JSON, JSONL eller CSV fra et skall.
Backend i applikasjonen din
Velg
REST API
HTTP + JSON / SSEHvorfor det passer
Håndter applikasjonstrafikk, tokenstrømming, statusforespørsler, webhooks og batchjobber.
Vanlige spørsmål
Les om MCP-tilkoblinger, API-nøkler, verktøyomfang, fakturering og gjenopptakelse av lange jobber.
Opprett en API-nøkkel, følg MCP-dokumentasjonen for å legge til PoYo i klienten din, og sjekk deretter kontoen, modellskjemaet og de offentlige prisene.