PoYo MCP-server

Alle PoYo-modeller, direkte i din AI-agent.

Opret forbindelse én gang, så Codex, Claude Code, Cursor og VS Code kan søge i billed-, video-, lyd-, chat- og 3D-modeller, se aktuelle skemaer og offentlige priser og køre opgaver via PoYo.

MCP er en sikker forbindelse, der lader din AI-assistent bruge PoYo-modeller, uden at du selv skal skrive API-anmodninger.

npx -y @poyoapi/mcp

Lokal stdio-bro til VS Code eller klienter, der kun understøtter stdio. Kræver Node.js 20+. Brug opsætningen nedenfor for en guidet forbindelse.

Konfiguration

Opret forbindelse i tre trin. Åbn den avancerede konfiguration, kun hvis du skal begrænse værktøjskategorier eller modeller.

1

Gør din API-nøgle klar

Opret først en PoYo API-nøgle. Du skal bruge den, når klienten opretter forbindelse.

Indsæt aldrig en rigtig API-nøgle i en delt konfigurationsfil eller URL.

Opret API-nøgle
2

Vælg en klient, og find dens konfiguration

Vælg den app, du bruger, for at se den relevante konfigurationsplacering.

Anbefalet indgangspunkt

Åbn Codex Settings, vælg MCP servers, vælg derefter Add server, og vælg Streamable HTTP.

Se klientens officielle vejledning

Manuel konfigurationsfil

~/.codex/config.toml

Gælder for

Alle projekter for den aktuelle bruger

Åbn MCP-konfigurationen i klienten. Hvis der ikke er noget visuelt indgangspunkt, skal du åbne eller oprette filen ovenfor.

Stier, der begynder med ./, ligger i den projektmappe, der er åben lige nu. Opret mappen eller filen, hvis det er nødvendigt.

3

Tilføj konfigurationen, og kontrollér

Kopiér konfigurationen til den valgte klient, genindlæs MCP, og gennemfør en gratis kontrol.

Flet med den eksisterende konfiguration, og overskriv den ikke

Hvis filen allerede indeholder andre MCP-servere, skal du kun flette poyo-serverindførslen ind og bevare alt eksisterende indhold. Overskrivning kan deaktivere andre forbindelser.

Tilføj konfigurationen nedenfor til ~/.codex/config.toml

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

Gem din API-nøgle som miljøvariablen POYO_API_KEY, før du starter klienten. Start en ny Codex-session, når du har gemt, så MCP-konfigurationen genindlæses.

Hvordan indstiller jeg POYO_API_KEY?

Kopiér kommandoen til dit system, erstat your_api_key med den rigtige nøgle, og start klienten fra den samme terminalsession.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Disse kommandoer gælder kun for den aktuelle terminalsession. Læg aldrig en rigtig nøgle i projektfiler, skærmbilleder eller offentlige kommandologge.

Læs MCP-dokumentationen
Lad din agent hjælpe med konfigurationen

Kopiér en sikkerhedsafgrænset prompt, der beder agenten om at bevare eksisterende indstillinger, holde den rigtige nøgle ude af filer og vise ændringerne, før der skrives.

Kontrollér forbindelsen

Kontrollér disse tilstande i rækkefølge. Ingen af dem starter en betalt modelopgave.

  1. 1PoYo-værktøjer vises i klienten, hvilket bekræfter, at konfigurationen er indlæst.
  2. 2poyo_account returnerer kontooplysninger, hvilket bekræfter, at API-nøglen virker.
  3. 3poyo_search_models returnerer modeller, hvilket bekræfter adgangen til kataloget.
Virker forbindelsen ikke?
  • Ingen værktøjer: Kontrollér konfigurationens placering, og genindlæs derefter MCP-serveren.
  • Kontokontrollen mislykkedes: Kontrollér, at POYO_API_KEY er indstillet, og genstart derefter klienten fra det samme miljø.
  • Forbindelsen mislykkedes: Kontrollér, at endpointet er https://api.poyo.ai/mcp, og at dit netværk eller din proxy tillader HTTPS-adgang.

Når kontrollerne af værktøjer, konto og katalog alle er bestået, er PoYo MCP forbundet.

Hvad kan en agent gøre med PoYo MCP?

Beskriv en opgave med naturligt sprog. Agenten søger efter en passende model, læser dens input og pris, kører den og returnerer resultatet, når et langvarigt job er færdigt.

Find modeller

Søg i aktuelle billed-, video-, lyd-, chat- eller 3D-modeller ud fra en opgave i naturligt sprog

poyo_search_models
Kandidatmodeller

Læs input

Læs det aktuelle inputskema, eksempler, protokoller og funktioner

poyo_get_model_schema
Gyldige input

Tjek priser

Læs den aktuelle offentlige pris, før du kører en betalt anmodning

poyo_get_pricing
Prisbekræftelse

Kør korte opgaver

Gennemfør chat- eller genereringsopgaver, der kan returnere efter en kort ventetid

poyo_chatpoyo_run_model
Fuldt resultat

Fortsæt lange jobs

Send en langvarig opgave, behold dens task_id, og læs status og output senere

poyo_submit_jobpoyo_check_job
Status og output

Læs konto

Læs aktuelle konto- og kreditoplysninger, før en model køres

poyo_account
Kontostatus

Hvornår skal du bruge MCP, CLI eller REST-API'en?

Brug MCP, når en agent selv skal vælge og kalde modeller, PoYo CLI til automatisering i terminalen eller CI, og REST-API'en til applikationstrafik eller token-for-token-output.

01

AI-assistent eller kodeagent

Vælg

MCP

Streamable HTTP

Hvorfor det passer

Lad en agent finde modeller, læse skemaer og priser og kalde værktøjer i en editor eller samtale.

Du styrer

Værktøjsomfang og klientens tilladelser

Læs dokumentationen
02

Terminalscripts eller CI

Vælg

PoYo CLI

@poyoapi/cli

Hvorfor det passer

Find modeller, kør generering, vent på jobs, og udlæs JSON, JSONL eller CSV fra en shell.

Du styrer

Kommandoflag, inputfiler og outputformat

Læs dokumentationen
03

Din applikations backend

Vælg

REST API

HTTP + JSON / SSE

Hvorfor det passer

Håndtér applikationstrafik, token-streaming, polling, webhooks og batchjobs.

Du styrer

Anmodningens livscyklus og produktoplevelsen

Læs dokumentationen

Ofte stillede spørgsmål

Få svar om MCP-forbindelser, API-nøgler, værktøjsomfang, fakturering og genoptagelse af lange jobs.

Opret en API-nøgle, følg MCP-dokumentationen for at tilføje PoYo til din klient, og tjek derefter din konto, modelskemaet og de offentlige priser.