> ## Documentation Index > Fetch the complete documentation index at: https://docs.toapis.com/llms.txt > Use this file to discover all available pages before exploring further. # MCP 연결 가이드 > MCP로 AI 에이전트를 ToAPIs에 연결하고 200개 이상의 모델로 이미지와 동영상을 생성합니다. MCP로 평소 쓰는 에이전트에 ToAPIs를 연결하세요. API 키를 복사하는 대신 브라우저로 로그인해 승인합니다. 에이전트가 모델을 고르고, 파라미터를 확인하고, 작업을 제출해 결과를 가져옵니다. > [!NOTE] > > 계정과 잔액이 있는 사이트의 주소를 선택하세요. 아래 예시는 국제 사이트 기준입니다. toapis.cn 계정은 `https://api.toapis.com/mcp`를 `https://api.toapis.cn/mcp`로 바꾸고 toapis.cn 콘솔을 사용하세요. 두 사이트의 계정과 잔액은 별개입니다. | 사이트 | MCP endpoint | | - | - | | 국제 사이트 | `https://api.toapis.com/mcp` | | 중국 본토 사이트 | `https://api.toapis.cn/mcp` | ## 연결 전 준비 Streamable HTTP 방식의 원격 MCP를 지원하는 클라이언트가 필요합니다. ToAPIs skills는 모델 선택과 프롬프트 작성을 돕는 선택 기능입니다. `npx skills add`에는 Node.js가 필요하지만 skills를 설치하지 않아도 MCP는 작동합니다. 브라우저 승인 시 해당 ToAPIs 사이트에 로그인하고 클라이언트 이름을 확인한 다음 API 키를 선택하거나 한도가 있는 전용 키를 만들고 허용하세요. 헤더 인증은 [API Tokens](https://toapis.com/dashboard/tokens)에서 전용 키를 만든 뒤 로컬에서 ``를 바꾸세요. 실제 키를 채팅이나 버전 관리에 넣지 마세요. ## 클라이언트를 고르고 몇 단계로 연결하세요 > [accordion] Claude Code > > ### Claude Code > > 터미널에서 아래 명령을 실행하세요. 첫 명령은 선택 사항인 skills 설치이고 두 번째는 MCP 서버 추가입니다. 이후 `/mcp`에서 승인하고 `claude mcp list`로 연결을 확인하세요. > > ```bash theme={null} > npx skills add toapis/skills -g --agent claude-code -y > claude mcp add --transport http --scope user toapis https://api.toapis.com/mcp --header "X-Locale: ko" > ``` > > ### /mcp에서 승인 > > Claude Code에서 /mcp를 입력하고 toapis를 선택한 뒤 브라우저에서 로그인하세요. 목록에 toapis가 없으면 먼저 Claude Code를 다시 시작하세요. > [accordion] Claude > > ### 직접 추가 > > 설정 > 커넥터를 열고 사용자 지정 커넥터를 추가하세요. 이름은 ToAPIs, URL은 아래 주소를 입력하고 OAuth Client ID와 Secret은 비워 둡니다. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### 연결하고 승인 > > Add를 누르고 Connect를 클릭한 뒤, ToAPIs 페이지에서 로그인하고 API 키를 골라 '허용'을 클릭하세요. > > Claude는 Anthropic 서버에서 ToAPIs에 접속하므로 IP 허용 목록이 설정된 키는 고르지 마세요. Free 플랜에서는 사용자 지정 커넥터를 1개만 추가할 수 있습니다. > [accordion] Codex > > ### Codex > > 터미널에서 아래 명령을 실행하세요. 첫 명령은 선택 사항인 skills 설치입니다. 서버 추가 시 브라우저 승인이 열리면 먼저 완료하세요. `codex mcp list`에 `Not logged in`이 표시되면 `codex mcp login toapis`를 실행하고 승인 후 다시 확인하세요. 설정 후 새 대화를 시작하세요. > > ```bash theme={null} > npx skills add toapis/skills -g --agent codex -y > codex mcp add toapis --url https://api.toapis.com/mcp > codex mcp list > ``` > > ### 브라우저에서 승인 > > Codex가 ToAPIs 승인 페이지를 엽니다. 로그인한 뒤 클라이언트 이름을 확인하고, API 키를 고르거나 사용 한도가 있는 전용 키를 만든 다음 '허용'을 클릭하세요. 데스크톱 앱에서는 설정 > MCP servers에서 toapis 옆의 Authenticate로도 승인할 수 있습니다. > > Codex CLI와 데스크톱 앱은 같은 설정을 공유하므로 한 번 설정하면 둘 다 사용할 수 있습니다. > > [Codex MCP](https://developers.openai.com/codex/mcp/) > [accordion] Cursor > > ### ToAPIs 추가 > > 아래 설정을 `~/.cursor/mcp.json`에 합친 뒤 MCP 설정에서 연결하세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "X-Locale": "ko" > } > } > } > } > ``` > > 선택 사항인 skills 설치: > > ```bash theme={null} > npx skills add toapis/skills -g --agent cursor -y > ``` > > ### 로그인하고 승인 > > Cursor의 MCP 설정에서 toapis 옆의 Connect를 클릭하고, 브라우저에서 ToAPIs에 로그인한 뒤 API 키를 골라 '허용'을 클릭하세요. > [accordion] Devin > > ### ToAPIs 추가 > > Devin Desktop과 Devin CLI는 같은 설정을 공유합니다. 터미널에서 아래 명령을 실행하거나 Devin에게 실행을 부탁하세요: > > ```bash theme={null} > devin mcp add -s user toapis https://api.toapis.com/mcp > devin mcp login toapis > ``` > > ### 브라우저에서 승인 > > devin mcp login toapis를 실행하면 브라우저가 열립니다. ToAPIs에 로그인하고 API 키를 골라 '허용'을 클릭하세요. 실행하지 않아도 Devin이 toapis를 처음 사용할 때 로그인을 요청합니다. > [accordion] Antigravity > > ### MCP 설정에 추가 > > Antigravity 앱, IDE, CLI는 `~/.gemini/config/mcp_config.json을` 공유합니다. 아래 설정을 병합해 저장한 다음, CLI에서 /mcp를 입력하거나 설정에서 서버를 다시 불러오세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "serverUrl": "https://api.toapis.com/mcp", > "headers": { > "X-Locale": "ko" > } > } > } > } > ``` > > 기존 설정에 `toapis` 항목을 합치고 다른 서버는 유지하세요. > > ### 승인하고 코드 붙여 넣기 > > `Cmd + ,`(Windows는 `Ctrl + ,`)로 Antigravity 설정을 열고 Customizations에서 toapis 옆의 Authenticate를 클릭하세요. 브라우저에서 ToAPIs에 로그인해 '허용'을 클릭하면 인증 코드가 표시됩니다. 이 코드를 설정 화면에 붙여 넣고 Submit을 클릭하세요. > [accordion] Doubao(豆包) > > ### 전용 키 만들기 > > 이 클라이언트는 요청 헤더에 키를 넣는 방식만 지원합니다. ToAPIs 콘솔에서 키를 만들고(사용 한도 설정을 권장합니다) 복사해 두세요. 아래 설정의 ``를 이 키로 바꿉니다. > > [API 토큰 열기](https://toapis.com/dashboard/tokens) > > ### 사용자 지정 플러그인 만들기 > > 豆包 데스크톱 앱을 열고 왼쪽의 "插件·技能·伙伴"를 클릭한 뒤, "插件" 페이지 오른쪽 위의 "+ 添加"에서 "新建自定义插件"을 선택하세요. 서버 이름은 ToAPIs, 전송 유형은 HTTP를 선택하고 서버 URL에 아래 주소를 입력합니다. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### 인증 헤더 입력 후 저장 > > "自定义 Headers"에서 "+ 添加"를 클릭하고, 헤더 이름에 Authorization, 값에 아래 줄을 입력한 뒤(``는 내 키로 바꾸기) "保存"을 클릭하세요. > > ```text theme={null} > Bearer > ``` > > 豆包 데스크톱 앱(Windows 또는 macOS)에서 추가하세요. 기업 계정에서 사용자 지정 플러그인을 쓸 수 있는지는 관리자 설정에 따릅니다. > [accordion] QwenWork(千问办公) > > ### 전용 키 만들기 > > 이 클라이언트는 요청 헤더에 키를 넣는 방식만 지원합니다. ToAPIs 콘솔에서 키를 만들고(사용 한도 설정을 권장합니다) 복사해 두세요. 아래 설정의 ``를 이 키로 바꿉니다. > > [API 토큰 열기](https://toapis.com/dashboard/tokens) > > ### JSON 설정 붙여넣기 > > 千问办公 왼쪽에서 "扩展" > "连接器"를 열고 오른쪽 위의 "+ 添加" > "粘贴 JSON 配置"를 클릭한 뒤, 아래 설정을 붙여넣고(``는 내 키로 바꾸기) "导入"를 클릭하세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "type": "streamable-http", > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ko" > } > } > } > } > ``` > > ### 커넥터 켜기 > > 커넥터는 기본적으로 꺼져 있습니다. 목록에서 toapis를 켠 다음 새 작업을 만들어야 적용되며, 기존 대화에서는 쓸 수 없습니다. > [accordion] Qwen Code > > ### 터미널에서 실행 > > 첫 번째 명령은 ToAPIs 스킬을 설치하고(Node.js 필요, 없어도 MCP는 사용 가능), 두 번째 명령은 ToAPIs MCP 서버를 추가합니다: > > ```bash theme={null} > npx skills add toapis/skills -g --agent qwen-code -y > qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "X-Locale: ko" > ``` > > ### 브라우저에서 승인 > > qwen을 실행해 Qwen Code를 시작하면 ToAPIs에 연결할 때 브라우저에서 승인 페이지가 열립니다. 로그인한 뒤 키를 고르고 허용하세요. Qwen Code에서 /mcp를 입력하면 toapis의 연결 및 승인 상태를 볼 수 있습니다. > > ### 브라우저 승인이 안 되나요? API 키 사용 > > 콘솔의 "API 토큰"에서 키를 만들고, 아래 명령의 ``를 그 키로 바꿔 실행하세요. > > ```bash theme={null} > qwen mcp add --scope user --transport http toapis https://api.toapis.com/mcp --header "Authorization: Bearer " --header "X-Locale: ko" > ``` > [accordion] Trae CN > > ### 전용 키 만들기 > > 이 클라이언트는 요청 헤더에 키를 넣는 방식만 지원합니다. ToAPIs 콘솔에서 키를 만들고(사용 한도 설정을 권장합니다) 복사해 두세요. 아래 설정의 ``를 이 키로 바꿉니다. > > [API 토큰 열기](https://toapis.com/dashboard/tokens) > > ### MCP 서버 직접 추가 > > Trae에서 "设置" > "MCP"를 열고, "MCP Servers 管理" 오른쪽 위의 "添加" > "手动添加"를 클릭한 뒤, 아래 설정을 붙여넣고(``는 내 키로 바꾸기) "确认"을 클릭하세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ko" > } > } > } > } > ``` > > ### 스킬 설치(권장) > > 에이전트가 모델을 더 잘 고르고 프롬프트를 더 잘 쓰게 됩니다(Node.js 필요, 없어도 MCP는 사용 가능): > > ```bash theme={null} > npx skills add toapis/skills -g --agent trae-cn -y > ``` > [accordion] WorkBuddy > > ### 사용자 지정 커넥터 추가 > > WorkBuddy 사이드바에서 커넥터를 열고 오른쪽 위의 '사용자 지정 커넥터'를 클릭한 뒤, 아래 설정을 붙여 넣고 저장하세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "type": "http", > "url": "https://api.toapis.com/mcp" > } > } > } > ``` > > ### 연결하고 승인 > > Trust와 Connect를 클릭하고, 열린 ToAPIs 페이지에서 로그인한 뒤 API 키를 골라 '허용'을 클릭하세요. > [accordion] 기타 클라이언트 > > ### 원격 MCP 서버 추가 > > 아래 URL로 원격 MCP 서버(Streamable HTTP)를 추가하고 인증 방식으로 OAuth를 고르세요. Client ID와 Secret은 비워 둡니다. > > ```text theme={null} > https://api.toapis.com/mcp > ``` > > ### 브라우저 로그인을 지원하지 않나요? > > 일부 클라이언트는 헤더 인증만 지원하거나 브라우저 승인을 완료하지 못합니다. 콘솔에서 전용 키를 만들고 Authorization: Bearer 헤더로 연결하세요. > > ```json theme={null} > { > "mcpServers": { > "toapis": { > "url": "https://api.toapis.com/mcp", > "headers": { > "Authorization": "Bearer ", > "X-Locale": "ko" > } > } > } > } > ``` ## 연결 확인 새 대화에서 아래 문장을 보내세요. 잔액이 보이면 연결된 것입니다(조회는 무료). 로그인을 요구하거나 인증에 실패하거나 ToAPIs 도구를 찾지 못하면 위 단계를 다시 확인하세요. ```text theme={null} ToAPIs 크레딧이 얼마나 남았고 오늘 얼마나 썼어? ``` ## 연결하면 할 수 있는 일 원하는 것을 평소 말투로 설명하세요. 에이전트가 모델을 고르고, 문서에 맞춰 파라미터를 준비하고, 작업을 제출해 끝까지 확인합니다. ### 이미지 생성 텍스트로 이미지 생성, 참조 이미지 편집, 비율과 개수 지정. ```text theme={null} ToAPIs로 새벽 등대 이미지를 16:9로 생성해 줘 ``` ### 동영상 생성 텍스트로 동영상, 이미지로 동영상 생성. 기본 추천 모델은 Seedance입니다. ```text theme={null} 이 제품 사진을 5초짜리 세로형 홍보 영상으로 만들어 줘 ``` ### 로컬 파일 사용 로컬 이미지 경로를 알려 주면 에이전트가 업로드해 참조 이미지로 사용합니다. ```text theme={null} ./product.png를 참고해서 제품을 흰색 배경에 놓아 줘 ``` 에이전트는 생성 전 모델 문서를 읽고 `create_upload`로 로컬 참조 파일을 업로드한 뒤 `get_generation`으로 진행 상황을 확인합니다. 실행 중에는 다시 제출하지 말고 기다리세요. 제출 응답을 받지 못했다면 재시도 시 같은 `client_request_id`를 사용하세요. 새 ID는 별도의 유료 작업을 만들 수 있습니다. 상태가 `unknown`이면 먼저 콘솔 작업 목록을 확인하세요. 반환된 결과 URL을 저장하세요. 클라이언트가 결과를 로컬로 다운로드할 수도 있습니다. ## 사용 가능한 도구 | 도구 | 용도 | | - | - | | `list_models` | 현재 키에서 사용 가능한 이미지 및 동영상 모델과 가격, `docs_available`을 조회합니다. | | `get_model_docs` | 생성 전에 모델 매개변수 문서를 읽습니다. `docs_available: true`인 모델을 선택하세요. | | `generate_image` | 이미지를 생성합니다. 유료입니다. | | `generate_video` | 동영상을 생성합니다. 유료입니다. | | `get_generation` | `client_request_id`로 MCP 생성 진행 상황과 결과를 확인합니다. | | `get_task` | `task_id`로 이미지 또는 동영상 작업을 조회합니다. | | `create_upload` | 로컬 이미지, 동영상 또는 오디오의 일회용 업로드 URL을 만듭니다. | | `get_balance` | 키 할당량과 계정 잔액을 확인합니다. | | `list_tasks` | 현재 키의 최근 작업을 조회합니다. | | `get_usage` | 현재 키의 최대 31일간 청구 금액을 집계합니다. 환불액은 차감하지 않습니다. | ## 자주 묻는 질문 > [accordion] API 키가 필요한가요? > > 복사할 필요는 없습니다. 승인할 때 ToAPIs 페이지에서 기존 키를 고르거나 전용 키를 만들면, 에이전트가 액세스 토큰을 통해 그 키를 사용합니다. 헤더 인증만 지원하는 클라이언트는 API 키로 연결할 수도 있습니다. > [accordion] 요금은 어떻게 부과되나요? > > API를 직접 호출할 때와 같이 모델 가격이 선택한 키와 계정 크레딧에서 차감됩니다. 모델 목록, 잔액, 작업 조회는 무료이며 이미지와 동영상 생성만 과금됩니다. > [accordion] Codex에 Full access가 필요한 이유는 무엇인가요? > > 스킬 설치와 MCP 서버 추가는 컴퓨터의 Codex 설정에 기록되는데, 기본 권한 모드에서는 에이전트가 워크스페이스 밖의 파일을 바꿀 수 없습니다. 설정할 때만 필요하며 끝나면 되돌릴 수 있습니다. 터미널에서 명령을 직접 실행해도 됩니다. > [accordion] 연결을 해제하려면 어떻게 하나요? > > 콘솔의 '연결된 앱'에서 연결을 해제하세요. 승인이 취소되고, 이 연결용으로 만든 전용 키도 비활성화됩니다(다른 연결에서 사용 중인 경우 제외). 클라이언트에서 toapis를 삭제하는 것(예: codex mcp remove toapis)은 로컬 설정만 지웁니다. > [accordion] toapis.com과 toapis.cn은 무엇이 다른가요? > > 두 사이트는 계정과 크레딧이 따로 관리됩니다. toapis.com 계정은 api.toapis.com/mcp를, toapis.cn 계정은 api.toapis.cn/mcp를 사용합니다. 다른 사이트에서 로그인하면 사이트가 일치하지 않는다는 안내가 표시됩니다. > [accordion] 어떤 클라이언트를 지원하나요? > > 원격 MCP와 OAuth를 지원하는 데스크톱·명령줄 클라이언트는 대부분 '기타 클라이언트' 방법으로 연결할 수 있습니다. 승인이 실패하면 API 키로 연결하세요. 더 많은 클라이언트의 안내를 계속 추가할 예정입니다. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.