Frame connector 설정 (claude.ai)

🔁 신규 권장 절차 = /onboard/claude-connectors (Bitwarden 확장 + AXE Vault MCP Connectors collection 으로 Frame 포함 모든 MCP 한 번에 자동 suggest). 본 페이지는 단일 connector 의 hand-find 절차 (legacy, 2026-05-26 이전) 보존용.

회사 회계 시스템 (Frame) 에 claude.ai 에서 자연어로 접근하기 위한 1회 설정.

본인 단계 (5분)

1. claude.ai 에 회사 이메일로 로그인

claude.ai → 회사 이메일 (@axellc.com 또는 본인 회사 도메인) 로 로그인.

개인 이메일 (gmail 등) 로 가입한 계정은 회사 데이터 접근 불가. 회사 이메일 사용 필수.

2. Custom Connector 추가

claude.ai 우측 상단 프로필 → Settings → Connectors → Custom connectors → + Add Custom Connector 클릭.

3. 입력값 4 개

필드	값	비밀성
Name	`Frame`	공개 (자기 화면 라벨)
Remote MCP server URL	`https://axe.axelabs.ai/frame/mcp` (또는 회사 URL)	공개
Advanced 펼치기 ↓
OAuth Client ID	운영자가 준 GUID (예: `137fc0ef-...`)	공개 (ID 일 뿐 — 메일에 평문 OK)
OAuth Client Secret	운영자가 준 secret 값	비밀 (Bitwarden Send 1회용 링크로만 전달됨, 입력 후 잊으세요)

💡 Client ID 와 Client Secret 의 차이: Client ID 는 “회사 출입증 번호 = 누구라도 봐도 됨”, Client Secret 은 “비밀번호 = 절대 노출 X”. 둘 다 함께 있어야 인증 가능.

URL 은 본인 회사 (customer) 에 따라 다릅니다. 운영자가 안내한 URL 사용:

axe customer (axellc.com 직원): https://axe.axelabs.ai/frame/mcp

realchoice customer (realchoice.co.kr 직원): 운영자가 onboard 완료 후 통지 (배포 시점에 활성)

다른 customer 의 URL 입력 시 Microsoft 가 redirect_uri mismatch (AADSTS50011) 로 거부합니다.

Client ID 는 평문으로 (Teams/메일 OK), Client Secret 은 Vaultwarden 의 Bitwarden Send 1회용 링크로 전달됩니다. 링크는 1회 열람 후 자동 무효 — 받자마자 connector 화면에 붙여 넣고 닫으세요. (운영자 측 절차: /architecture/secrets § 사람에게 전달)

4. Connect → Microsoft 로그인

Connect 버튼 클릭 → 브라우저가 Microsoft 로그인 페이지로 이동:

회사 이메일 입력 ([email protected] 등)
비밀번호 입력 (또는 Authenticator 앱)
첫 사용 시 동의 화면 — Access Frame MCP 권한 요청 → Accept 클릭
자동으로 claude.ai 로 복귀
Connector 상태가 “Connected” (녹색) 로 표시되면 성공

5. 동작 확인

claude.ai 새 채팅에서:


axec 의 5월 미결 항목 5개 보여줘

Claude 가 Frame:list_open_items 호출하고 결과를 자연어로 정리해서 보여주면 끝.

Claude Code 네이티브 앱 자동 동기화

같은 claude.ai 계정으로 Claude Code 네이티브 앱 (macOS / Windows) 에 로그인하면 자동으로 connector 가 동기화 됩니다 — 별도 설정 불필요.

확인:

Claude Code 앱 열기
/status 입력 → “Anthropic Account” 줄에 본인 이메일 표시
/mcp 입력 → Frame connector 가 목록에 보임 (claude.ai connector 표식 함께)
채팅에서 axec 의 미결 5개 등 자연어로 호출

일반 흐름

설정 완료 후 자주 쓰는 패턴:

자연어	Frame tool
”axec 의 5월 매출은?“	query_balance, list_journals
”axec 의 미결 항목 보여줘”	list_open_items
”axec 와 axev 의 이번 분기 잔액 비교”	query_balance × 2
”axec 에 매출 1000만원 계상”	post_journal (write 권한 필요)
“axec 의 4월 시산표”	query_trial_balance
”axec 의 5월 분개장”	list_journals
”은행 입출금 파일 업로드: 파일첨부”	ingest_file_blob (write)

보안 권장

Client Secret 을 다른 채널에 보관하지 마세요 — claude.ai 의 Advanced 칸에만 입력. 한 번 입력하면 다시 볼 일 없습니다.
공용 PC 에서 claude.ai 로그인 후 로그아웃 잊지 마세요 — connector 가 활성 상태로 노출됨.
회사 이메일이 의심스럽게 사용된 흔적이 있으면 즉시 [email protected] (운영자) 에게 신고.

문제 발생 시

/onboard/troubleshooting 참조 또는 운영자에게 다음 정보 전달:

어느 단계에서 막혔는지
오류 메시지 전문 (특히 AADSTS 코드)
브라우저 주소창의 전체 URL

Microsoft 365 connector — OneDrive·Outlook·Teams 통합 (선택)
문제 해결 모음