목차

AI 클라이언트 연결

모든 클라이언트는 같은 방식으로 연결합니다. 서버 URL을 추가한 다음, 클라이언트가 여는 브라우저 창에서 LetKite에 로그인합니다. 복사할 API 키는 없습니다.

서버 URL:

https://mcp.letkite.com/mcp

시작하기 전에 기기가 하나 이상 연결된 LetKite 계정이 필요합니다. 두 가지 모두 콘솔(https://dashboard.letkite.com)에서 확인할 수 있습니다.

로그인할 때 일어나는 일

  1. 클라이언트가 서버 URL에서 LetKite의 로그인 서버를 스스로 찾아 클라이언트로 등록합니다(로그인과 접근 권한 참고).
  2. LetKite 페이지가 열립니다. 로그인하고, 여러 LetKite 계정에 속해 있다면 계정을 선택한 다음, 클라이언트가 할 수 있는 일을 선택합니다: 스코프, 접근할 수 있는 기기, 클라이언트를 제한하는 정책.
  3. 승인하면 클라이언트는 이 연결에만 쓰이는 토큰을 받습니다. 콘솔의 연결에 이 연결이 표시되며, 언제든지 여기서 연결을 해지할 수 있습니다.

Claude (웹과 데스크톱)

  1. Claude에서 Settings → Connectors → Add custom connector를 엽니다.
  2. 이름을 LetKite로 정하고 서버 URL을 붙여 넣습니다. 고급 OAuth 항목은 비워 둡니다. Claude가 스스로 등록합니다.
  3. Connect를 선택하고, 열리는 창에서 LetKite에 로그인합니다.
  4. 대화에서 도구 메뉴의 LetKite를 켭니다. 해당 대화에서 허용하지 않는 한, Claude는 도구를 호출할 때마다 먼저 확인을 요청합니다.

Team 및 Enterprise 요금제에서는 조직 소유자가 먼저 커넥터를 추가해야 할 수 있습니다.

Claude Code

claude mcp add --transport http letkite https://mcp.letkite.com/mcp

그런 다음 Claude Code에서 /mcp를 실행하고 letkite를 선택한 뒤 Authenticate를 선택합니다. 브라우저에서 LetKite 로그인 페이지가 열립니다. 모든 프로젝트에서 사용하려면 --scope user를 추가합니다.

ChatGPT

  1. 개발자 모드를 켭니다: Settings → Apps & Connectors → Advanced settings → Developer mode.
  2. Apps & Connectors에서 Create를 선택하고, 이름을 LetKite로 정한 뒤 서버 URL을 붙여 넣고 인증 방식으로 OAuth를 선택합니다.
  3. 열리는 창에서 LetKite에 로그인합니다. 채팅에서 개발자 모드 도구 중 LetKite를 선택합니다.

ChatGPT는 도구의 destructiveHint 주석에 따라, 변경을 일으키는 도구를 실행하기 전에 확인 창을 표시합니다.

Cursor

LetKite를 ~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(한 프로젝트)에 추가합니다:

{
  "mcpServers": {
    "letkite": { "url": "https://mcp.letkite.com/mcp" }
  }
}

Cursor Settings → MCP를 열면 LetKite에 Needs login이 표시됩니다. 이를 선택해 로그인합니다.

VS Code

GitHub Copilot의 에이전트 모드에서, 작업 영역의 .vscode/mcp.json에 LetKite를 추가하거나, 모든 작업 영역에 적용하려면 MCP: Open User Configuration을 실행합니다:

{
  "servers": {
    "letkite": { "type": "http", "url": "https://mcp.letkite.com/mcp" }
  }
}

또는 터미널에서:

code --add-mcp '{"name":"letkite","type":"http","url":"https://mcp.letkite.com/mcp"}'

파일에서 또는 MCP: List Servers 명령으로 서버를 시작합니다. VS Code가 로그인을 요청합니다.

Codex

codex mcp add letkite --url https://mcp.letkite.com/mcp
codex mcp login letkite

이 명령은 LetKite를 ~/.codex/config.toml에 추가합니다. 이 파일은 직접 편집할 수도 있습니다:

[mcp_servers.letkite]
url = "https://mcp.letkite.com/mcp"

Kimi Code

kimi mcp add --transport http letkite https://mcp.letkite.com/mcp

Kimi Code는 처음 LetKite를 사용할 때 브라우저에서 LetKite 로그인 페이지를 엽니다.

기타 클라이언트

Streamable HTTP를 지원하고, 동적 클라이언트 등록 또는 클라이언트 ID 메타데이터 문서를 사용하는 OAuth 2.1을 지원하는 MCP 클라이언트라면 서버 URL만으로 연결할 수 있습니다. 스스로 등록할 수 없는 클라이언트는 아직 지원하지 않습니다. contact@letkite.com으로 이메일을 보내 주십시오.

작동 확인

AI에게 이렇게 요청합니다: “내 LetKite 호스트 목록을 보여 줘.” AI가 list_hosts를 호출해 기기 목록을 보여 주어야 합니다. 기기가 하나도 표시되지 않으면 먼저 콘솔에서 기기를 연결하십시오. 호출이 거부되면 콘솔의 연결에서 연결의 정책을 확인하십시오.