JSON이란? 바이브코딩에서 자주 만나는 데이터 형식

구글 서비스를 연결하는 수업에서 이런 안내를 했습니다.

다운로드한 서비스 계정 JSON 파일을 열고 client_email 값을 복사해서 입력하세요.

JSON을 처음 본 수강생은 다음 글자를 그대로 복사했습니다.

client_email

실제로 복사해야 했던 것은 오른쪽에 있는 이메일 주소였어요. 민감한 값은 지우고 서비스 계정 파일의 일부만 남기면 다음과 비슷한 모습입니다.

{
  "type": "service_account",
  "project_id": "sample-project",
  "client_email": "automation@sample-project.iam.gserviceaccount.com"
}

실제 서비스 계정 파일에는 민감한 인증 정보도 함께 들어 있으므로 파일 전체를 채팅이나 GitHub에 공유하지 마세요.

인증값을 코드와 GitHub에서 분리하는 방법은 API 키와 .env에서 이어서 볼 수 있습니다.

여기서 client_email이 어디까지를 가리키는지 나눠볼게요.

"client_email": "automation@sample-project.iam.gserviceaccount.com"
       키                            값

• "client_email"은 이 값이 무엇인지 알려주는 키입니다.
• :은 키와 값을 나누는 기호입니다.
• "automation@sample-project.iam.gserviceaccount.com"이 실제 값입니다.

따라서 “client_email 값을 복사하세요”라는 안내에서는 client_email이라는 이름표가 붙은 오른쪽 값을 복사합니다.

JSON을 처음 보면 왼쪽과 오른쪽이 모두 비슷한 글자로 보입니다. client_email이라는 영어가 더 중요한 값처럼 느껴질 수도 있어요. 이 구조를 이해하면 구글 서비스 계정, 클로드코드의 launch.json과 .mcp.json, API 응답을 훨씬 쉽게 읽을 수 있습니다.

JSON은 프로그램이 함께 읽는 데이터 형식이에요

JSON은 ‘제이슨’이라고 읽습니다. 정식 이름은 JavaScript Object Notation입니다. 여러 프로그래밍 언어에서 이 형식을 사용해요.

JSON 표준 문서 (새 탭에서 열림)는 JSON을 가볍고 언어에 독립적인 데이터 교환 형식으로 정의합니다. JavaScript, Python, Java, PHP 등 대부분의 프로그래밍 언어가 JSON을 읽고 만들 수 있어요.

JSON은 이름, 이메일, 실행 명령처럼 서로 다른 값을 일정한 구조로 묶습니다.

{
  "name": "김민지",
  "headcount": 2,
  "isPaid": true
}

각 항목을 신청서처럼 읽으면 이해하기 쉽습니다.

프로그램은 name이라는 이름표를 찾아 오른쪽의 "김민지"를 읽습니다. headcount를 찾으면 숫자 2를 사용하고, isPaid를 찾으면 true인지 확인해요.

바이브코딩에서는 어떤 프로그램이 이 데이터를 읽는지, 필요한 키가 무엇인지, 오른쪽 값이 무엇인지 확인하세요.

중괄호 안에 키와 값을 짝지어 적어요

JSON에서 각 기호는 다음 역할을 맡습니다.

목록을 표현할 때는 대괄호를 사용합니다.

{
  "runtimeArgs": ["run", "dev"]
}

관련된 정보를 한 번 더 묶을 수도 있어요.

{
  "contact": {
    "email": "minji@example.com",
    "phone": "01012345678"
  }
}

객체 안에 다른 객체나 배열을 넣어 복잡한 설정과 데이터도 표현할 수 있습니다.

JSON에는 여섯 종류의 값이 들어갈 수 있어요

날짜처럼 보이는 "2026-08-24"도 JSON에서는 문자열입니다. JSON에는 날짜 전용 타입이 없으므로 프로그램이 이 문자열을 날짜로 해석하는 규칙을 따로 정해야 해요.

전화번호는 문자열로 표현하는 편이 자연스럽습니다. 문자열은 맨 앞의 0을 그대로 보존합니다. 값의 종류는 용도에 따라 정합니다. 자세한 내용은 데이터 타입이 중요한 이유에서 볼 수 있습니다.

클로드코드를 쓰다가 JSON 파일을 만나기도 해요

클로드코드를 사용하는 수강생은 launch.json이나 .mcp.json 같은 설정 파일에서 JSON을 자주 만납니다. AI가 파일을 열거나 값을 바꾸려 할 때 왼쪽은 설정의 이름이고 오른쪽은 실제 값이라는 구조를 읽으면 됩니다.

.mcp.json에 등장하는 MCP의 역할은 MCP가 뭐예요?에서 확인할 수 있습니다.

예를 들어 다음처럼 안내받았다면 파일에서 해당 키를 찾고 오른쪽 값을 확인해요.

port 값을 확인해 주세요.
url 값을 바꿔 주세요.

파일마다 키의 뜻과 허용되는 값은 다릅니다. JSON은 정보를 적는 공통 형식이고, 각 키를 어떻게 사용할지는 그 파일을 읽는 프로그램이 정해요. 낯선 설정을 만나면 AI에게 “이 키가 무엇을 정하고 현재 값이 무엇인지” 설명해달라고 하세요.

API 요청과 응답에서도 JSON을 만나요

웹사이트의 화면과 서버는 데이터를 계속 주고받습니다. 예약자가 신청 버튼을 누르면 화면은 서버에 이런 정보를 보낼 수 있어요.

{
  "programId": "program_01",
  "name": "김민지",
  "headcount": 2
}

서버가 예약을 저장한 뒤에는 다음 결과를 돌려줄 수 있습니다.

{
  "orderId": "order_1234",
  "status": "confirmed"
}

보내는 쪽과 받는 쪽이 같은 키와 데이터 종류를 약속하면 서로 다른 프로그램도 정보를 해석할 수 있습니다.

프로그램이 다른 프로그램의 기능이나 데이터를 사용하도록 만든 연결 규칙을 API라고 해요. API는 요청과 결과를 표현할 때 JSON을 자주 사용합니다. API와 MCP의 역할 비교도 함께 읽어보세요.

구글 스프레드시트 업무를 웹앱으로 연결하는 과정에서도 API와 JSON을 만납니다. 구체적인 흐름은 구글 스프레드시트 업무를 웹앱으로 자동화하는 순서에서 확인할 수 있습니다.

값을 복사하라는 안내를 받으면 이렇게 읽으세요

바이브코딩을 하다 보면 “JSON 파일에서 특정 값을 복사하세요”라는 안내를 자주 만납니다. 이때는 다음 순서로 보면 됩니다.

1. 안내받은 키를 찾습니다.
2. 키 오른쪽의 콜론(:)을 찾습니다.
3. 콜론 오른쪽에서 그 키에 대응하는 값을 확인합니다.
4. 일반 입력 칸에는 보통 따옴표 안쪽 내용만 복사합니다.

예를 들어 다음 JSON에서 client_email 값을 입력 칸에 붙여 넣으라는 안내를 받았다면,

{
  "client_email": "automation@sample-project.iam.gserviceaccount.com"
}

복사할 내용은 다음과 같습니다.

automation@sample-project.iam.gserviceaccount.com

어느 부분이 키이고 값인지 헷갈린다면 AI에게 구조를 설명해달라고 요청해도 좋아요.

이 JSON에서 client_email 키와 그 키에 대응하는 값을 각각 표시해줘. 입력 칸에 복사할 부분도 따로 알려줘.

정리

• JSON은 프로그램끼리 구조화된 데이터를 주고받는 텍스트 형식입니다.
• 콜론 왼쪽은 값의 이름인 키이고 오른쪽이 실제 값입니다.
• 클로드코드에서는 launch.json과 .mcp.json 같은 설정 파일을 통해 JSON 구조를 자주 만납니다.
• JSON은 프로그램 설정, API 통신, 데이터 저장과 자동화 도구 연결에 널리 사용됩니다.
• 서비스 계정 파일처럼 민감한 정보가 든 JSON은 파일 전체를 공유하지 않아야 합니다.

JSON을 만나면 필요한 키를 찾고, 오른쪽 값을 읽고, 이 파일을 사용하는 프로그램을 확인하세요. 이 세 가지를 익히면 엉뚱한 값을 복사하는 일을 크게 줄일 수 있어요.