A API GPT Image 2.6 já está disponível. Experimenta a geração de imagens →
PoYoPoYo

Servidor MCP do PoYo

Todos os modelos do PoYo, dentro do teu agent de IA.

Liga-te uma só vez para que o Codex, o Claude Code, o Cursor e o VS Code possam pesquisar modelos de imagem, vídeo, áudio, chat e 3D, consultar os esquemas atuais e os preços públicos e executar tarefas através do PoYo.

O MCP é uma ligação segura que permite ao teu assistente de IA utilizar os modelos do PoYo sem que tenhas de escrever pedidos à API.

npx -y @poyoapi/mcp

Bridge stdio local para o VS Code ou para clientes que só suportam stdio. Requer Node.js 20+; usa a configuração abaixo para uma ligação guiada.

Criar chave de APIVer configuraçãoLer a documentação do MCP

Configuração

Liga-te em três passos. Só precisas de abrir a configuração avançada se quiseres limitar as categorias de ferramentas ou os modelos.

1

Prepara a tua chave de API

Cria primeiro uma chave de API do PoYo. Vais precisar dela quando o cliente se ligar.

Não colas uma chave de API verdadeira num ficheiro de configuração partilhado nem num URL.

Criar chave de API
2

Escolhe um cliente e encontra a respetiva configuração

Seleciona a aplicação que estás a utilizar para ver a localização de configuração relevante.

Ponto de entrada recomendado

Abre as Definições do Codex, escolhe MCP servers, depois Add server e seleciona Streamable HTTP.

Ver as instruções oficiais do cliente

Ficheiro de configuração manual

~/.codex/config.toml

Aplica-se a

Todos os projetos do utilizador atual

Abre a configuração de MCP no cliente. Se não houver um ponto de entrada visual, abre ou cria o ficheiro indicado acima.

Os caminhos que começam por ./ ficam dentro da pasta do projeto atualmente aberto. Cria a pasta ou o ficheiro, se necessário.

3

Adiciona a configuração e verifica

Copia a configuração do cliente selecionado, recarrega o MCP e conclui uma verificação gratuita.

Junta à configuração existente; não a substituas

Se o ficheiro já contiver outros servidores MCP, junta apenas a entrada do servidor poyo e preserva todo o conteúdo existente. Substituir o ficheiro pode desativar outras ligações.

Adiciona 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

Guarda a tua chave de API na variável de ambiente POYO_API_KEY antes de iniciares o cliente. Depois de guardares, inicia uma nova sessão do Codex para que volte a carregar a configuração de MCP.

Como defino a POYO_API_KEY?

Copia o comando para o teu sistema, substitui your_api_key pela chave verdadeira e inicia o cliente a partir da mesma sessão de terminal.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Estes comandos afetam apenas a sessão de terminal atual. Não coloques uma chave verdadeira em ficheiros do projeto, capturas de ecrã nem registos de comandos públicos.

Ler a documentação do MCP
Deixa o teu agent ajudar na configuração

Copia um prompt com limites de segurança que pede ao agent para preservar as definições existentes, manter a chave verdadeira fora dos ficheiros e mostrar as diferenças antes de escrever.

Verifica a ligação

Confirma estes estados por ordem. Nenhum deles inicia uma tarefa de modelo paga.

  1. 1As ferramentas do PoYo aparecem no cliente, o que confirma que a configuração foi carregada.
  2. 2O poyo_account devolve as informações da conta, o que confirma que a chave de API funciona.
  3. 3O poyo_search_models devolve modelos, o que confirma o acesso ao catálogo.
A ligação não funciona?
  • Sem ferramentas: confirma a localização da configuração e depois recarrega o servidor MCP.
  • A verificação da conta falhou: confirma que a POYO_API_KEY está definida e reinicia o cliente a partir do mesmo ambiente.
  • A ligação falhou: confirma que o endpoint é https://api.poyo.ai/mcp e que a tua rede ou proxy permite acesso HTTPS.

Quando as verificações de ferramentas, conta e catálogo passarem todas, o MCP do PoYo está ligado.

O que pode um agent fazer com o MCP do PoYo?

Descreve uma tarefa em linguagem natural. O agent procura um modelo adequado, lê as respetivas entradas e o preço, executa-o e devolve o resultado quando uma tarefa longa terminar.

Descobrir modelos

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

poyo_search_models
Modelos candidatos

Ler entradas

Lê o esquema de entrada atual, os exemplos, os protocolos e as capacidades

poyo_get_model_schema
Entradas válidas

Verificar preços

Lê o preço público atual antes de executar um pedido pago

poyo_get_pricing
Confirmação do preço

Executar tarefas curtas

Conclui tarefas de chat ou de geração que podem devolver o resultado após uma curta espera

poyo_chatpoyo_run_model
Resultado completo

Retomar tarefas longas

Submete uma tarefa de longa duração, guarda o respetivo task_id e lê mais tarde o estado e os resultados

poyo_submit_jobpoyo_check_job
Estado e resultado

Ler a conta

Lê as informações atuais da conta e dos créditos antes de executar um modelo

poyo_account
Estado da conta

Quando deves utilizar o MCP, a CLI ou a API REST?

Usa o MCP quando um agent deve escolher e chamar modelos, a CLI do PoYo para automação em terminal ou CI e a API REST para o tráfego da tua aplicação ou para saída token a token.

01

Assistente de IA ou agent de programação

Escolhe

MCP

Streamable HTTP

Porque se adequa

Permite a um agent descobrir modelos, ler esquemas e preços e chamar ferramentas dentro de um editor ou de uma conversa.

Tu controlas

Âmbito das ferramentas e permissões do cliente

Ler a documentação
02

Scripts de terminal ou CI

Escolhe

CLI do PoYo

@poyoapi/cli

Porque se adequa

Descobre modelos, executa gerações, aguarda tarefas e devolve JSON, JSONL ou CSV a partir de uma shell.

Tu controlas

Opções de comando, ficheiros de entrada e formato de saída

Ler a documentação
03

O backend da tua aplicação

Escolhe

API REST

HTTP + JSON / SSE

Porque se adequa

Trata o tráfego da aplicação, o streaming de tokens, o polling, os webhooks e as tarefas batch.

Tu controlas

Ciclo de vida dos pedidos e experiência do produto

Ler a documentação

Perguntas frequentes

Fica a conhecer as ligações MCP, as chaves de API, o âmbito das ferramentas, a faturação e a recuperação de tarefas longas.

Cria uma chave de API, segue a documentação do MCP para adicionar o PoYo ao teu cliente e verifica depois a tua conta, o esquema dos modelos e os preços públicos.

Criar chave de APILer a documentação do MCP