PoYo MCP-server
Elk PoYo-model, in je AI-agent.
Verbind één keer, en Codex, Claude Code, Cursor en VS Code kunnen modellen voor beeld, video, audio, chat en 3D zoeken, actuele schema's en openbare prijzen bekijken en taken uitvoeren via PoYo.
MCP is een beveiligde verbinding waarmee je AI-assistent PoYo-modellen kan gebruiken, zonder dat je zelf API-verzoeken hoeft te schrijven.
npx -y @poyoapi/mcpLokale stdio-bridge voor VS Code of clients die alleen stdio ondersteunen. Vereist Node.js 20+; gebruik de installatie hieronder voor een begeleide verbinding.
Configuratie
Verbind in drie stappen. Open de geavanceerde configuratie alleen als je toolcategorieën of modellen wilt beperken.
Houd je API-sleutel bij de hand
Maak eerst een PoYo API-sleutel aan. Die heb je nodig zodra de client verbinding maakt.
Plak een echte API-sleutel nooit in een gedeeld configuratiebestand of in een URL.
Kies een client en zoek de bijbehorende configuratie
Selecteer de app die je gebruikt om de relevante configuratielocatie te zien.
Aanbevolen ingang
Open de Codex-instellingen, kies MCP-servers, kies vervolgens Server toevoegen en selecteer Streamable HTTP.
Officiële clientinstructies bekijkenHandmatig configuratiebestand
~/.codex/config.tomlGeldt voor
Alle projecten van de huidige gebruiker
Open de MCP-configuratie in de client. Is er geen visuele ingang, open of maak dan het bestand hierboven aan.
Paden die met ./ beginnen, liggen in de map van het project dat nu geopend is. Maak de map of het bestand aan als dat nodig is.
Configuratie toevoegen en controleren
Kopieer de configuratie voor de gekozen client, laad MCP opnieuw en voer een gratis controle uit.
Voeg de bestaande configuratie samen, overschrijf haar niet
Bevat het bestand al andere MCP-servers, voeg dan alleen de poyo-serverregel toe en laat alle bestaande inhoud staan. Door te overschrijven kunnen andere verbindingen uitvallen.
Voeg de onderstaande configuratie toe aan ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Sla je API-sleutel op als omgevingsvariabele POYO_API_KEY voordat je de client start. Start na het opslaan een nieuwe Codex-sessie, zodat de MCP-configuratie opnieuw wordt geladen.
Hoe stel ik POYO_API_KEY in?
Kopieer de opdracht voor je systeem, vervang your_api_key door de echte sleutel en start de client vanuit dezelfde terminalsessie.
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"Deze opdrachten gelden alleen voor de huidige terminalsessie. Zet een echte sleutel nooit in projectbestanden, screenshots of openbare opdrachtlogboeken.
Laat je agent helpen met de configuratie
Kopieer een veilige prompt waarin de agent wordt gevraagd bestaande instellingen te behouden, de echte sleutel buiten bestanden te houden en de wijzigingen te tonen voordat hij schrijft.
Controleer de verbinding
Loop deze punten op volgorde na. Geen ervan start een betaalde modeltaak.
- 1De PoYo-tools verschijnen in de client, dus de configuratie is geladen.
- 2poyo_account geeft accountgegevens terug, dus de API-sleutel werkt.
- 3poyo_search_models geeft modellen terug, dus de catalogus is bereikbaar.
Werkt de verbinding niet?
- Geen tools: controleer de locatie van de configuratie en laad de MCP-server opnieuw.
- Accountcontrole mislukt: controleer of POYO_API_KEY is ingesteld en start de client opnieuw vanuit dezelfde omgeving.
- Verbinding mislukt: controleer of het endpoint https://api.poyo.ai/mcp is en of je netwerk of proxy HTTPS-verkeer toestaat.
Als de controles van tools, account en catalogus allemaal slagen, is PoYo MCP verbonden.
Standaard zijn 8 compacte tools beschikbaar
Je hoeft eerst geen modellen te kiezen. De agent doorzoekt de catalogus en leest daarna schema's en prijzen.
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 = 45Configuraties gebruiken een omgevingsvariabele of een beveiligd invoerveld. De API-sleutel komt nooit in de URL terecht.
Wat kan een agent met PoYo MCP?
Beschrijf een taak in gewone taal. De agent zoekt een passend model, leest de invoer en de prijs, voert het uit en geeft het resultaat terug zodra een lange job klaar is.
Modellen ontdekken
Zoek actuele modellen voor beeld, video, audio, chat of 3D vanuit een taak in gewone taal
poyo_search_modelsInvoer lezen
Lees het actuele invoerschema, de voorbeelden, protocollen en mogelijkheden
poyo_get_model_schemaPrijzen controleren
Lees de actuele openbare prijs voordat je een betaald verzoek uitvoert
poyo_get_pricingKorte taken uitvoeren
Voltooi chat- of generatietaken die na een korte wachttijd een antwoord kunnen geven
poyo_chatpoyo_run_modelLange jobs voortzetten
Dien een langlopende taak in, bewaar de task_id en lees de status en uitvoer later uit
poyo_submit_jobpoyo_check_jobAccount lezen
Lees de actuele account- en creditgegevens voordat je een model uitvoert
poyo_accountWanneer gebruik je MCP, de CLI of de REST API?
Gebruik MCP wanneer een agent zelf modellen moet kiezen en aanroepen, de PoYo CLI voor automatisering in de terminal of CI, en de REST API voor applicatieverkeer of uitvoer per token.
AI-assistent of coderingsagent
Kies
MCP
Streamable HTTPWaarom het past
Laat een agent modellen ontdekken, schema's en prijzen lezen en tools aanroepen in een editor of gesprek.
Terminalscripts of CI
Kies
PoYo CLI
@poyoapi/cliWaarom het past
Ontdek modellen, voer generaties uit, wacht op jobs en geef JSON, JSONL of CSV uit vanuit een shell.
De backend van je applicatie
Kies
REST API
HTTP + JSON / SSEWaarom het past
Verwerk applicatieverkeer, tokenstreaming, polling, webhooks en batchjobs.
Veelgestelde vragen
Alles over MCP-verbindingen, API-sleutels, toolbereik, facturering en het hervatten van lange jobs.
Maak een API-sleutel aan, volg de MCP-documentatie om PoYo aan je client toe te voegen en controleer daarna je account, het modelschema en de openbare prijzen.