상세 컨텐츠

본문 제목

JSON이란 — 이름표 붙은 정리함으로 이해하기

서버·개발/코드 노트

by 사이 (SAI) 2026. 7. 20. 14:44

본문

728x90
반응형

AI 도구를 만지다 보면 화면에 중괄호로 뒤덮인 이상한 코드가 튀어나올 때가 있습니다.

API 응답, mcp.json 같은 설정 파일, n8n 자동화 화면에서 자주 보이는 그 { } 덩어리가 바로 JSON입니다.

2026년 7월 기준, JSON은 데이터를 '이름:값' 형태로 정리해 사람도 기계도 읽기 쉽게 만든 형식입니다.

이 글을 읽으면 JSON이 왜 어디에나 있는지, 그리고 AI를 쓰는 것과 무슨 상관인지 이해하게 됩니다.

이름표가 붙은 정리함 서랍마다 데이터가 담긴 모습

JSON은 '이름표가 붙은 정리함'입니다. 어떤 값이든 이름표(키)를 달아 정리해두기 때문에, 사람이 봐도 무슨 데이터인지 바로 알 수 있습니다.

JSON이란 무엇인가

JSON은 데이터를 주고받을 때 쓰는 약속된 표기 형식입니다.

이름은 JavaScript Object Notation의 줄임말이지만, 지금은 특정 언어와 상관없이 어디서나 쓰입니다.

핵심은 '키:값' 구조입니다.

물건마다 이름표를 붙여 서랍에 넣는다고 생각하면 쉽습니다.

예를 들어 이름표에 "이름"이라 적고 그 안에 "홍길동"을 넣는 식입니다.

그래서 값만 죽 나열된 데이터보다 훨씬 알아보기 쉽습니다.

JSON은 어떻게 생겼나

실제 JSON은 이렇게 생겼습니다.

{
  "이름": "홍길동",
  "나이": 20,
  "취미": ["독서", "코딩"],
  "학생여부": true
}

중괄호 { } 안에 '키:값'을 쉼표로 나열합니다.

키(이름표)는 항상 큰따옴표로 감쌉니다.

값에는 글자, 숫자, 참/거짓, 그리고 여러 개를 담는 목록이 들어갈 수 있습니다.

대괄호 [ ]는 목록(배열)이라, 위 예시의 취미처럼 값을 여러 개 담습니다.

상자 안에 또 상자를 넣듯, 값 자리에 다시 '키:값' 묶음을 넣을 수도 있습니다.

규칙은 이 몇 가지가 거의 전부라, 처음 봐도 금방 눈에 익습니다.

값 자리에 넣을 수 있는 종류를 정리하면 이렇습니다.

종류 예시
글자(문자열) "홍길동" (큰따옴표로 감쌈)
숫자 20 (따옴표 없이)
참/거짓 true, false
목록(배열) ["독서", "코딩"]
또 다른 상자(객체) { "키": "값" }

코드 에디터 화면에 키와 값이 색으로 구분된 JSON 예시가 떠 있는 모습

왜 이렇게 널리 쓰일까

JSON이 사실상 표준이 된 이유는 두 가지입니다.

첫째, 사람이 읽어도 무슨 뜻인지 바로 이해됩니다.

이름표가 붙어 있으니 "나이"가 20이라는 걸 설명 없이 알 수 있습니다.

둘째, 기계도 정확하게 읽습니다.

규칙이 단순하고 명확해서 프로그램이 오해 없이 값을 꺼내 씁니다.

게다가 특정 언어에 묶여 있지도 않습니다.

파이썬으로 만든 프로그램과 자바스크립트로 만든 프로그램이 JSON으로 데이터를 주고받을 수 있습니다.

서로 다른 프로그램 사이의 '공용어' 역할을 하는 셈입니다.

AI랑 무슨 상관일까

AI 도구를 쓰다 보면 JSON은 피할 수 없이 마주칩니다.

AI 서비스에 요청을 보내고 받는 API 응답이 대부분 JSON 형태입니다.

MCP처럼 AI에 외부 도구를 연결하는 설정도 mcp.json 파일에 JSON으로 적습니다.

n8n 같은 자동화 도구에서 단계 사이를 오가는 데이터도 JSON입니다.

개인적으로는, AI를 조금이라도 깊게 다루기 시작하면 JSON은 안 볼 수가 없는 형식이라고 봅니다.

반대로 말하면, JSON 구조 하나만 익혀둬도 API 문서든 설정 파일이든 훨씬 덜 낯설어집니다.

API·설정 파일·자동화 도구가 모두 JSON이라는 하나의 형식으로 연결되는 모습

결론

JSON은 '이름표 붙은 정리함'이라는 한 문장으로 정리됩니다.

값마다 이름을 붙여 정리하니 사람도 기계도 읽기 편합니다.

AI 도구의 응답, 설정, 자동화 데이터가 전부 이 형식이라, 한 번 익혀두면 오래 써먹습니다.

처음엔 중괄호가 낯설어도, 이름표 붙은 상자라고 생각하면 금방 익숙해집니다.

자주 묻는 질문

JSON은 그냥 텍스트랑 뭐가 다른가요?

JSON도 결국 글자로 된 텍스트가 맞습니다.

다만 '키:값' 규칙을 지켜 쓴 텍스트라, 프로그램이 어느 값이 무엇인지 정확히 구분해 꺼낼 수 있습니다.

그냥 줄글은 사람은 읽어도 기계가 값을 정확히 집어내기 어렵습니다.

JSON에서 자주 하는 실수가 있나요?

가장 흔한 실수는 쉼표와 따옴표입니다.

마지막 항목 뒤에 쉼표를 남기거나, 키를 큰따옴표로 감싸지 않으면 오류가 납니다.

온라인 JSON 검사기에 붙여넣으면 어디가 틀렸는지 바로 알려주니, 처음엔 이런 도구를 쓰는 걸 권합니다.

 

 

참고한 자료

MDN 웹 문서 한국어판(developer.mozilla.org/ko)의 JSON 소개, tcpschool.com의 JSON 설명, 그리고 초보자용 JSON 해설 자료를 참고했습니다. JSON의 세부 규격은 발행 전 공식 문서 확인이 필요합니다.

728x90
반응형

관련글 더보기

댓글 영역