MCP Academy · 강의

Bearer 토큰과 헤더

요청마다 액세스 토큰을 요구하고 읽습니다.

레슨 2/413개 단계

Bearer 토큰과 헤더은(는) CoddyKit의 무료 MCP Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 MCP Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Bearer 토큰이란?

Bearer 토큰은 "이것을 가진 사람은 누구든 들어올 수 있다"는 의미의 비밀 문자열입니다. 호출할 때마다 비밀번호를 입력하지 않아도 소유자를 신뢰합니다. 🎟️

Authorization 헤더

클라이언트는 HTTP Authorization 헤더에 토큰을 담아 보내므로 모든 요청에 자동으로 함께 전송됩니다.

Bearer 접두사

헤더 값은 Bearer라는 단어, 공백, 토큰 순서로 시작합니다. 이 접두사는 어떤 인증 방식을 사용하는지 서버에 알려 줍니다.

GET /mcp HTTP/1.1
Authorization: Bearer sk-7f3a9c2e8b1d4a6f

서버에서 헤더 읽기

MCP 서버는 JSON-RPC 본문을 처리하기 전에 들어오는 요청에서 Authorization 값을 가져옵니다.

auth = request.headers.get("Authorization", "")
token = auth.removeprefix("Bearer ").strip()

비교한 다음 결정하기

서버는 토큰이 예상한 값과 일치하는지 확인합니다. 일치하면 요청을 통과시키고, 그 외의 경우에는 거부합니다.

if token != EXPECTED_TOKEN:
    raise HTTPException(status_code=401)

일정한 시간의 비교 사용하기

일반적인 같음 비교는 실행 시간의 차이를 유출할 수 있습니다. 공격자가 토큰을 문자 하나씩 추측하지 못하도록 일정 시간 비교를 사용하세요.

import hmac
ok = hmac.compare_digest(token, EXPECTED_TOKEN)

401은 인증되지 않았다는 뜻입니다

토큰이 없거나 유효하지 않으면 401 Unauthorized를 반환합니다. 이는 호출자에게 유효한 자격 증명을 제공하라고 알리는 신호입니다.

403은 허용되지 않았다는 뜻입니다

호출자를 알고 있지만 해당 작업에 대한 권한이 없을 때는 403 Forbidden을 사용합니다. 401과는 다른 응답입니다.

URL에 토큰을 넣지 마세요

쿼리 문자열에 토큰을 절대 넣지 마세요. URL은 로그와 브라우저 기록에 남으므로 헤더가 비밀 값을 보관하기에 더 안전합니다.

환경 변수에 비밀 값 저장하기

예상 토큰은 환경 변수에서 읽고 소스에 직접 작성하지 마세요. 그러면 토큰이 버전 관리 시스템에 들어가는 것을 막을 수 있습니다.

import os
EXPECTED_TOKEN = os.environ["MCP_TOKEN"]

의심되면 교체하기

토큰이 노출되었을 가능성이 있다면 새 토큰을 발급하고 기존 토큰을 폐기하세요. 교체를 통해 유출된 비밀 값이 유효한 기간을 줄일 수 있습니다.

빠른 확인

올바른 헤더 형식을 찾아보세요.

복습: 헤더 하나, 확인 하나

Authorization 헤더에 비밀 값을 Bearer 형식으로 보내고, 안전하게 비교한 다음, 일치하지 않으면 401로 응답하세요. 간단하면서도 확실한 방법입니다. ✅

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
30
레슨
120

자주 묻는 질문

“Bearer 토큰과 헤더” 강의는 무료인가요?

네 — “Bearer 토큰과 헤더” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 MCP Academy 강의 전체를 잠금 해제할 수 있습니다. MCP Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“Bearer 토큰과 헤더”에서 뭘 배우나요?

요청마다 액세스 토큰을 요구하고 읽습니다. 브라우저에서 직접 실행하는 실습 코드로 MCP Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

MCP Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 MCP Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“Bearer 토큰과 헤더” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 MCP Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 MCP Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 원격 서버에 인증이 필요한 이유
  2. Bearer 토큰과 헤더
  3. MCP의 OAuth 흐름
  4. 토큰의 권한 범위 설정하기
← MCP Academy(으)로 돌아가기