A API GPT Image 2.5 já está disponível. Crie e edite imagens →
PoYoPoYo

PoYo MCP Server

Todos os modelos da PoYo, dentro do seu Agent de IA.

Conecte-se uma vez para que Codex, Claude Code, Cursor e VS Code pesquisem modelos de imagem, vídeo, áudio, chat e 3D, consultem Schema e preços públicos atualizados e executem tarefas pela PoYo.

MCP é uma conexão segura que permite ao seu Agent de IA usar modelos da PoYo sem você precisar escrever requisições de API.

npx -y @poyoapi/mcp

Bridge stdio local para VS Code ou clientes somente stdio. Requer Node.js 20+; use a configuração guiada abaixo.

Criar uma API KeyVer configuraçãoLer documentação do MCP

Configuração

Conecte em três etapas. Abra a configuração avançada apenas quando precisar limitar categorias ou modelos.

1

Prepare sua API Key

Primeiro crie uma PoYo API Key. O cliente vai usá-la ao conectar.

Não cole uma API Key real em um arquivo de configuração compartilhado ou em uma URL.

Criar uma API Key
2

Escolha um cliente e encontre a configuração

Selecione o aplicativo que você usa para ver apenas um local relevante.

Entrada recomendada

Abra as configurações do Codex, escolha MCP servers, depois Add server e Streamable HTTP.

Ver instruções oficiais do cliente

Arquivo de configuração manual

~/.codex/config.toml

Aplica-se a

Todos os projetos do usuário atual

Abra a configuração MCP no cliente. Se não houver uma entrada visual, abra ou crie o arquivo acima.

Caminhos iniciados por ./ ficam dentro do projeto aberto. Crie a pasta ou o arquivo se necessário.

3

Adicione a configuração e verifique

Copie a configuração do cliente selecionado, recarregue o MCP e conclua uma verificação gratuita.

Mescle a configuração existente; não a substitua

Se o arquivo já contém outros MCP Server, mescle apenas a entrada poyo e preserve todo o conteúdo existente.

Adicione a configuração abaixo a ~/.codex/config.toml

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

Salve sua API Key na variável de ambiente POYO_API_KEY antes de iniciar o cliente. Depois de salvar, inicie uma nova sessão do Codex para recarregar a configuração MCP.

Como definir POYO_API_KEY?

Copie o comando do seu sistema, substitua your_api_key pela Key real e inicie o cliente na mesma sessão do terminal.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Esses comandos valem apenas para a sessão atual do terminal. Não coloque a Key real em arquivos do projeto, capturas ou logs públicos.

Ler documentação do MCP
Peça ajuda ao Agent com a configuração

Copie um Prompt seguro que preserve as configurações existentes, mantenha a Key real fora dos arquivos e mostre o diff antes de gravar.

Verifique a conexão

Confira estes estados em ordem. Nenhum deles inicia uma tarefa paga.

  1. 1As ferramentas PoYo aparecem no cliente: a configuração foi carregada.
  2. 2poyo_account retorna a conta: a API Key está funcionando.
  3. 3poyo_search_models retorna modelos: o catálogo está acessível.
A conexão não funciona?
  • Sem ferramentas: confirme o local do arquivo e recarregue o MCP Server.
  • Falha na conta: confirme POYO_API_KEY e reinicie o cliente no mesmo ambiente.
  • Falha na conexão: confirme https://api.poyo.ai/mcp e se a rede ou o proxy permite HTTPS.

Quando ferramentas, conta e catálogo passam na verificação, o PoYo MCP está conectado.

O que um Agent pode fazer com o PoYo MCP?

Descreva uma tarefa em linguagem natural. O Agent procura um modelo adequado, consulta entradas e preço, executa e devolve o resultado quando a tarefa longa termina.

Descobrir modelos

Pesquisar modelos atuais de imagem, vídeo, áudio, chat ou 3D a partir de uma tarefa em linguagem natural

poyo_search_models
Modelos candidatos

Consultar entradas

Consultar o Schema de entrada, exemplos, protocolos e recursos atuais

poyo_get_model_schema
Entradas válidas

Verificar preços

Consultar o preço público atual antes de executar uma solicitação paga

poyo_get_pricing
Confirmação do preço

Executar tarefas curtas

Concluir tarefas de chat ou geração que retornam após uma espera curta

poyo_chatpoyo_run_model
Resultado completo

Continuar tarefas longas

Enviar uma tarefa longa, manter seu task_id e consultar status e saídas depois

poyo_submit_jobpoyo_check_job
Status e saída

Consultar conta

Consultar dados atuais da conta e dos créditos antes de executar o modelo

poyo_account
Status da conta

Quando usar MCP, CLI ou REST API?

Use MCP quando um Agent precisar escolher e chamar modelos, PoYo CLI para automação no terminal ou CI e REST API para tráfego da aplicação ou saída token a token.

01

Assistente de IA ou Agent de programação

Escolha

MCP

Streamable HTTP

Por que se encaixa

Permitir que um Agent descubra modelos, consulte Schema e preços e chame ferramentas em um editor ou conversa.

Você controla

Escopo das ferramentas e permissões do cliente

Ler documentação
02

Scripts de terminal ou CI

Escolha

PoYo CLI

@poyoapi/cli

Por que se encaixa

Descobrir modelos, executar gerações, aguardar tarefas e emitir JSON, JSONL ou CSV pelo shell.

Você controla

Flags de comando, arquivos de entrada e formato de saída

Ler documentação
03

Backend da sua aplicação

Escolha

REST API

HTTP + JSON / SSE

Por que se encaixa

Lidar com tráfego da aplicação, streaming de tokens, polling, webhooks e tarefas em lote.

Você controla

Ciclo de vida da solicitação e experiência do produto

Ler documentação

Perguntas frequentes

Entenda conexões MCP, API Key, escopo das ferramentas, cobrança e retomada de tarefas longas.

Crie uma API Key, siga a documentação MCP para adicionar a PoYo ao seu cliente e consulte sua conta, o Schema do modelo e o preço público.

Criar uma API KeyLer documentação do MCP