MCP 연결 가이드

MCP로 평소 쓰는 에이전트에 ToAPIs를 연결하세요. API 키를 복사하는 대신 브라우저로 로그인해 승인합니다. 에이전트가 모델을 고르고, 파라미터를 확인하고, 작업을 제출해 결과를 가져옵니다.

연결 전 준비

Streamable HTTP 방식의 원격 MCP를 지원하는 클라이언트가 필요합니다. ToAPIs skills는 모델 선택과 프롬프트 작성을 돕는 선택 기능입니다. npx skills add에는 Node.js가 필요하지만 skills를 설치하지 않아도 MCP는 작동합니다.

브라우저 승인 시 해당 ToAPIs 사이트에 로그인하고 클라이언트 이름을 확인한 다음 API 키를 선택하거나 한도가 있는 전용 키를 만들고 허용하세요. 헤더 인증은 API Tokens에서 전용 키를 만든 뒤 로컬에서 <API_KEY>를 바꾸세요. 실제 키를 채팅이나 버전 관리에 넣지 마세요.

클라이언트를 고르고 몇 단계로 연결하세요

연결 확인

새 대화에서 아래 문장을 보내세요. 잔액이 보이면 연결된 것입니다(조회는 무료). 로그인을 요구하거나 인증에 실패하거나 ToAPIs 도구를 찾지 못하면 위 단계를 다시 확인하세요.

ToAPIs 크레딧이 얼마나 남았고 오늘 얼마나 썼어?

연결하면 할 수 있는 일

원하는 것을 평소 말투로 설명하세요. 에이전트가 모델을 고르고, 문서에 맞춰 파라미터를 준비하고, 작업을 제출해 끝까지 확인합니다.

이미지 생성

텍스트로 이미지 생성, 참조 이미지 편집, 비율과 개수 지정.

ToAPIs로 새벽 등대 이미지를 16:9로 생성해 줘

동영상 생성

텍스트로 동영상, 이미지로 동영상 생성. 기본 추천 모델은 Seedance입니다.

이 제품 사진을 5초짜리 세로형 홍보 영상으로 만들어 줘

로컬 파일 사용

로컬 이미지 경로를 알려 주면 에이전트가 업로드해 참조 이미지로 사용합니다.

./product.png를 참고해서 제품을 흰색 배경에 놓아 줘

에이전트는 생성 전 모델 문서를 읽고 create_upload로 로컬 참조 파일을 업로드한 뒤 get_generation으로 진행 상황을 확인합니다. 실행 중에는 다시 제출하지 말고 기다리세요. 제출 응답을 받지 못했다면 재시도 시 같은 client_request_id를 사용하세요. 새 ID는 별도의 유료 작업을 만들 수 있습니다. 상태가 unknown이면 먼저 콘솔 작업 목록을 확인하세요. 반환된 결과 URL을 저장하세요. 클라이언트가 결과를 로컬로 다운로드할 수도 있습니다.

사용 가능한 도구

자주 묻는 질문