GPT Image 2.5 API 출시. 이미지 생성과 편집을 시작하세요 →
PoYoPoYo

PoYo MCP Server

모든 PoYo 모델을 AI Agent 안에서.

한 번만 연결하면 Codex, Claude Code, Cursor, VS Code가 이미지, 비디오, 오디오, 채팅, 3D 모델을 검색하고 최신 Schema와 공개 가격을 확인한 뒤 PoYo를 통해 작업을 실행할 수 있습니다.

MCP는 API 요청을 직접 작성하지 않아도 AI Agent가 PoYo 모델을 사용할 수 있게 해 주는 안전한 연결입니다.

npx -y @poyoapi/mcp

VS Code 또는 stdio 전용 클라이언트용 로컬 브리지입니다. Node.js 20+가 필요하며 아래 설정을 사용하세요.

API Key 생성설정 보기MCP 문서 보기

설정 방법

세 단계로 연결하세요. 카테고리나 모델을 제한할 때만 고급 설정을 여세요.

1

API Key 준비

먼저 PoYo API Key를 만드세요. 클라이언트가 연결할 때 사용합니다.

실제 API Key를 공유 설정 파일이나 URL에 입력하지 마세요.

API Key 생성
2

클라이언트를 선택하고 설정 위치 찾기

사용 중인 앱을 선택하면 관련 설정 위치 하나만 표시됩니다.

권장 설정 진입점

Codex Settings에서 MCP servers를 열고 Add server와 Streamable HTTP를 선택하세요.

클라이언트 공식 안내 보기

수동 설정 파일

~/.codex/config.toml

적용 범위

현재 사용자의 모든 프로젝트

클라이언트에서 MCP 설정을 여세요. 화면에 진입점이 없다면 위 파일을 열거나 만드세요.

./로 시작하는 경로는 현재 열린 프로젝트 안에 있습니다. 필요하면 폴더나 파일을 만드세요.

3

설정을 추가하고 확인

선택한 클라이언트의 설정을 복사하고 MCP를 다시 불러온 뒤 무료 연결 확인을 완료하세요.

기존 설정은 덮어쓰지 말고 병합하세요

파일에 다른 MCP Server가 있다면 poyo 서버 항목만 병합하고 기존 내용을 모두 유지하세요.

다음 설정을 추가할 위치 ~/.codex/config.toml

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

클라이언트를 시작하기 전에 API Key를 POYO_API_KEY 환경 변수로 저장하세요. 저장 후 새 Codex 세션을 시작해 MCP 설정을 다시 불러오세요.

POYO_API_KEY를 어떻게 설정하나요?

운영체제에 맞는 명령을 복사하고 your_api_key를 실제 Key로 바꾼 뒤 같은 터미널 세션에서 클라이언트를 시작하세요.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

이 명령은 현재 터미널 세션에만 적용됩니다. 실제 Key를 프로젝트 파일, 스크린샷 또는 공개 명령 로그에 남기지 마세요.

MCP 문서 보기
Agent에게 안전한 설정 요청

기존 설정을 유지하고 실제 Key를 파일에 쓰지 않으며 쓰기 전 diff를 보여 주도록 제한한 Prompt를 복사합니다.

연결 확인

다음 상태를 순서대로 확인하세요. 유료 모델 작업은 시작되지 않습니다.

  1. 1클라이언트에 PoYo 도구가 보이면 설정이 로드된 것입니다.
  2. 2poyo_account가 계정 정보를 반환하면 API Key가 적용된 것입니다.
  3. 3poyo_search_models가 모델을 반환하면 카탈로그에 접근할 수 있습니다.
연결되지 않나요?
  • 도구가 없음: 설정 위치를 확인하고 MCP Server를 다시 불러오세요.
  • 계정 확인 실패: POYO_API_KEY를 확인하고 같은 환경에서 클라이언트를 다시 시작하세요.
  • 연결 실패: https://api.poyo.ai/mcp와 네트워크 또는 프록시의 HTTPS 허용 여부를 확인하세요.

도구, 계정, 카탈로그 확인이 모두 통과하면 PoYo MCP 연결이 완료됩니다.

PoYo MCP로 Agent가 무엇을 할 수 있나요?

자연어로 작업을 설명하면 Agent가 적합한 모델을 검색하고 입력과 가격을 확인한 뒤 실행합니다. 장기 작업이 끝나면 결과를 반환합니다.

모델 탐색

자연어 작업을 바탕으로 현재 이미지, 비디오, 오디오, 채팅 또는 3D 모델 검색

poyo_search_models
후보 모델

입력 확인

최신 입력 Schema, 예시, 프로토콜, 기능 확인

poyo_get_model_schema
유효한 입력

가격 확인

유료 요청 실행 전에 현재 공개 가격 확인

poyo_get_pricing
가격 확인

단기 작업 실행

짧은 대기 후 결과를 반환할 수 있는 채팅 또는 생성 작업 완료

poyo_chatpoyo_run_model
완료된 결과

장기 작업 계속

장기 작업을 제출하고 task_id를 보관해 나중에 상태와 출력 확인

poyo_submit_jobpoyo_check_job
상태 및 출력

계정 확인

모델 실행 전 현재 계정 및 크레딧 정보 확인

poyo_account
계정 상태

MCP, CLI, REST API는 언제 사용해야 하나요?

Agent가 모델을 선택하고 호출해야 할 때는 MCP, 터미널이나 CI 자동화에는 PoYo CLI, 애플리케이션 트래픽이나 토큰 단위 출력에는 REST API를 사용하세요.

01

AI 어시스턴트 또는 코딩 Agent

선택

MCP

Streamable HTTP

적합한 이유

에디터나 대화 안에서 Agent가 모델을 탐색하고 Schema와 가격을 확인한 뒤 도구를 호출할 수 있습니다.

제어 항목

도구 범위 및 클라이언트 권한

문서 보기
02

터미널 스크립트 또는 CI

선택

PoYo CLI

@poyoapi/cli

적합한 이유

셸에서 모델을 탐색하고 생성을 실행하며 작업 완료를 기다린 뒤 JSON, JSONL 또는 CSV를 출력할 수 있습니다.

제어 항목

명령 플래그, 입력 파일, 출력 형식

문서 보기
03

애플리케이션 백엔드

선택

REST API

HTTP + JSON / SSE

적합한 이유

애플리케이션 트래픽, 토큰 스트리밍, 폴링, Webhook, 배치 작업을 처리합니다.

제어 항목

요청 수명 주기 및 제품 경험

문서 보기

자주 묻는 질문

MCP 연결, API Key, 도구 범위, 과금, 장기 작업 복구에 대해 알아보세요.

API Key를 생성하고 MCP 문서에 따라 클라이언트에 PoYo를 추가한 뒤 계정, 모델 Schema, 공개 가격을 확인하세요.

API Key 생성MCP 문서 보기