PoYo MCP Server
Jedes PoYo-Modell, direkt in Ihrem AI Agent.
Einmal verbinden, damit Codex, Claude Code, Cursor und VS Code Bild-, Video-, Audio-, Chat- und 3D-Modelle suchen, aktuelle Schema und öffentliche Preise prüfen und Aufgaben über PoYo ausführen können.
MCP ist eine sichere Verbindung, über die Ihr AI Agent PoYo-Modelle nutzen kann, ohne dass Sie API-Anfragen selbst schreiben müssen.
npx -y @poyoapi/mcpLokale stdio-Bridge für VS Code oder reine stdio-Clients. Erfordert Node.js 20+; die geführte Einrichtung finden Sie unten.
Konfiguration
Stellen Sie die Verbindung in drei Schritten her. Öffnen Sie die erweiterte Konfiguration nur, wenn Sie Kategorien oder Modelle begrenzen möchten.
API Key vorbereiten
Erstellen Sie zuerst einen PoYo API Key. Der Client benötigt ihn beim Verbinden.
Fügen Sie einen echten API Key nicht in eine freigegebene Konfigurationsdatei oder URL ein.
Client auswählen und Konfiguration finden
Wählen Sie Ihre Anwendung, um nur den passenden Konfigurationsort zu sehen.
Empfohlener Einstieg
Öffnen Sie in Codex die Einstellungen, wählen Sie MCP servers, dann Add server und Streamable HTTP.
Offizielle Client-Anleitung ansehenManuelle Konfigurationsdatei
~/.codex/config.tomlGilt für
Alle Projekte des aktuellen Benutzers
Öffnen Sie die MCP-Konfiguration im Client. Gibt es keinen visuellen Einstieg, öffnen oder erstellen Sie die Datei oben.
Pfade mit ./ liegen im aktuell geöffneten Projektordner. Erstellen Sie Ordner oder Datei bei Bedarf.
Konfiguration hinzufügen und prüfen
Kopieren Sie die Konfiguration für den gewählten Client, laden Sie MCP neu und führen Sie eine kostenlose Prüfung aus.
Bestehende Konfiguration zusammenführen, nicht überschreiben
Enthält die Datei bereits andere MCP Server, fügen Sie nur den poyo-Servereintrag zusammen und behalten Sie alle vorhandenen Inhalte. Überschreiben kann andere Verbindungen deaktivieren.
Fügen Sie die folgende Konfiguration hinzu zu ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Speichern Sie den API Key vor dem Start des Clients als Umgebungsvariable POYO_API_KEY. Starten Sie nach dem Speichern eine neue Codex-Sitzung, damit die MCP-Konfiguration neu geladen wird.
Wie wird POYO_API_KEY gesetzt?
Kopieren Sie den Befehl für Ihr System, ersetzen Sie your_api_key durch den echten Key und starten Sie den Client aus derselben Terminalsitzung.
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"Diese Befehle gelten nur für die aktuelle Terminalsitzung. Speichern Sie den echten Key nicht in Projektdateien, Screenshots oder öffentlichen Befehlsprotokollen.
Konfiguration vom Agent unterstützen lassen
Kopieren Sie einen sicher begrenzten Prompt, der vorhandene Einstellungen erhält, den echten Key aus Dateien fernhält und Änderungen vor dem Schreiben zeigt.
Verbindung prüfen
Prüfen Sie diese Zustände der Reihe nach. Dabei wird kein kostenpflichtiger Modellauftrag gestartet.
- 1PoYo-Tools erscheinen im Client: Die Konfiguration wurde geladen.
- 2poyo_account gibt Kontodaten zurück: Der API Key funktioniert.
- 3poyo_search_models gibt Modelle zurück: Der Katalog ist erreichbar.
Verbindung funktioniert nicht?
- Keine Tools: Prüfen Sie den Konfigurationsort und laden Sie den MCP Server neu.
- Kontoprüfung fehlgeschlagen: Prüfen Sie POYO_API_KEY und starten Sie den Client aus derselben Umgebung neu.
- Verbindung fehlgeschlagen: Prüfen Sie https://api.poyo.ai/mcp und ob Netzwerk oder Proxy HTTPS-Zugriff erlauben.
Wenn Tools, Konto und Katalog erfolgreich geprüft wurden, ist PoYo MCP verbunden.
Standardmäßig stehen 8 kompakte Tools bereit
Es müssen nicht zuerst Modelle gewählt werden. Der Agent durchsucht den Katalog und liest anschließend Schema und Preise.
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 = 45Konfigurationen verwenden eine Umgebungsvariable oder sichere Eingabe. Der API Key erscheint nie in der URL.
Was kann ein Agent mit PoYo MCP tun?
Beschreiben Sie eine Aufgabe in natürlicher Sprache. Der Agent sucht ein passendes Modell, liest Eingaben und Preis, führt es aus und liefert nach Abschluss einer langen Aufgabe das Ergebnis.
Modelle finden
Aktuelle Bild-, Video-, Audio-, Chat- oder 3D-Modelle anhand einer Aufgabe in natürlicher Sprache suchen
poyo_search_modelsEingaben lesen
Aktuelle Eingabe-Schema, Beispiele, Protokolle und Fähigkeiten lesen
poyo_get_model_schemaPreise prüfen
Vor einer kostenpflichtigen Anfrage den aktuellen öffentlichen Preis lesen
poyo_get_pricingKurze Aufgaben ausführen
Chat- oder Generierungsaufgaben abschließen, die nach kurzer Wartezeit antworten
poyo_chatpoyo_run_modelLange Aufgaben fortsetzen
Eine lange Aufgabe senden, task_id behalten und Status sowie Ausgaben später lesen
poyo_submit_jobpoyo_check_jobKonto lesen
Vor der Ausführung aktuelle Konto- und Guthabeninformationen lesen
poyo_accountWann sollten Sie MCP, CLI oder REST API verwenden?
Nutzen Sie MCP, wenn ein Agent Modelle auswählen und aufrufen soll, PoYo CLI für Terminal- oder CI-Automatisierung und REST API für Anwendungsverkehr oder tokenweise Ausgabe.
AI-Assistent oder Coding-Agent
Auswahl
MCP
Streamable HTTPWarum es passt
Ein Agent kann in Editor oder Gespräch Modelle finden, Schema und Preise lesen und Tools aufrufen.
Terminal-Skripte oder CI
Auswahl
PoYo CLI
@poyoapi/cliWarum es passt
Modelle finden, Generierung ausführen, auf Aufgaben warten und JSON, JSONL oder CSV aus der Shell ausgeben.
Backend Ihrer Anwendung
Auswahl
REST API
HTTP + JSON / SSEWarum es passt
Anwendungsverkehr, Token-Streaming, Polling, Webhooks und Batch-Aufgaben verarbeiten.
Häufige Fragen
Informationen zu MCP-Verbindungen, API Key, Tool-Umfang, Abrechnung und Fortsetzung langer Aufgaben.
Erstellen Sie einen API Key, fügen Sie PoYo anhand der MCP-Dokumentation zum Client hinzu und prüfen Sie anschließend Konto, Modell-Schema und öffentlichen Preis.