MCP 연동
MCP 는 Claude, Cursor 같은 AI 도구에 데브다이브-모두의창업 AI API를 그대로 붙여서 쓰게 해 주는 연결 방식입니다. 한 번 연결해 두면, 사용하던 AI 도구 안에서 바로 모델 목록 조회·텍스트 생성·이미지 분석·워크플로우 실행 같은 기능을 부를 수 있어요.
별도의 설치나 서버 준비는 필요 없습니다. 연결 주소와 API 키만 등록하면 됩니다.
연결에 필요한 것
- 연결 주소(MCP 엔드포인트) —
https://modoo.devdive.me/mcp - API 키 — 대시보드에서 발급받은
sk-modoo-...키
도구에 등록하기
Claude, Cursor, Claude Code 등은 아래와 같은 JSON 설정으로 연결을 등록합니다. 각 도구의 MCP(또는 커넥터) 설정 화면에 이 내용을 넣으면 됩니다.
{
"mcpServers": {
"modoo": {
"url": "https://modoo.devdive.me/mcp",
"headers": {
"Authorization": "Bearer sk-modoo-..."
}
}
}
}
url— 위의 연결 주소headers의Authorization— 발급받은 API 키를Bearer sk-modoo-...형태로 넣습니다
등록 후 AI 도구를 다시 시작하면 modoo 도구들이 목록에 나타납니다. "사용 가능한 모델을 알려줘"처럼 자연어로 요청하면 도구가 자동으로 호출돼요.
사용할 수 있는 도구
연결하면 다음 도구들을 AI 도구 안에서 쓸 수 있습니다.
| 도구 | 하는 일 | 입력값 |
|---|---|---|
list_models | 사용 가능한 모델 목록 조회 | (없음) |
get_credits | 남은 크레딧 확인 | (없음) |
get_usage | 최근 사용 내역 조회 | limit(선택) |
get_job | 비동기 작업 상태·결과 조회 | job_id |
generate_text | 텍스트 생성 | prompt, model(선택), system_prompt(선택) |
text_to_speech | 음성 합성(TTS) | text, model(선택: modoo-tts-minimax|modoo-tts-eleven), voice_id(선택; ElevenLabs는 필수), voice_model(선택), ElevenLabs 옵션 stability·similarity_boost·style·speed·use_speaker_boost·language_code·output_format·previous_text·next_text·seed·apply_text_normalization(선택) |
transcribe | 음성 → 텍스트(STT) | audio_url 또는 encoded_audio, language(선택) |
analyze_image | 이미지 분석 | image_url 또는 encoded_image |
analyze_document | 문서 분석 | file_url 또는 encoded_file, operation(선택) |
generate_image | 이미지 생성(텍스트→이미지) | prompt, model(선택), size(선택), n(선택) |
edit_image | 이미지 수정(원본 유지, image-to-image) | prompt, image_url/image_urls/encoded_image 중 하나, model(선택) |
generate_video | 영상 생성(텍스트→영상) | prompt, model(선택: modoo-video|modoo-video-happyhorse-t2v), negative_prompt(선택), HappyHorse 옵션 resolution·ratio·duration·watermark·seed(선택) |
animate_image | 이미지를 영상으로(image-to-video) | prompt, image_url(https 주소), end_image_url·driving_audio_url·first_clip_url(선택, modoo-video-i2v 전용 — 각각 마지막 프레임·구동 오디오·이어붙일 클립 https 주소), model(선택: modoo-video-i2v|modoo-video-happyhorse-i2v), negative_prompt(선택), HappyHorse 옵션 resolution·duration·watermark·seed(선택) |
reference_to_video | 참조 이미지로 영상 생성(reference-to-video) | prompt, reference_image_urls(1~9장 https 주소 목록), model(선택, 기본 modoo-video-happyhorse-r2v), resolution·ratio·duration·watermark·seed(선택) |
generate_music | 음악 생성(가사로 노래 만들기) | lyrics, model(선택, 기본 music-2.5), prompt(선택) |
web_search | 웹 검색(Brave) | query |
run_workflow | 워크플로우 실행(블록 직접 전달, 순차 실행) | blocks |
run_workflow_by_id | 데브다이브 에디터에 저장된 워크플로우를 id로 실행 | workflow_id |
get_workflow_run | 워크플로우 실행 기록 조회(상태·블록별 결과·요금) | run_id |
입력 형태: 이미지·오디오·문서 도구는 URL(
image_url/audio_url/file_url) 또는 인코딩된 데이터(encoded_*, 파일을 글자로 바꿔 담은 형태) 중 하나로 넣습니다. 대부분의 AI 도구가 파일을 넣으면 알아서 처리해 줘요.비동기 작업:
generate_image·edit_image·generate_video·animate_image·reference_to_video·generate_music·transcribe는 시간이 걸리는 작업이라, 도구가 완료될 때까지 기다렸다가 최종 결과(이미지/영상/음악 URL, 텍스트)를 돌려줍니다. 아주 오래 걸려 시간이 초과되면job_id를 돌려주니get_job으로 나중에 다시 확인하면 됩니다.
워크플로우:
run_workflow는blocks를 앞에서부터 순서대로 실행하고, 앞 블록의 결과를{{블록id.필드}}로 뒷 블록에 이어 씁니다. 실행 결과는 저장되므로, 돌려받은run_id로get_workflow_run을 호출하면 언제든 다시 확인할 수 있어요. 데브다이브 에디터에서 만든 워크플로우라면blocks를 직접 쓰지 않고run_workflow_by_id에 에디터 주소(/workspace/editor/{id})의 id만 넘겨 실행할 수 있습니다.
워크플로우(run_workflow)의 blocks 작성법은 워크플로우 문서를 참고하세요.
보안 안내
연결 설정의 Authorization 헤더에는 API 키가 그대로 담깁니다. 이 키는 비밀번호와 같으니 다른 사람과 공유하거나 공 개된 곳(예: 공용 저장소)에 올리지 마세요. 키가 노출된 것 같으면 대시보드에서 즉시 재발급하세요.