MCP로 Claude에 연결하기

에이전트 토큰을 발급했다면 이제 그 토큰을 Claude에 연결해 볼 차례입니다. 퍼널브레인은 Claude Code나 Claude Desktop 같은 AI 도구가 말로 시킨 일을 대신 실행하도록 MCP라는 연결 방식을 제공합니다. 연결 방법은 설정의 에이전트 토큰 화면에 있는 MCP 연동 — Claude에서 바로 쓰기 카드에 단계별로 정리되어 있습니다. 이 글에서는 그 카드를 읽는 법과, 발급 직후 화면에 나타나는 바로 연결용 명령을 쓰는 순서를 안내합니다. 토큰을 발급하고 폐기하는 방법은 별도의 글에서 다룹니다.

1. MCP 연동 카드는 어디에 있나요

왼쪽 사이드바의 시스템 묶음에서 설정을 누른 뒤 상단 탭 줄의 에이전트 토큰을 누릅니다. 맨 위의 에이전트 액세스 토큰 설명 카드 바로 아래에 MCP 연동 — Claude에서 바로 쓰기 카드가 있습니다. 이 카드는 토큰이 하나도 없어도 항상 보이므로, 토큰을 발급하기 전에 먼저 읽어 보셔도 됩니다.

카드 설명 끝에는 이 기능을 내 계정에서 쓸 수 있는지가 표시됩니다. 쓸 수 있는 플랜이면 "현재 플랜에서 사용할 수 있습니다"라고 나오고, 그렇지 않으면 어느 플랜 이상에서 사용할 수 있는지가 안내됩니다. 사용할 수 있는 플랜은 설정에 따라 달라질 수 있으니 이 문구를 기준으로 확인하세요.

2. 카드의 3단계 따라가기

카드 안에는 번호가 매겨진 세 단계가 있습니다.

1. 토큰을 발급합니다. 안내에는 권한을 write:draft까지만 주는 것을 권한다고 적혀 있습니다. 생성은 AI가 하고 승인은 내가 직접 하게 된다는 뜻입니다. 권한은 토큰 발급 카드의 권한 (스코프)에서 고릅니다.
2. 터미널에서 아래 명령을 실행합니다. 카드에 claude mcp add로 시작하는 명령이 표시되고, 오른쪽의 복사 버튼으로 복사할 수 있습니다. 명령 안의 여기에_발급받은_토큰 자리에 방금 복사한 토큰을 넣어 실행합니다.
3. Claude에게 말로 시킵니다. 카드에는 예시 문장이 함께 있습니다. "내 퍼널브레인 프로젝트 목록 보여줘", "3번 프로젝트로 리서치 시작해줘", "2번 프로젝트에 신규 창업자용 체크리스트 만들어줘" 같은 식으로 말하면 됩니다.

3. 발급 직후 나타나는 바로 연결 명령

토큰을 발급하면 맨 위에 발급된 토큰 — 지금 한 번만 표시됩니다 카드가 나타나고, 그 안에 Claude Code에 바로 연결하기 영역이 함께 보입니다. 이 영역의 명령에는 방금 발급한 토큰이 이미 들어 있어서, 자리표시자를 바꿀 필요 없이 복사해 터미널에 붙여넣으면 이 토큰으로 MCP 서버가 등록된다고 안내합니다. 토큰 값은 이 화면에서만 볼 수 있으므로, 연결할 계획이 있다면 이 시점에 명령을 복사해 두세요. 아래 이미지는 토큰 값을 가려서 보여 드립니다.

4. 크레딧 안전장치와 연결이 안 될 때

카드 아래쪽에는 두 가지 안내가 더 있습니다.

• 크레딧 안전장치: 생성 작업은 실행 전에 예상 크레딧을 먼저 계산합니다. 비용이 크거나 예상할 수 없으면 AI가 바로 실행하지 않고 먼저 나에게 확인합니다. 크레딧이 드는 큰 작업은 이 확인을 거치도록 되어 있습니다.
• 연결 문제 확인: Claude Desktop처럼 인증 헤더를 직접 넣을 수 없는 앱은 중계 도구가 필요합니다. 연결이 안 되면 403은 플랜이나 역할 문제, 401은 토큰 문제라고 안내합니다.

이렇게 활용해 보세요

• 처음에는 write:draft 권한 토큰으로 연결하고 "프로젝트 목록 보여줘"처럼 조회부터 시켜 보세요. 연결이 잘 되었는지 가볍게 확인할 수 있습니다.
• 생성을 시킬 때는 Claude가 되묻는 크레딧 확인을 읽고 진행 여부를 직접 정하세요.
• 도구를 바꾸거나 더 쓰지 않을 때는 에이전트 토큰 화면에서 해당 토큰을 폐기하세요. 폐기하면 그 토큰으로 한 연결은 바로 쓸 수 없게 됩니다.

알아 두실 점

• 연결 명령에 들어가는 토큰은 내 계정에 접근하는 열쇠입니다. 명령을 다른 사람에게 보내거나 공개된 곳에 붙여넣지 마세요.
• 카드의 명령은 현재 보고 있는 퍼널브레인 주소를 기준으로 만들어집니다. 연결할 때는 카드에 보이는 명령을 그대로 복사해 쓰세요.
• Claude에게 시킨 일은 내 계정의 크레딧을 사용하는 작업이 될 수 있습니다. 예상 크레딧은 화면의 안내와 Claude의 확인 문구에서 확인하세요.
• 사용할 수 있는 플랜과 역할이 맞지 않는 계정에서는 토큰 발급 칸 대신 이 계정에서는 사용할 수 없습니다 안내가 나타납니다.