> ## Documentation Index
> Fetch the complete documentation index at: https://docs-hub.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 계정과 클라이언트

> 계정, OAuth 클라이언트, 커넥터가 각각 무엇이고 왜 클라이언트는 하나로 충분한지. 말이 서로 섞여 헷갈리실 때 보세요.

허브에는 이름이 비슷한 것이 셋 있고, 그중 하나는 업계에서 두 가지 뜻으로
쓰입니다. 여기서 한 번 갈라두면 나머지 문서가 편해집니다.

## 계정은 구글 계정입니다

계정은 허브에 붙여 둔 구글 계정 하나입니다. 개인 Gmail, 회사 Workspace
주소, 도메인을 사면서 딸려온 것 같은 계정들입니다. 계정마다 짧은 이름을
붙이시는데, 그 이름이 나중에 Claude에게 "이 계정으로 해줘"라고 말할 때 쓰는
이름입니다.

계정은 관리 UI의 **계정** 화면에 있습니다. 여기에 넣기 전에는 아무 계정도
연결되지 않고, 여기서 빼면 연결이 끊깁니다.

## 클라이언트는 구글에서 받는 열쇠입니다

OAuth 클라이언트는 허브가 계정을 구글에 로그인시킬 때 쓰는 것입니다. 열쇠라고
생각하시면 됩니다. Google Cloud 콘솔에서 한 번 만드시면 구글이 두 값을
줍니다. **클라이언트 ID**와 **클라이언트 시크릿**, 이 둘이 열쇠입니다.

**이것은 Claude가 아닙니다.** 여기서 많이 헷갈리시는데, "클라이언트"라는 말이
원래 어딘가에 접속하는 프로그램을 뜻하기도 하기 때문입니다. 허브에서는 그
뜻이 아니라, 허브가 로그인할 때 쓰는 열쇠만 가리킵니다. 클라이언트라고 부르는
이유는 구글 콘솔이 그렇게 부르기 때문이고, 고객님도 거기서 그 말로 찾으셔야
합니다.

클라이언트는 관리 UI의 **클라이언트** 화면에 있고,
[만드는 일](/ko/oauth-client)은 10분짜리이며 한 번만 하시면 됩니다.

## 커넥터는 Claude나 ChatGPT입니다

커넥터는 반대쪽에 있는 프로그램입니다. Claude, ChatGPT, 그 밖에 MCP를 쓰는
무엇이든요. Claude도 자기 설정 화면에서 이것을 커넥터라고 부릅니다. 허브
주소를 거기에 한 번 넣어 두시면, 그 커넥터가 붙여 두신 계정 전부에 닿습니다.

허용하신 커넥터는 관리 UI의 **승인된 커넥터**에 모여 있고, 거기서 해지하실
수 있습니다.

## 셋이 어떻게 이어지는가

```mermaid theme={null}
flowchart LR
  C["Claude<br/>(커넥터)"] --> H["내 허브"]
  H --> K["클라이언트 하나<br/>(열쇠)"]
  K --> A1["계정: 개인"]
  K --> A2["계정: 업무"]
```

## 계정은 여럿, 클라이언트는 하나

열쇠는 계정에 딸린 것이 아닙니다. Google Cloud 프로젝트에 딸린 것이고, 그
열쇠로 로그인한 계정은 전부 열립니다. 그래서 하나 만들어 계속 씁니다. 클라이언트
ID와 시크릿을 붙여넣으시는 것은 **첫 계정을 추가하실 때 한 번뿐**입니다.
그다음부터는 허브가 이미 갖고 있어서, 계정을 붙이는 일은 이름을 정하고,
목록에서 고르고, 쓸 서비스를 고르는 것으로 끝납니다.

두 번째가 필요하신 분은 거의 없습니다. 예외는 Workspace 조직이 미검증 앱을
차단하는 경우, 또는 조직 구성원에게 미검증 경고를 보이고 싶지 않은 경우입니다.
그때는 그 조직이 소유한 프로젝트에 클라이언트를 하나 더 두게 되고,
[프로젝트는 몇 개 필요한가](/ko/oauth-client#프로젝트는-몇-개-필요한가)에
적어두었습니다.

계정을 옮기려고 클라이언트를 하나 더 만드는 것이 아닙니다. 계정이 잘못된
클라이언트에 붙었다면 그건
[따로 바로잡는 일](/ko/fixing-the-wrong-client)입니다.

## 다음

* [설치하기](/ko/quickstart), 처음부터 끝까지
* [OAuth 클라이언트 만들기](/ko/oauth-client)