Umtri를 내 AI와 연결하기 — 베풀장 블로그

지난 편에서 Umtri가 프로젝트를 나무로 그려 준다는 걸 알아봤습니다. 이번 편에서는 여러분이 쓰는 AI가 이 나무를 직접 읽고 그릴 수 있도록 연결합니다.

어렵지 않습니다. 순서는 이렇습니다.

Umtri에 가입하고 프로젝트 자리 만들기
AI에게 줄 출입증(토큰) 받기
화면에 나온 명령을 복사해서 붙여넣기
AI에게 말을 걸어 확인하기

AI와 Umtri는 어떻게 이어지나요

AI 도구는 원래 여러분 컴퓨터 안의 코드만 볼 수 있습니다. 여기에 다른 서비스를 쓸 수 있게 이어 주는 연결 방식이 있는데, 이걸 MCP라고 부릅니다. 휴대폰에 앱을 설치하듯 AI에 기능을 하나 붙인다고 생각하면 됩니다. (MCP가 궁금하다면 바이브코딩 6편에서 자세히 다뤘습니다.)

Umtri를 연결하고 나면 이렇게 말할 수 있게 됩니다.

내 Umtri 배지 목록 보여줘

지금 프로젝트 나무를 읽고, 로그인 기능이 어디에 있는지 알려줘

방금 만든 쿠폰 기능을 나무에도 추가해줘

1. 가입하고 프로젝트 자리 만들기

app.umtri.io에서 이메일과 핸들(내 이름처럼 쓰이는 영문 아이디, 나중에 못 바꿉니다)로 가입합니다. 메일로 온 인증 링크를 누르면 가입이 끝납니다.

로그인했다면 프로젝트 배지 추가를 눌러 프로젝트 자리를 하나 만듭니다. Umtri에서는 프로젝트 하나가 자라는 땅을 배지(Ground)라고 부릅니다.

이름은 편하게 정하면 됩니다. (예: 커피 주문 앱)
슬러그(slug)는 주소에 들어가는 영문 이름입니다. (예: coffee-app) 나중에 바꿀 수 없으니 짧고 알아보기 쉽게 정하세요.

나무는 아직 비어 있어도 괜찮습니다. 심는 건 AI가 해 줄 겁니다.

2. AI에게 줄 출입증(토큰) 받기

AI가 여러분 대신 Umtri에 들어가려면 출입증이 필요합니다. 이걸 토큰이라고 부릅니다.

왼쪽 사이드바 아래쪽의 프로필을 누르고 Settings로 갑니다.
API Tokens를 고릅니다.
토큰에 알아보기 쉬운 이름을 붙입니다. (예: 내 노트북 claude)
권한은 기본값인 Write를 그대로 둡니다. AI가 나무를 읽기만 하는 게 아니라 직접 그리게 하려면 Write가 필요합니다.
Generate token을 누릅니다.

토큰은 딱 한 번만 보여집니다. 비밀번호처럼 다루세요. 다른 사람에게 보내거나, 인터넷에 올라가는 파일에 적어 두면 안 됩니다. 잃어버렸다면 목록에서 지우고(Revoke) 새로 받으면 됩니다.

3. 명령을 복사해서 붙여넣기

토큰을 받으면 바로 아래에 ADD UMTRI MCP 상자가 나타납니다. Claude Code, Codex, Gemini CLI 같은 AI 도구별로 연결 명령이 이미 만들어져 있고, 방금 받은 토큰도 들어 있습니다.

쓰는 도구의 버튼을 눌러 복사한 뒤, 터미널(AI 도구를 실행하는 검은 창)에 붙여넣고 엔터를 누르면 끝입니다.

버튼은 두 가지로 나뉩니다.

버튼	뜻	이럴 때
Global	이 컴퓨터의 모든 프로젝트에서 Umtri를 씁니다	내 컴퓨터를 나 혼자 쓰고, 편하게 쓰고 싶을 때
Local	명령을 실행한 프로젝트 폴더에서만 씁니다	프로젝트마다 따로 관리하고 싶을 때

잘 모르겠다면 Local을 고르세요. 조금 번거롭지만 더 안전합니다.

복사하기 전에 Dismiss를 누르면 명령과 토큰이 함께 사라집니다. 꼭 먼저 복사하세요.

4. 잘 연결됐는지 확인하기

AI 도구를 열고(이미 열려 있었다면 한 번 껐다 켜고) 이렇게 말해 보세요.

내 Umtri 배지 목록 보여줘

방금 만든 배지 이름이 나오면 성공입니다.

Claude Code를 쓴다면 대화창에 /mcp를 입력해서 umtri가 연결되어 있는지 직접 볼 수도 있습니다.

안 될 때

“Umtri 도구가 없다”고 한다면 — AI 도구를 껐다가 다시 켜 보세요. Local로 연결했다면, 명령을 실행했던 그 프로젝트 폴더에서 AI를 열었는지 확인하세요.
도구는 보이는데 계속 실패한다면 — 토큰이 잘못 들어갔을 가능성이 큽니다. 연결할 때는 토큰이 맞는지 검사하지 않아서, 틀린 토큰이어도 연결 자체는 된 것처럼 보입니다. 토큰을 새로 받아서 다시 연결해 보세요.
읽기는 되는데 추가·수정이 안 된다면 — 토큰 권한이 Read로 되어 있을 수 있습니다. Write로 새로 받으세요.

이것도 AI에게 물어보면 됩니다.

Umtri 연결이 안 되는 것 같아. 뭐가 문제인지 확인해줘.

연결하고 나면 달라지는 것

	연결 전	연결 후
나무 그리기	앱 화면에서 직접 하나씩	”나무에 추가해줘” 한 마디
프로젝트 설명	새 대화마다 처음부터 설명	AI가 나무를 읽고 시작
버그 기록	따로 메모	”버그로 등록해줘” 한 마디

다음 편에서는 드디어 나무를 심습니다. 이미 만들어 둔 프로젝트를 AI에게 통째로 옮겨 달라고 하는 옮겨심기부터 시작합니다.