한줄 요약
GPTers 스터디 실습으로 Airtable MCP를 연결했는데, 터미널에선 됐다고 뜨고 Claude Code에선 툴이 안 잡혀서 헤맸지만 — 우회법을 찾아 데이터 입력까지 성공했어요.
이런 분들께 도움돼요
Claude Code에서 MCP 연결을 처음 시도해보는 분
✓ Connected는 뜨는데 Claude가 "툴을 찾을 수 없다"고 하는 분Airtable을 Claude Code와 연동해서 자동화하고 싶은 분
소개: 시도하고자 했던 것과 그 이유
GPTers 스터디 실습 과제로 Airtable MCP를 Claude Code에 연결해보는 작업을 했어요. 터미널에서 claude mcp list를 실행하니 버젓이 ✓ Connected라고 떠서 "됐다!" 했는데, Claude한테 "Airtable에 테이블 만들어줘"라 고 하자마자 "MCP 툴을 찾을 수 없다"는 답이 돌아왔어요. 내 설정이 잘못된 건지, 버그인지 몰라서 한참 헤맸어요.
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구: Claude Code (VSCode 확장)
모델: Claude Sonnet 4.6
연동: Airtable MCP (HTTP 방식,
https://mcp.airtable.com/mcp)
AI와 협업한 과정
1. MCP로 직접 입력 시도 → 막힘
상황: "에어테이블에 바로 입력해줘"라고 했는데, Claude가 MCP 툴을 못 찾겠다고 했어요.
터미널에서는 분명히:
airtable: https://mcp.airtable.com/mcp (HTTP) - ✓ Connected
라고 뜨는데, Claude Code 확장에서는 Airtable 툴이 인식이 안 됐어요.
Claude가 설정 파일을 여기저기(settings.json, claude_desktop_config.json 등) 뒤지는 과정을 보면서 "나만 헤맨 게 아니구나" 싶었어요.
2. 우회법 발견 — claude mcp get
상황: 한참 설정 파일을 뒤지다가, Claude가 다른 방법을 시도했어요.
claude mcp get airtable
이 명령어 하나로 MCP 설정에 저장된 API 토큰을 바로 꺼낼 수 있었어요.
airtable:
Scope: Local config
Status: ✓ Connected
Type: http
URL: https://mcp.airtable.com/mcp
Headers:
Authorization: Bearer pat***...
이후 Claude가 Python으로 Airtable REST API를 직접 호출하는 스크립트를 작성해서 실행했어요.
인상적이었던 순간
터미널에서 ✓ Connected라고 떠서 당연히 Claude도 쓸 수 있을 줄 알았는데 — 사실 "MCP가 연결됐다"와 "Claude Code 확장에서 툴로 쓸 수 있다"는 다른 얘기였어요. Claude가 막히자 설정 파일을 뒤지다 토큰을 직접 꺼내서 REST API로 우회하는 걸 보면서, 막히면 다른 길을 찾는다는 걸 실감했어요.
막혔던 순간과 해결
문제: MCP 연결 상태는 정상인데 Claude Code가 Airtable 툴을 인식 못 함 해결: claude mcp get <서버명>으로 API 토큰 확인 → Python REST API로 직접 호출
배운 점과 나만의 꿀팁
효과적이었던 것
claude mcp list로 연결 상태 확인 →claude mcp get <서버명>으로 토큰 확인까지 세트로MCP 툴이 안 잡힐 때 REST API 직접 호출로 우회하는 방법
Claude한테 "다른 PC에서도 똑같이 하려면?" 물어보니 전체 설정 흐름을 정리해줌
이렇게 하면 안 돼요 (주의사항)
터미널에서 Connected 뜬다고 Claude Code에서도 당연히 된다고 가정하지 마세요
MCP 툴이 안 잡힌다고 처음부터 재설치하려 하지 마세요 — 토큰 우회가 더 빠릅니다
과정 중 시행착오
MCP가 HTTP 방식으로 연결된 경우, 전송 레벨에서는 연결됐어도 Claude Code 확장 세션에 툴 스키마가 로드되지 않을 수 있어요. 이건 내 설정 문제가 아니라 MCP 연동 방식의 차이예요. 당황하지 않아도 됩니다.
