AI 도구에 연결하기

Codex 데스크톱 앱

화면에서 추가합니다. ChatGPT 데스크톱 앱 안의 Codex도 같은 방법입니다.

1. Settings를 열고 MCP servers를 선택합니다.
2. Add server를 누릅니다.
3. 이름에 gensapps를 입력하고 Streamable HTTP를 선택한 뒤, URL에 아래 주소를 입력합니다.
4. 저장한 뒤 Restart를 누릅니다. 입력창에 /mcp를 입력하면 연결된 서버가 보입니다.

명령으로 추가하기 (Codex CLI)

데스크톱 앱, CLI, IDE 확장이 같은 설정 파일(~/.codex/config.toml)을 함께 씁니다. 한 곳에서 추가하면 나머지에서도 보입니다.

$ codex mcp add gensapps --url https://deploy.gensapps.com/mcp
Added global MCP server 'gensapps'.
$ codex mcp list

Claude Code (CLI)

명령 한 줄로 추가합니다.

1. 터미널에서 아래 명령을 실행합니다. --transport http를 빼면 안 됩니다.
2. 모든 프로젝트에서 쓰려면 --scope user를 붙입니다. 붙이지 않으면 지금 프로젝트에서만 보입니다.
3. claude mcp list에서 Connected로 보이면 끝입니다. Claude Code 안에서는 /mcp로 확인합니다.

$ claude mcp add --transport http --scope user gensapps https://deploy.gensapps.com/mcp
$ claude mcp list
gensapps: https://deploy.gensapps.com/mcp (HTTP) - ✔ Connected

Claude 데스크톱 앱의 Code 탭도 같은 설정을 씁니다. 터미널에서 한 번 추가하면 됩니다.

VS Code의 Claude Code 확장

채팅 패널의 /mcp 또는 통합 터미널로 추가합니다.

1. Claude Code 확장의 채팅 패널에 /mcp를 입력합니다. 서버를 추가하고 켜고 끄는 창이 열립니다.
2. 서버를 추가하고 주소에 아래 값을 입력합니다. 이 창에서 추가하려면 Claude Code 2.1.261 이상이 필요합니다.
3. 새 대화를 시작한 뒤 /mcp에서 Connected인지 확인합니다. 추가하기 전에 열려 있던 대화에는 적용되지 않습니다.

통합 터미널로 추가하기

Ctrl+`로 터미널을 열고 Claude Code와 같은 명령을 실행해도 됩니다. 확장과 CLI가 같은 설정을 씁니다. 확장만 설치했다면 claude 명령이 없을 수 있습니다. 그때는 위의 /mcp 창을 쓰세요.

$ claude mcp add --transport http gensapps https://deploy.gensapps.com/mcp

Claude 데스크톱 앱 · claude.ai (채팅)

사용자 지정 커넥터로 추가합니다.

1. Customize > Connectors로 이동합니다.
2. + Add를 누르고 Add custom connector를 선택합니다.
3. 이름을 입력하고 서버 주소에 아래 값을 입력한 뒤 Continue를 누릅니다.
4. Authentication에서 No sign in을 선택하고 Add로 마칩니다.
5. 채팅 입력창의 + > Connectors에서 Deploy를 켭니다. 꺼져 있으면 Claude가 배포 도구를 쓰지 않습니다.

채팅 앱은 명령을 실행할 수 없어서 대화에서 만든 페이지를 바로 올리는 방식으로 씁니다. 내 사이트 목록과 삭제는 브라우저의 내 사이트에서 합니다. 무료 요금제는 사용자 지정 커넥터를 1개까지 추가할 수 있습니다. 연결한 뒤 쓰는 방법은 웹 채팅에서 바로 배포에서 봅니다.

Cursor

설정 파일에 주소를 넣습니다.

1. ~/.cursor/mcp.json 파일을 엽니다. 없으면 새로 만듭니다.
2. mcpServers 안에 아래 내용을 넣습니다. 이미 있는 다른 서버는 그대로 둡니다.
3. 저장하고 Cursor를 다시 시작합니다. Customize > MCPs 목록에 보이면 끝입니다.

{
  "mcpServers": {
    "gensapps": { "url": "https://deploy.gensapps.com/mcp" }
  }
}

ChatGPT

웹에서 사용자 지정 MCP 서버로 추가합니다.

1. 웹에서 chatgpt.com/plugins를 엽니다.
2. +를 누르고 Add custom MCP server를 선택합니다.
3. 이름을 입력하고 Server URL에 아래 주소를 입력합니다.
4. Authentication에서 No authentication을 선택하고, 안내를 읽은 뒤 I understand and want to continue를 선택합니다.
5. Create as a plugin을 누른 뒤, 만든 플러그인을 설치합니다. 설치하지 않으면 대화에서 쓸 수 없습니다.
6. 새 대화의 입력창에 @를 입력해 방금 만든 플러그인을 선택한 뒤 “이거 배포해줘”라고 말합니다. 선택하지 않으면 ChatGPT가 “배포 도구가 없다”고 답합니다.

요금제와 워크스페이스 설정에 따라 이 메뉴가 보이지 않을 수 있습니다. ChatGPT도 명령을 실행할 수 없어서 대화에서 만든 페이지를 바로 올리는 방식으로 씁니다. 연결한 뒤 쓰는 방법은 웹 채팅에서 바로 배포에서 봅니다.

추가한 뒤 로그인하기

“젠아이랩스로 로그인해줘” 한마디로 계정을 연결합니다.

추가한 뒤에는 말로 합니다. 로그인하지 않아도 배포는 됩니다. 로그인하면 올린 사이트가 내 계정에 모이고 보관 기간이 길어집니다.

내 컴퓨터에서 쓸 때 (Codex · Claude 데스크톱 · VS Code)

1. “젠아이랩스로 로그인해줘” 또는 “배포 환경에 로그인해줘”라고 말합니다.
2. 브라우저가 열립니다. 구글 계정을 선택합니다.
3. “연결되었습니다”가 보이면 끝입니다. 편집기로 돌아가면 이어서 진행됩니다.

원격 환경에서 쓸 때 (SSH · 클라우드 · 화면이 없는 곳)

1. 같은 말로 로그인을 요청합니다. 브라우저를 열 수 없으면 AI가 주소를 알려 줍니다.
2. 그 주소를 아무 브라우저에서 엽니다. 휴대폰도 됩니다. 구글로 로그인합니다.
3. 브라우저에 인증 코드가 보입니다. 그 코드를 AI에게 그대로 붙여 넣습니다.
4. “로그인했습니다”라고 답하면 끝입니다. 코드는 5분 동안만 사용할 수 있습니다.

브라우저가 이미 Deploy에 로그인돼 있으면 구글을 다시 거치지 않고 “연결” 버튼만 누르면 됩니다. 아이디/비밀번호 계정은 먼저 로그인한 뒤 주소를 엽니다.

로그인한 뒤 쓰는 방법은 사용 설명서에 있습니다. 다시 로그인해야 하는 때와 연결된 편집기를 해제하는 방법도 거기에서 봅니다.

내가 시작하지 않은 로그인이라면 인증 코드를 누구에게도 알려 주지 마세요. 채팅 앱(Claude · ChatGPT)은 명령을 실행할 수 없으므로 브라우저에서 로그인합니다.

접속 토큰으로 연결하기

로그인 창을 띄울 수 없는 곳이나 여러 기기에서 같은 계정을 쓸 때 씁니다. MCP 설정에 12자 토큰을 헤더로 넣으면 도구가 내 계정으로 바로 일합니다.

1. Deploy에 로그인하고 프로필의 접속 토큰에서 이름과 사용 기간(7 · 30 · 90일)을 골라 토큰 생성을 누릅니다.
2. 나온 값(XXXX-XXXX-XXXX)을 복사합니다. 값은 이때 한 번만 보입니다.
3. 아래처럼 MCP 설정의 Authorization 헤더에 넣고 편집기를 다시 시작합니다.

Claude Code

$ claude mcp add --transport http --scope user gensapps https://deploy.gensapps.com/mcp \
    --header "Authorization: Bearer XXXX-XXXX-XXXX"

Cursor · VS Code

{
  "mcpServers": {
    "gensapps": {
      "url": "https://deploy.gensapps.com/mcp",
      "headers": { "Authorization": "Bearer XXXX-XXXX-XXXX" }
    }
  }
}

Codex

[mcp_servers.gensapps]
url = "https://deploy.gensapps.com/mcp"
http_headers = { "Authorization" = "Bearer XXXX-XXXX-XXXX" }

ChatGPT · Claude 채팅 앱은 헤더를 넣을 수 없습니다. 그곳은 로그인 없이 쓰고, 계정 연결(OAuth)은 준비 중입니다.

토큰은 비밀번호처럼 다룹니다. 대화창에 붙이지 말고, 쓰지 않으면 프로필에서 폐기합니다. 만료되면 새로 만들어 바꿔 넣습니다.

배포해 보기

연결됐는지 가장 빨리 확인하는 방법입니다.

1. “이거 배포해줘” 또는 “젠스앱스로 올려줘”라고 말합니다.
2. AI가 올리고 주소를 알려 줍니다. 그 주소를 그대로 보내면 됩니다.
3. 올린 사이트는 내 사이트에서 봅니다.