AI 커넥터 (Claude 연결)

외부 AI 비서를 내 타이거빔 프로젝트에 직접 연결하는 기능입니다. 연결 방법은 두 가지입니다.

AI는 판단하지 않고 돕습니다. 조회·요약·초안 작성까지가 AI의 역할이고, 최종 판단·게시·책임은 사람에게 있습니다. (10. AI 검토와 같은 원칙)

1. 원격 커넥터 — Claude에 주소로 연결

• 무엇: 타이거빔은 MCP(Model Context Protocol) 표준 원격 커넥터를 제공합니다. Claude에 주소 하나를 넣고 타이거빔 계정으로 로그인하면 연결됩니다 — 설치·명령어·설정 파일이 없습니다.
• 누가: Team 요금제 이상 + 본인이 소유자·관리자(admin) 인 프로젝트가 있는 계정. 연결하면 내가 관리하는 프로젝트들이 자동으로 연결됩니다(개인 계정 단위, 읽기 전용).

커넥터 주소

https://app.tigerbeam.co.kr/api/mcp

연결하기 (Claude)

1. Claude(데스크톱 앱 또는 claude.ai 웹)에서 설정 → 커넥터로 갑니다.
2. 커스텀 커넥터 추가 를 누르고 위 주소를 붙여넣습니다.
3. 타이거빔에 연결 로그인 화면이 열립니다 — "AI(Claude)가 내 프로젝트에 접근하도록 허용하려면 로그인하세요." 이메일·비밀번호를 입력하고 로그인하고 연결 허용 을 누릅니다.
4. Claude로 자동 복귀하면 연결 완료입니다.

연결 확인: 대화창에 이렇게 물어보세요.

"타이거빔에서 내 프로젝트 목록 보여줘"

내가 관리하는 프로젝트가 나오면 성공입니다.

📷 [스크린샷: Claude 커스텀 커넥터 추가 → 타이거빔 로그인 → 프로젝트 목록 확인]

지금 제공되는 범위

• 현재 원격 커넥터가 제공하는 도구는 프로젝트 목록 조회 1종(연결 확인용)입니다. 도면·마크업·RFI까지 읽고 초안을 쓰는 전체 도구는 아래 ② CLI 연결에서 제공되며, 커넥터에도 순차 확대될 예정입니다.
• 연결 범위는 읽기 전용입니다 — 커넥터로는 데이터가 변경되지 않습니다.

알아둘 것

• 연결하면 프로필 · 설정 → API 토큰 · Agent 목록에 Claude 원격 커넥터 라는 Agent와 토큰이 자동으로 생깁니다 — 정상이며, 연결을 끊으려면 여기서 토큰을 폐기하거나 Claude의 커넥터 설정에서 제거하면 됩니다.
• 연결은 30일 후 만료됩니다 — 만료되면 Claude에서 다시 로그인하세요.
• 재연결을 반복해 "API 키 발급 한도" 오류가 나면, 프로필 · 설정 → API 토큰 · Agent에서 안 쓰는 기존 토큰을 폐기하세요.

다른 AI 앱

2. CLI 연결 — Claude Desktop에서 전체 도구 쓰기

PC의 Claude Desktop에 타이거빔 CLI를 연결하면 19개 도구 전체(프로젝트·도면·마크업·멤버·변경사항 조회, 도면 다운로드, 마크업 추가, RFI 답변 초안 등)를 쓸 수 있습니다.

API 토큰(PAT) 발급 — 3단계

모든 토큰은 Agent라는 이름표에 묶이고, Agent는 부여한 프로젝트만 접근합니다(deny-by-default).

1. 계정 메뉴 → 프로필 · 설정 → API 토큰 · Agent 패널.
2. Agent 생성 — 이름을 붙입니다(예: my-laptop-cli). "모든 PAT는 Agent에 바인딩됩니다. Agent를 만들고 접근할 프로젝트를 부여하세요."
3. Agent를 선택하고 프로젝트 접근 권한 에서 프로젝트 선택 → 권한 부여. (프로젝트 권한 부여는 그 프로젝트의 소유자만 할 수 있습니다.)
4. 토큰 발급: 토큰 이름 · Agent · 권한 범위 (scope)(기본은 읽기 3종: project:read·sheet:read·markup:read) · 만료 기간(30일/90일) 선택 → 발급.
5. 새 API 토큰 창에서 토큰을 즉시 복사합니다 — "이 토큰은 지금 한 번만 표시됩니다. 지금 복사해 안전한 곳에 보관하세요 — 다시 볼 수 없습니다."

요금제: 발급은 요금제에 API 접근이 있어야 합니다 — Team은 읽기 전용 scope만, 쓰기 scope(sheet:write·markup:write 등)는 상위 플랜이 필요합니다. 발급이 잠겨 있으면 "이 요금제는 API 토큰 발급을 지원하지 않습니다"류 안내가 표시됩니다.

Claude Desktop 원클릭 연결

토큰 발급 직후 같은 창의 Claude Desktop에 연결 섹션에서:

1. 설정 복사 버튼을 누릅니다 — 토큰·주소가 이미 채워진 설정(JSON)이 통째로 복사됩니다.
2. 아래 경로의 파일을 열어 붙여넣습니다(파일이 없으면 새로 만드세요):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Claude Desktop을 완전히 종료했다가 다시 엽니다 → 도구 목록에 tigerbeam 도구들이 나타납니다.

• 주의: "이 방법은 PC에 Node.js가 설치돼 있어야 합니다. 없으면 nodejs.org에서 먼저 설치하세요." 스니펫에는 방금 발급된 토큰 평문이 들어 있으니 채팅·메일로 공유하지 마세요. 창을 닫으면 같은 스니펫은 다시 볼 수 없습니다(분실 시 재발급).

📷 [스크린샷: 토큰 발급 모달 — 1회 표시 토큰 + Claude Desktop에 연결(설정 복사)]

토큰 관리

• 발급된 토큰 목록에서 상태(활성/폐기됨/만료됨)를 확인하고, 폐기 하면 즉시 접근이 차단됩니다.
• Agent를 삭제하면 연결된 토큰·프로젝트 권한이 함께 삭제됩니다 — 용도별로 Agent를 나누면(노트북용·자동화용) 회수가 쉽습니다.

3. 보안·권한

• 연결하려면 타이거빔 로그인 또는 유효한 토큰이 필요합니다. 없이는 아무 데이터도 열리지 않습니다.
• AI·Agent는 deny-by-default — 명시적으로 권한을 부여한 프로젝트만 보입니다. 다른 사람 프로젝트나 권한 밖 프로젝트는 보이지 않습니다.
• 작성 계열 도구(CLI 연결)는 초안·제안을 만드는 것이고, 실제 게시·확정은 타이거빔 화면에서 사람이 합니다.

조직 차원의 자동화(조직 Agent·이벤트 구독 웹훅·실행 원장)는 → 17. Agent 활동

4. 문제 해결