MCP로 AI 도구 연결하기

Claude Code, claude.ai를 비롯한 MCP 클라이언트에서 본인의 AI 구독을 사용해 Kliv 작업 공간에서 앱을 만들 수 있습니다. Kliv 안의 채팅을 거치지 않고 AI 도구가 앱을 직접 작업합니다. MCP 액세스는 Pro, Max 5x, Max 20x 요금제에 포함되어 있습니다.

주소 확인하기

MCP 주소는 작업 공간마다 다릅니다. 작업 공간 관리 화면에서 Integrations → MCP를 열고 주소를 복사하세요.

Claude Code 연결하기

다음 명령어를 실행하세요. <your address>는 복사한 주소로 바꿉니다.

claude mcp add --transport http kliv <your address>

그다음 순서대로 진행합니다.

  1. Claude Code에서 /mcp를 실행하고 kliv를 선택합니다.
  2. 열린 브라우저 창에서 Kliv에 로그인합니다.
  3. Allow를 클릭해 Claude Code가 작업 공간에 접근하도록 허용합니다.

브라우저가 콜백 주소에 연결되지 않으면 주소 표시줄의 URL을 복사해, Claude Code에서 요청할 때 붙여 넣으세요.

claude.ai 또는 다른 MCP 앱 연결하기

OAuth 기반 원격 MCP 서버를 지원하는 앱이라면 모두 같은 주소로 연결할 수 있습니다. claude.ai에서는 Settings → Connectors를 열고 Add custom connector를 선택한 다음 주소를 붙여 넣으세요. 다른 앱에서는 이 주소로 원격(HTTP) MCP 서버를 추가하세요.

앱은 처음 연결할 때 Kliv에 자동으로 등록됩니다. 로그인할 때 Kliv가 앱 이름과 로그인 후 돌아갈 주소를 보여 줍니다. Allow를 클릭하기 전에 두 가지를 모두 확인하세요.

Kliv는 안전한(https) 주소나 본인 컴퓨터에 있는 앱으로 돌려보내는 앱만 허용합니다. cursor://처럼 자체 링크 형식을 사용하는 앱은 지원되지 않습니다.

할 수 있는 일

AI 도구는 본인 작업 공간의 앱에 대해 Kliv 빌더와 같은 도구를 사용할 수 있습니다.

  • 파일
  • 데이터베이스
  • 함수
  • 커머스
  • 테스트
  • 게시

새 앱을 만들거나 도메인을 연결하는 일은 할 수 없습니다. 이 작업은 Kliv에서 진행하세요.

앱 액세스 제거하기

작업 공간 관리자는 Integrations → MCP의 연결된 앱에서 연결된 모든 앱을 확인할 수 있으며, 앱을 연결한 사용자와 마지막 사용 시각도 함께 표시됩니다. 접근 권한 삭제를 선택하면 앱의 액세스가 즉시 차단됩니다. 앱을 다시 사용하려면 해당 사용자가 다시 로그인해 Allow를 클릭해야 합니다.

제한 사항

  • 빌드, 테스트 실행, 브라우저 세션은 사용량 한도에 포함됩니다. 자세한 내용은 사용량 이해를 참고하세요.
  • 비밀번호를 변경하면 MCP 클라이언트가 로그아웃됩니다. /mcp로 다시 로그인하세요.

문제 해결

표시되는 내용 의미
MCP 액세스가 켜져 있지 않다는 페이지 현재 요금제에 MCP 액세스가 포함되어 있지 않습니다.
다른 작업 공간에 로그인되어 있다는 메시지 연결하려는 작업 공간의 Integrations → MCP 페이지에 있는, 해당 작업 공간 전용 MCP 주소를 사용하세요.
다시 로그인하라는 메시지 세션이 만료되었습니다. Claude Code에서 /mcp를 실행하거나 앱을 다시 연결한 뒤 다시 로그인하세요.
"Invalid redirect_uri" 앱이 Kliv에서 허용하지 않는 주소로 돌려보내려고 합니다. Kliv는 https 주소와 본인 컴퓨터에 있는 앱만 허용합니다. cursor:// 같은 링크는 지원되지 않습니다.
앱을 등록할 수 없다는 메시지 최근에 등록된 앱이 너무 많습니다. 나중에 다시 시도하세요. 최대 하루가 걸릴 수 있습니다.

관련 문서