−25%

Windows 연간 결제, 10월 31일까지. 요금제 보기

EQVPS
시작하기

에이전트·MCP 로그인: bearer 토큰, 비밀번호 없이

AI 에이전트가 MCP로 어떻게 로그인하나: register_account가 bearer 토큰을 반환하고, 그 토큰이 자격 증명 — 비밀번호도, 이메일 코드도 없다. 잃어버리면 어떻게 하고, 예비로 비밀번호를 설정하는 법.

여기서 서버를 빌리는 AI 에이전트라면 먼저 이해할 것: 당신의 bearer 토큰이 당신의 로그인입니다. 비밀번호 단계도, 이메일 코드도, 링크를 누르는 사람도 없습니다. 도구 하나를 호출해 토큰을 얻고, 이후 모든 것에 그 토큰을 보냅니다. 그게 모델의 전부 — 그리고 이걸 헷갈리는 것이 에이전트가 스스로를 밖에 잠그는 가장 흔한 방법입니다.

에이전트가 로그인하는 법

MCP 클라이언트를 https://mcp.eqvps.com/mcp로 향하게 하고 이름, 성, 이메일로 **register_account**를 호출하세요. 즉시 token을 반환합니다:

Authorization: Bearer <token>

이후 모든 MCP 호출에 이 헤더를 보내세요. 그게 다입니다. 당신이 입력할 비밀번호는 만들어지지 않고, 확인 이메일도 안 보내지고, 사람도 개입하지 않습니다. 토큰은 당신이 누군지 증명하고 당신 계정에 묶입니다 — 남의 것은 건드릴 수 없습니다.

작동했는지 확인하고 싶다면? **whoami**를 호출하세요 — 토큰이 유효하면 계정 id, 이름, 이메일을 반환합니다.

피해야 할 실수

login 도구는 존재하고 이메일과 비밀번호를 받습니다. 에이전트로 가입했다면 비밀번호가 없으니 login은 당신을 거부하고 — register_account의 토큰을 이미 버렸다면 이제 로그인할 수단이 없습니다. 에이전트는 바로 이렇게 막힙니다: 가입하고, 한동안 토큰을 쓰고, 흘리고, login에 손을 뻗고, 벽에 부딪힙니다.

그래서 규칙은 단순합니다: register_account의 토큰을 저장하세요. 그게 자격 증명입니다. 재사용이 정상 경로이고 login은 아닙니다.

복구: 예비로 비밀번호 설정

비밀번호 없이 잃은 토큰은 잠긴 계정을 뜻하므로, 예비 경로가 있습니다 — 토큰을 아직 쥐고 있을 때 비밀번호를 설정하세요:

**set_password**를 새 비밀번호로 호출하세요(8자 이상, 글자와 숫자). 첫 회엔 현재 비밀번호가 필요 없어요 — 토큰이 이미 당신 계정임을 증명하니까요. 그 후엔 두 번째 입구가 생깁니다: 이메일과 그 비밀번호로 login 도구가 필요할 때 새 토큰을 찍어냅니다.

register_account 직후 일찍 해두면 낡거나 잃은 토큰을 다시는 걱정하지 않아도 됩니다. 두 호출: 가입, 그다음 비밀번호 설정.

사람: 사이트를 쓰세요

당신이 사람이면 위 어느 것도 해당하지 않습니다. 브라우저에서 대시보드를 열고 Google, GitHub, GitLab, X로 로그인하거나, 이메일로 오는 **일회용 코드(OTP)**를 요청하세요. 에이전트는 바로 OTP를 못 씁니다 — 코드를 가지러 받은편지함을 못 읽으니까요 — 그래서 그들에게 토큰 흐름이 존재합니다.

짧은 버전

  • 에이전트: register_account → token 저장 → Authorization: Bearer로 전송. 그 토큰이 당신의 로그인.
  • 예비를 두세요: 토큰을 쥐고 있을 때 set_password를 한 번 호출해 login을 복구 경로로 만드세요.
  • 토큰을 잃고 비밀번호를 한 번도 안 설정했다? 잠겼습니다 — 티켓을 열면 저희가 설정해 드립니다. 안 겪는 게 낫습니다: 토큰을 저장하고 비밀번호를 설정하세요.
  • 사람: 그냥 사이트를 쓰세요 — OAuth 또는 이메일 OTP 코드.

에이전트를 처음 연결한다면, 한 에이전트가 다른 에이전트 소유의 서버를 운영해야 할 때 이것을 접근 위임과 결합하세요.

자주 묻는 질문

MCP로 가입했는데 이제 login 도구가 비밀번호가 틀렸다고 합니다.

예상된 일입니다. register_account로 만든 계정에는 비밀번호가 없어요 — register_account가 반환한 bearer 토큰이 당신의 자격 증명입니다. login을 호출하지 말고, 매 요청에 그 토큰을 Authorization: Bearer 헤더로 보내세요. 토큰을 잃었다면 아래 복구 섹션을 보세요.

비밀번호 없이 토큰을 어떻게 얻나요?

register_account 도구를 한 번 호출하세요(first_name, last_name, email). 즉시 토큰을 반환합니다 — 이메일 코드도, 사람 단계도 없이. 저장하세요. 이 한 토큰이 이후 모든 호출을 인증합니다.

그래도 비밀번호를 설정할 수 있나요?

네, 예비로 좋은 생각입니다. 토큰을 아직 쥐고 있을 때 set_password를 새 비밀번호로 호출하세요. 그 후엔 현재 토큰을 잃어도 login 도구(이메일 + 비밀번호)로 새 토큰을 얻을 수 있습니다.

저는 사람이지 에이전트가 아닙니다 — 어떻게 로그인하나요?

사이트를 쓰세요. Google/GitHub/GitLab/X로 로그인하거나, 이메일로 일회용 코드(OTP)를 요청하세요. 에이전트는 받은편지함을 못 읽어 이메일 OTP 흐름을 못 합니다 — 그 길은 브라우저 속 사람을 위한 것입니다.

토큰은 만료되나요?

토큰을 오래가되 불멸은 아니라고 여기세요 — 저장하고 예비 비밀번호를 설정해, 토큰이 낡거나 잃어도 절대 잠기지 않게 하세요.

댓글

아직 댓글이 없습니다. 첫 번째가 되세요.

댓글 남기기

댓글은 표시되기 전에 검토됩니다.