MCP란 무엇인가

지난 편에서 바이브코딩의 구조적 문제와 Umtri가 어떤 역할을 하는지 알아봤습니다. 이번 편에서는 Umtri와 Claude Code를 실제로 연결하는 방법을 다룹니다.

연결에 사용하는 기술이 **MCP(Model Context Protocol)**입니다. 처음 들어보는 개념이어도 걱정하지 않아도 됩니다. 설정은 터미널에서 명령어 한 줄이면 끝납니다.

MCP는 AI가 외부 도구를 사용할 수 있게 해주는 표준 방식입니다. 2024년 말 Anthropic이 공개했으며, Claude Code뿐만 아니라 다양한 AI 도구에서 지원하고 있습니다.

쉽게 이해하려면 이렇게 생각하면 됩니다. AI와 대화할 때 AI는 기본적으로 대화 내용 안에서만 정보를 얻습니다. MCP를 연결하면 AI가 외부 서비스(데이터베이스, 협업 도구, 프로젝트 관리 앱 등)의 정보를 직접 가져오거나 작업을 수행할 수 있게 됩니다.

Umtri의 MCP를 연결하면 Claude Code가 Umtri에 있는 프로젝트 구조를 직접 읽고, 노드를 추가하거나 수정하는 작업을 자동으로 수행할 수 있습니다.

시작 전 준비: Umtri 계정과 토큰 발급

MCP를 연결하려면 먼저 Umtri 계정이 있어야 합니다.

1. Umtri 가입 및 로그인

app.umtri.io에서 계정을 만들고 로그인합니다.

2. 프로젝트(그라운드) 만들기

로그인 후 “New Ground” 버튼을 눌러 새 프로젝트를 만듭니다. 이름은 만들고 있는 프로젝트 이름으로 설정합니다. (예: bookmark-app)

3. MCP 토큰 발급

설정 페이지에서 MCP 연결에 사용할 API 토큰을 발급받습니다. 이 토큰은 Claude Code가 Umtri에 접근할 수 있는 열쇠입니다.

토큰은 한 번 발급하면 다시 볼 수 없으므로 안전한 곳에 복사해 둡니다.

터미널에서 아래 명령어를 실행합니다. YOUR_TOKEN 부분을 방금 발급받은 토큰으로 바꿉니다.

claude mcp add umtri \
  --transport http \
  --url https://app.umtri.io/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

명령어를 실행하면 Claude Code가 Umtri MCP 서버를 등록합니다. 이후 Claude Code를 실행할 때마다 이 연결이 자동으로 활성화됩니다.

연결 확인

Claude Code를 실행하고 아래와 같이 물어봐서 연결이 됐는지 확인합니다.

내 Umtri 프로젝트 목록 보여줘

연결이 정상이라면 Umtri에 만들어둔 프로젝트 목록이 나타납니다.

MCP 연결 후 Claude Code가 사용할 수 있는 주요 기능입니다.

명령	설명
`list_projects`	Umtri에 있는 프로젝트 목록 조회
`get_graph`	특정 프로젝트의 트리 구조 전체 조회
`create_node`	트리에 새 노드(trunk/limb/twig/leaf/vein) 추가
`update_node`	기존 노드 이름이나 위치 수정
`delete_node`	노드 삭제
`record_commit`	커밋 정보를 Umtri 타임라인에 기록
`create_bug`	버그 이슈를 Umtri에 등록
`list_bugs`	등록된 버그 목록 조회

MCP가 연결된 상태에서 Claude Code와 이렇게 대화할 수 있습니다.

현재 구조 파악

bookmark-app 그라운드의 트리 구조를 가져와서 현재 어떤 컴포넌트들이 있는지 정리해줘

Claude Code가 Umtri에서 트리를 읽어와 현재 구조를 설명합니다.

기능 추가와 동시에 구조 기록

BookmarkList 컴포넌트에 검색 기능을 추가해줘.
추가 후에는 Umtri 트리에도 SearchBar 컴포넌트를 leaf 노드로 등록해줘.

코드 작성과 구조 기록을 한 번의 요청으로 처리합니다.

구조 기반으로 AI에게 맥락 제공

Umtri에서 현재 트리 구조 읽어오고, 태그 필터 기능을 어디에 추가하면 좋을지 제안해줘.

AI가 현재 프로젝트 구조를 파악한 뒤 아키텍처 관점에서 의견을 냅니다.

MCP 토큰은 Umtri 계정에 대한 접근 권한을 가집니다. 코드 파일에 직접 넣으면 GitHub 같은 곳에 공개되는 위험이 있습니다.

토큰을 안전하게 관리하는 방법은 환경 변수(Environment Variable)를 사용하는 것입니다.

# .env 파일을 만들고
echo "UMTRI_TOKEN=your_token_here" > .env

# .gitignore에 추가해서 git에 올라가지 않게 설정
echo ".env" >> .gitignore

그리고 MCP 등록 명령어에서 직접 토큰 값 대신 환경 변수를 참조하면 됩니다.

MCP를 연결하기 전과 후의 차이를 정리하면 이렇습니다.

다음 편부터는 MCP 연결이 된 상태에서 실제로 기능을 쌓아가는 과정을 다룹니다. 코드를 추가할 때마다 구조가 트리에 쌓이는 흐름이 어떻게 이루어지는지 볼 수 있습니다.