MCP 연동

MCP 는 ChatGPT, Claude, Cursor 같은 AI 도구에 데브다이브-모두의창업 AI API를 그대로 붙여서 쓰게 해 주는 연결 방식입니다. 한 번 연결해 두면, 사용하던 AI 도구 안에서 바로 모델 목록 조회·텍스트 생성·이미지 분석·워크플로우 실행 같은 기능을 부를 수 있어요.

별도의 설치나 서버 준비는 필요 없습니다. 연결 주소만 등록하고 로그인하거나, 연결 주소와 API 키를 등록하면 됩니다.

연결 주소

https://modoo.devdive.me/mcp — 주소를 클릭하면 바로 복사됩니다.

연결 방식 고르기

방식	이런 도구에	필요한 것
로그인(OAuth)	ChatGPT 웹, Claude.ai 웹 커넥터 등 로그인 연결을 지원하는 도구	연결 주소 + 모두의창업 계정
API 키	Claude Desktop, Cursor, Claude Code 등 설정 파일(JSON)로 등록하는 도구	연결 주소 + 대시보드에서 발급한 `sk-modoo-...` 키

도구에 인증 방식(OAuth) 선택 칸이 있으면 로그인 방식을, 헤더를 직접 넣는 설정이면 API 키 방식을 쓰면 됩니다.

로그인으로 연결하기 (OAuth)

API 키를 복사해 붙여 넣을 필요 없이, 모두의창업 계정으로 로그인해서 연결합니다.

ChatGPT

ChatGPT에서 새 커넥터(플러그인)를 추가하는 화면을 엽니다.
다음과 같이 입력합니다.
- 이름: 원하는 이름 (예: 데브다이브)
- 연결: 서버 URL 을 선택하고 연결 주소 https://modoo.devdive.me/mcp 를 붙여 넣습니다.
- 인증: OAuth 를 선택합니다. 고급 OAuth 설정은 건드리지 않아도 됩니다(자동으로 찾아 설정됩니다).
안내 문구를 확인하고 체크한 뒤 만들기를 누릅니다.
모두의창업 로그인 창이 열리면 발급받은 아이디로 로그인하고, 연결 요청 화면에서 허용을 누릅니다.
ChatGPT로 돌아오면 연결이 끝납니다. 대화에서 이 커넥터를 켜고 "사용 가능한 모델을 알려줘"처럼 요청해 보세요.

Claude.ai

설정 → 커넥터에서 커스텀 커넥터 추가를 누릅니다.
이름을 정하고 원격 MCP 서버 URL에 연결 주소 https://modoo.devdive.me/mcp 를 넣은 뒤 추가합니다.
연결을 누르면 열리는 로그인 창에서 로그인하고 허용을 누릅니다.

연결 요청 화면에서 확인할 것

허용 화면에는 어떤 앱이 연결을 요청하는지와 인증 결과가 전달될 주소가 표시됩니다. 직접 추가한 도구(예: ChatGPT → chatgpt.com)가 맞는지 확인하고 허용하세요. 모르는 요청이면 거부를 누르면 됩니다.

연결된 앱 관리

대시보드의 연결된 앱에서 연결한 앱, 연결할 때 사용한 기기(브라우저·OS)와 IP, 연결 시각·마지막 사용 시각을 확인할 수 있습니다.
더 이상 쓰지 않거나 모르는 연결이 보이면 해제를 누르세요. 해제하면 그 앱은 즉시 더 이상 호출할 수 없고, 다시 쓰려면 도구에서 재연결하면 됩니다.
로그인 연결은 한동안 쓰지 않으면(30일) 자동으로 만료되어 다시 로그인해야 합니다.
사용량은 API 키와 별도로 앱 단위로 집계됩니다.

API 키로 연결하기

Claude Desktop, 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`(선택)
`upload_file`	첨부한 이미지·영상·오디오·PDF를 내 드라이브에 저장하고 링크 받기	`file`(ChatGPT 첨부 파일), `url`(https 주소), `encoded_file`+`file_name`(base64) 중 하나
`list_drive`	내 드라이브 파일 목록(업로드한 파일과 생성 결과)	`page`(선택), `size`(선택, 최대 50)
`create_upload_link`	첨부 파일을 도구로 넘길 수 없을 때(Claude 등) 드라이브에 올릴 일회용 링크 만들기	(없음)
`get_upload_link`	업로드 링크로 올라온 파일의 드라이브 링크 받기	`link_id`
`analyze_image`	이미지 분석	`image_url` 또는 `encoded_image`
`analyze_document`	문서 분석	`file_url` 또는 `encoded_file`, `operation`(선택)
`generate_image`	이미지 생성(텍스트→이미지)	`prompt`, `model`(선택, 기본 `modoo-image-gpt-2-5-flare`), `size`(선택), `n`(선택), `quality`(선택, GPT Image 전용: `auto`·`low`·`medium`·`high`)
`edit_image`	이미지 수정(원본 유지, image-to-image)	`prompt`, `image_url`/`image_urls`/`encoded_image` 중 하나, `model`(선택), `quality`(선택, `modoo-image-gpt-edit` 전용)
`generate_video`	영상 생성(텍스트→영상)	`prompt`, `model`(선택: `modoo-video`\|`modoo-video-wan30-t2v`\|`modoo-video-happyhorse-t2v`), `negative_prompt`(선택), 옵션 `resolution`·`ratio`·`duration`·`watermark`·`seed`(선택), `audio`(선택, WAN 3.0 전용)
`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)	`model`(선택: `modoo-video-happyhorse-r2v`(기본)\|`modoo-video-wan30-r2v`), `prompt`(HappyHorse 필수·WAN 3.0 선택), `reference_image_urls`(HappyHorse는 1~9장 필수), WAN 3.0 전용 `image_url`·`end_image_url`·`reference_video_urls`·`reference_audio_urls`·`audio`(선택), `resolution`·`ratio`·`duration`·`watermark`·`seed`(선택)
`edit_video`	영상 수정(video-to-video, HappyHorse 1.0)	`prompt`, `video_url`(https 주소), `reference_image_urls`(선택), `resolution`·`audio_setting`(`auto`\|`origin`)·`watermark`·`seed`(선택)
`transfer_motion`	사진 속 인물이 영상의 동작 따라 하기(WAN image-to-action)	`image_url`, `video_url`(https 주소), `mode`(선택: `wan-std`(기본)\|`wan-pro`)
`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 도구가 파일을 넣으면 알아서 처리해 줘요.

드라이브 링크: upload_file·list_drive·get_upload_link가 돌려주는 링크(https://modoo.devdive.me/v1/media/...)는 image_url·video_url·audio_url·file_url 등 모든 입력 주소 자리에 그대로 넣을 수 있습니다. 링크는 3일 동안 유효하며, 본인 계정의 링크만 쓸 수 있어요.

비동기 작업: generate_image·edit_image·generate_video·animate_image·reference_to_video·edit_video·transfer_motion·generate_music·transcribe는 시간이 걸리는 작업이라, 도구가 최대 약 45초 동안 기다렸다가 그 안에 끝나면 최종 결과(이미지/영상/음악 URL, 텍스트)를 돌려줍니다. 더 오래 걸리면 still_processing과 job_id를 돌려주고, AI 도구가 get_job을 호출해 이어서 기다립니다(한 번에 최대 약 45초). ChatGPT처럼 도구 호출을 약 1분만 기다리는 도구에서도 끊기지 않게 하기 위한 방식이에요.

결과 링크: MCP로 받은 이미지·영상·음악 링크(https://modoo.devdive.me/v1/media/...)는 생성 후 3일 동안 열 수 있습니다. 열 때마다 새 다운로드 주소로 연결돼 AI 도구가 링크를 옮겨 적어도 깨지지 않아요. 3일이 지나면 다시 생성해야 합니다.

중복 생성 방지: AI 도구가 응답을 기다리다 같은 요청을 다시 보내더라도, 5분 안에 들어온 똑같은 입력의 생성 요청은 새로 만들지 않고 처음 작업을 그대로 돌려줍니다(추가 과금 없음). 같은 입력으로 새 결과를 받고 싶다면 5분 뒤에 다시 요청하거나 입력을 조금 바꿔 주세요.

워크플로우: run_workflow는 blocks를 앞에서부터 순서대로 실행하고, 앞 블록의 결과를 {{블록id.필드}}로 뒷 블록에 이어 씁니다. 실행 결과는 저장되므로, 돌려받은 run_id로 get_workflow_run을 호출하면 언제든 다시 확인할 수 있어요. 데브다이브 에디터에서 만든 워크플로우라면 blocks를 직접 쓰지 않고 run_workflow_by_id에 에디터 주소(/workspace/editor/{id})의 id만 넘겨 실행할 수 있습니다.

이미지 첨부해서 생성하기

내 사진·영상으로 이미지 수정, 영상 만들기, 분석을 하고 싶을 때는 먼저 파일을 드라이브에 올리고, 받은 링크를 생성 도구에 넘깁니다.

ChatGPT: 채팅창에 이미지를 첨부하고 "이 사진을 수도복 입은 모습으로 바꿔줘"처럼 요청하세요. ChatGPT가 upload_file로 파일을 내 데브다이브 드라이브에 저장한 뒤, 그 링크를 edit_image 같은 도구의 입력으로 씁니다. 첨부가 도구까지 전달되지 않는 경우(특히 모바일)가 가끔 있어요. 그럴 땐 안내에 따라 파일을 다시 첨부해 주세요.
Claude: Claude는 채팅에 첨부한 파일을 MCP 도구로 넘기지 못합니다(이미지를 볼 수는 있지만 파일 자체는 도구에 전달되지 않아요). 그래서 Claude는 create_upload_link로 일회용 업로드 링크를 만들어 씁니다.
- 코드 실행이 켜져 있고 modoo.devdive.me로 나가는 네트워크가 허용돼 있으면, Claude가 첨부 파일을 그 링크로 직접 올립니다. 설정 → 기능(Capabilities)의 코드 실행 네트워크 허용 도메인에 modoo.devdive.me를 추가하세요(팀·엔터프라이즈는 관리자가 설정).
- 그렇지 않으면 Claude가 링크(https://modoo.devdive.me/upload/...)를 알려 줍니다. 링크를 열어 파일을 고르고, 채팅으로 돌아가 "다 올렸어"라고 말하면 Claude가 get_upload_link로 파일을 가져다 씁니다. 로그인은 필요 없어요.
- 업로드 링크는 30분 동안, 링크 하나에 파일 10개까지 받습니다. 링크를 아는 사람은 누구나 내 드라이브에 파일을 올릴 수 있으니 다른 사람과 공유하지 마세요.
그 밖의 도구(Cursor, Claude Code 등): 공개 https 주소가 있으면 upload_file의 url로 넘깁니다. 내 컴퓨터의 파일이라면 create_upload_link의 upload_url로 curl -F "[email protected]" <upload_url>처럼 올리면 됩니다.
이미 올린 파일과 생성 결과는 list_drive로 다시 찾아 쓸 수 있습니다. 링크는 3일 동안 유효해요.
올릴 수 있는 파일: 이미지·영상·오디오·PDF, 파일당 최대 50MB. 파일 내용으로 형식을 확인하므로, 이름만 바꾼 실행 파일이나 SVG·HTML, 스크립트가 든 PDF는 올라가지 않아요. 올린 파일은 숨은 내용을 걸러 내고 다시 만들어 저장합니다(사진의 위치 정보 등 메타데이터도 지워져요).

워크플로우(run_workflow)의 blocks 작성법은 워크플로우 문서를 참고하세요.

보안 안내

API 키를 조심히 다루세요

연결 설정의 Authorization 헤더에는 API 키가 그대로 담깁니다. 이 키는 비밀번호와 같으니 다른 사람과 공유하거나 공개된 곳(예: 공용 저장소)에 올리지 마세요. 키가 노출된 것 같으면 대시보드에서 즉시 재발급하세요.

로그인 연결은 키를 다루지 않아도 됩니다

로그인(OAuth) 방식은 API 키가 설정에 남지 않고, 연결마다 따로 발급·만료되는 토큰을 씁니다. 도구가 지원한다면 로그인 방식이 더 안전합니다. 의심스러운 연결은 대시보드 연결된 앱에서 바로 해제하세요.

다음으로

각 기능의 상세 규격 → API 레퍼런스
여러 작업 이어 붙이기 → 워크플로우
오류 코드 해설 → 오류 안내

연결 주소​

연결 방식 고르기​

로그인으로 연결하기 (OAuth)​

ChatGPT​

Claude.ai​

연결된 앱 관리​

API 키로 연결하기​

사용할 수 있는 도구​

이미지 첨부해서 생성하기​

보안 안내​

다음으로​