Claude에 osFoundry 연결하기…프로젝트 자료 조회부터 레코드 편집까지

Claude에 커스텀 커넥터로 osFoundry를 연결하면 평소 대화에서 프로젝트의 노트·지식 베이스·레코드를 읽고 이를 근거로 답변을 받을 수 있다. 프로젝트 토론 채널에 글을 올리거나 권한과 승인 절차에 따라 자료를 편집하는 것도 가능하다. Dev Community에 게시된 연결 안내는 설정 방법과 함께 프로젝트별 접근 범위, 변경 승인, 로컬 데이터 제한을 설명한다.

사용자는 기존 Claude 계정과 채팅을 그대로 이용하고, osFoundry 계정으로 워크스페이스 하나의 연결을 승인한다. Claude가 도구를 호출하면 api.osfoundry.io가 권한을 확인하고 실행한다. 이 연결 경로에서는 osFoundry가 모델을 실행하지 않으며 모델이나 프로바이더 키도 사용하지 않는다. 답변은 Claude 채팅에, 노트·레코드·문서는 osFoundry에 남는다. 각 호출 기록은 연결별 Recent activity에서 확인할 수 있고, ChatGPT도 같은 서버 주소로 연결할 수 있다.

접근 범위는 연결에 추가한 프로젝트와 초대한 채널로 제한된다. 프로젝트를 추가하면 해당 프로젝트의 동기화된 지원 콘텐츠인 노트, 지식 베이스, Record 채널, 클라우드 Room, 프로젝트에 할당된 GitNest 저장소, 프로젝트 토론 채널에 접근할 수 있다. 나중에 프로젝트에 추가되는 콘텐츠도 포함된다. 일반 Message 채널은 각각 초대해야 하며 비공개 채널은 소유자가 초대해야 한다.

설정은 osFoundry 헤더의 열쇠 아이콘을 눌러 Connected 탭을 여는 데서 시작한다. Connected agents 패널에서 현재 워크스페이스를 확인하고, Connect in three steps 아래 Assistant에서 Claude를 선택한다. Display name에 연결을 구분할 이름을 입력한 뒤 Add assistant를 누른다. 새 연결은 설정 대기 상태로, 아직 자료를 읽거나 변경할 수 없다. Server address 옆 Copy 버튼으로 https://api.osfoundry.io/api/v1/external-mcp 주소를 복사한다.

Claude에서는 Customize의 Connectors에서 복사한 URL을 커스텀 커넥터로 추가한다. Team·Enterprise 플랜은 조직 소유자가 먼저 Organization settings의 Connectors에서 추가한 뒤 구성원이 개별 연결한다. Connect를 누르면 osFoundry 로그인 화면으로 이동하며 클라이언트 ID나 키를 붙여 넣을 필요는 없다.

이어 https://osfoundry.io/external-assistant-authorize 의 Connect an agent 화면에서 접속할 어시스턴트 클라이언트와 돌아갈 호스트를 확인한다. Workspace to connect에서 워크스페이스 하나를 선택하며, 다른 워크스페이스는 별도 연결이 필요하다. 요청 권한에는 추가한 프로젝트의 지원 리소스 읽기, 편집 권한이 있는 지원 리소스 변경, 실행자 역할을 부여한 세션 실행이 표시된다. Connection에서 앞서 만든 대기 중 연결을 선택하거나 새 연결을 만들 수 있다. 연결 승인 항목에 체크하고 Connect를 누르면 Claude로 돌아오지만, 새 연결은 프로젝트 0개로 시작하므로 아직 자료가 보이지 않는다.

osFoundry의 Connected 탭으로 돌아와 연결 상태가 Connected로 바뀌었는지 확인한 뒤, Projects에서 프로젝트를 선택하고 Add to project를 누른다. 일반 메시지 채널은 Message channels에서 Choose a Message channel로 대상을 골라 Invite로 초대한다. 지원 도구는 기본으로 모두 켜져 있으므로 제외할 도구의 체크를 해제하고 Save tools로 저장한다. 마지막으로 Claude 대화의 + 메뉴에서 Connectors를 열어 osFoundry 커넥터를 켜면 자연어로 작업을 요청할 수 있다.

안내에 실린 데모는 Q3 출시 체크리스트의 미완료 항목과 지원 지식 베이스의 불일치를 확인하고, pricing page 레코드 상태를 Ready로 바꾸는 흐름을 보여준다. 연결된 프로젝트와 노트 탭을 조회한 뒤 체크리스트를 읽고, search_knowledge_base로 환불 정책을 검색하며, read_record_item으로 레코드의 현재 상태와 버전을 확인한다. 데모에서는 체크리스트 항목 9개 중 미완료 3개를 찾아내고, 체크리스트의 환불 기간 14일이 지식 베이스 문서의 30일과 다르다는 점을 확인한다. 이는 데모 프로젝트의 예시 콘텐츠다.

레코드를 변경하는 edit_record_item은 read_record_item이 반환한 버전을 요구한다. 읽은 뒤 다른 사용자가 레코드를 바꾸면 덮어쓰지 않고 변경을 거절한다. 같은 idempotency_key로 재시도하면 첫 결과를 반환해 중복 쓰기를 막는다. 데모에서는 Claude가 도구 호출 허용 여부를 묻고 사용자가 Allow를 선택한 뒤 레코드를 저장한다. 실제 도구와 인자 이름은 서버가 tools/list로 제공하며, Claude Code에 같은 URL을 osfoundry라는 이름으로 추가하면 mcp__osfoundry__list_project_resources 같은 형태로 표시된다.

osFoundry는 호출마다 연결 상태, 워크스페이스, 현재 프로젝트 멤버십, 항목이 속한 프로젝트와 사용자의 역할을 대조한다. 노트를 다른 프로젝트로 옮기거나 연결에서 프로젝트를 빼거나 Revoke connection을 누르면 바로 다음 호출부터 해당 접근을 거절한다. 편집하려면 연결을 승인한 사용자가 그 시점에도 편집 권한을 보유해야 한다.

GitNest 작업, change set, 파일 가져오기, 풀 리퀘스트, Room 앱 설치는 propose_… 도구를 거쳐 변경 제안으로 쌓인다. 사용자는 Connected 탭의 Needs your approval에서 대상 저장소·Room·파일을 확인하고 Approve 또는 Decline을 선택한다. Git 프로바이더 토큰이나 시크릿 값은 Claude에 전달되지 않는다.

연결이 osFoundry에 개인 Claude 대화 접근 권한을 주지는 않는다. osFoundry에는 개인 대화를 나열하거나 읽거나 시작하는 API가 없으며, Claude도 osFoundry의 백그라운드 알림을 받지 않고 사용자가 대화를 열어 요청할 때만 움직인다. 채팅을 프로젝트에 연결하는 link_current_chat이 받는 라벨도 확인된 신원이 아니라 라우팅 힌트로 취급한다.

로컬 Room, 로컬 Graph 세션, 한 번도 동기화되지 않은 콘텐츠는 클라우드 연결에서 보이지 않는다. 서버도 initialize 응답으로 로컬 전용 데이터에 접근할 수 없음을 알린다. 데스크톱 Graph 세션 공유는 같은 탭의 별도 스위치로 관리하며, 데스크톱 앱이 열려 있고 로그인돼 있어야 한다. 지식 베이스를 활용한 답변은 search_knowledge_base가 반환하는 문서 ID와 마지막 업데이트 시점을 통해 출처를 확인할 수 있다.