실전 사용가이드

처음 방문자는 홈페이지에서 Start를 누른 뒤 가입 화면으로 이동합니다. 이메일 가입을 선택했다면 이메일과 비밀번호를 입력하고, 인증 메일을 확인한 뒤 다시 Sign in 화면에서 로그인합니다.

로그인 후에는 먼저 Dashboard가 열리는지 확인합니다. 상단 메뉴가 보이면 계정 생성은 끝난 상태입니다. 이때 Marketplace는 공개 팩을 찾는 곳, Packs는 내가 설치하거나 만든 팩을 보는 곳, Ingest는 내 자료를 넣는 곳, MCP는 외부 AI 도구 연결 URL을 만드는 곳입니다.

팩을 사거나 공개 팩을 쓰기만 한다면 Free로 시작하면 됩니다. Free는 자기 자료를 넣는 플랜이 아니라, 이미 공개된 팩을 둘러보고 GPT/Claude 같은 외부 도구에서 조회하는 입문 플랜입니다.

내 PDF, 문서, URL, GitHub 자료를 OpenCrab에 넣고 개인 지식팩으로 쓰려면 Pro가 필요합니다. Pro는 개인 인제스트와 비공개 작업공간에 초점을 둡니다.

내가 만든 온톨로지 팩을 판매하거나, Codex/Claude Code 같은 MCP 클라이언트에서 나온 작업 결과를 다시 OpenCrab 팩으로 저장하려면 Expert가 필요합니다.

Marketplace에서 팩을 설치하면 해당 팩의 문서, 노드, 엣지, 샘플 질문이 내 워크스페이스에 연결됩니다. 설치 직후에는 Packs 화면으로 이동해 팩이 실제로 들어왔는지 확인하는 것이 좋습니다.

무료 팩은 바로 설치되고, 유료 팩은 구매 권한이 먼저 확인됩니다. 이미 구매한 팩은 다시 결제하지 않고 재설치할 수 있어야 합니다. 설치 완료 후에는 Query 화면이나 MCP 클라이언트에서 바로 사용할 수 있습니다.

MCP URL은 OpenCrab 계정에 연결된 개인 접속 URL입니다. URL 자체에 접근 키가 들어 있으므로 공개 문서, GitHub 이슈, 채팅방에 그대로 붙여넣지 않는 것이 좋습니다.

한 번 만든 URL은 여러 AI 도구에 붙여 쓸 수 있습니다. 권한은 URL을 만든 시점에 고정되는 것이 아니라 현재 계정 티어를 기준으로 적용됩니다. 예를 들어 나중에 Expert로 바뀌면 기존 URL에서도 Expert 도구가 열릴 수 있습니다.

사용하지 않는 URL은 MCP 페이지의 Existing URLs에서 Disable 하세요. 새 URL을 만들면 기존 AI 도구에는 새 URL을 다시 붙여야 합니다.

ChatGPT에서는 custom MCP app 또는 connector 설정 화면에서 OpenCrab MCP URL을 endpoint로 넣습니다. 워크스페이스 계정에서는 관리자 설정에서 custom connector가 허용되어 있어야 메뉴가 보일 수 있습니다.

Claude 웹에서는 Customize > Connectors에서 custom connector를 추가합니다. 조직 계정은 Owner가 먼저 Organization settings에서 remote MCP connector를 등록해야 개인 사용자가 쓸 수 있습니다.

Codex는 ~/.codex/config.toml에 [mcp_servers.opencrab] 섹션을 만들고 url 값을 붙입니다. 등록 후 새 Codex 세션을 열거나 /mcp로 서버 상태를 확인합니다.

Claude Code는 터미널에서 claude mcp add --transport http opencrab <MCP_URL> 형태로 등록합니다. 프로젝트별로만 쓸지, 사용자 전체에 쓸지는 scope 옵션으로 나눌 수 있습니다.

Antigravity는 MCP 설정 화면 또는 CLI의 /mcp 패널에서 remote HTTP 서버로 OpenCrab을 추가합니다. 현재 OpenCrab Desktop의 자동 Crab Agent 실행에서는 Antigravity CLI가 TUI 전용이라 비활성화되어 있지만, 일반 MCP 연결 설명은 유지합니다.

ChatGPT에서는 OpenCrab을 일반 검색처럼 쓰기보다, 먼저 팩 목록을 확인하고 그중 하나를 지정해 질문하는 방식이 가장 안정적입니다. 예를 들어 '내가 접근 가능한 OpenCrab 팩 중 보고서 작성에 맞는 팩을 찾아줘'처럼 시작합니다.

답변 품질을 보려면 항상 근거를 같이 요청하세요. '근거 문서 제목, evidence 요약, 관련 노드/엣지를 같이 보여줘'라고 쓰면 OpenCrab을 연결한 이유가 분명해집니다.

여러 팩을 섞어 쓰는 경우에는 '팩 A와 팩 B를 비교해서 공통 개념과 충돌하는 주장만 분리해줘'처럼 비교 기준을 명시합니다.

웹 인제스트는 빠르게 자료를 넣는 데 좋고, LocalCrab/Crab Skill은 품질 좋은 릴리즈 팩을 만들 때 좋습니다. 특히 PDF, 이미지, 스캔 문서, 복잡한 도메인 자료처럼 OCR/CLIP/evidence/quality report가 필요한 경우 LocalCrab 흐름이 더 잘 맞습니다.

Crab Skill은 에이전트에게 '그냥 요약하지 말고, 근거를 수집하고, 노드와 엣지를 만들고, 품질 검사를 거쳐 OpenCrab에 업로드 가능한 ZIP을 만들라'고 지시하는 작업 규칙입니다.

최종 결과물은 OpenCrab Pack v1 또는 Data ZIP 형태여야 합니다. ZIP에는 manifest, graph, evidence, README, sample queries, quality report가 들어가야 인제스트와 검수가 쉬워집니다.

웹에서 온톨로지 팩을 만들 때는 '인제스트 실행'과 '팩 생성'을 구분해야 합니다. 먼저 Ingest에서 원본 자료를 읽어 문서, 청크, 노드, 엣지를 만들고, 그다음 History에서 Create pack을 눌러 하나의 이름 있는 팩으로 묶습니다.

Create pack을 누른 뒤 Packs 화면에서 제목과 설명을 다듬습니다. 사용자가 마켓플레이스에서 봤을 때 이해할 수 있게 '무엇을 물어보면 좋은 팩인지'를 설명에 넣는 것이 좋습니다.

팩을 업데이트하려면 같은 Ingest History에서 기존 팩을 선택한 뒤 Update pack을 누릅니다. 새 버전으로 따로 만들지, 기존 팩에 업데이트로 붙일지는 사용 목적에 따라 결정합니다.

Pack title에는 최종 팩 이름을 적습니다. Source path에는 원본 자료가 들어 있는 로컬 폴더를 지정합니다. Output directory는 Crab Agent가 만든 ZIP과 리포트를 저장할 위치입니다.

Purpose에는 이 팩이 답해야 하는 질문을 구체적으로 씁니다. 예를 들어 '이 자료로 사내 보안 규정 질의응답을 만들고 싶다'처럼 사용 목적을 적으면 에이전트가 노드와 관계를 더 정확히 설계합니다.

완전 빌드는 시간이 오래 걸리지만 PDF 전 페이지 OCR/CLIP, 로컬 임베딩, semantic vector 품질 게이트를 강하게 적용합니다. 판매용 또는 장기 보관용 팩이면 완전 빌드를 권장합니다.

웹 인제스트는 URL, 파일, GitHub, Notion, Data ZIP을 빠르게 넣는 일반 경로입니다. 지원되는 텍스트 기반 파일이나 PDF가 이미 정리되어 있다면 웹 인제스트로 충분합니다.

데스크탑 인제스트는 로컬 Crab Agent가 자료를 먼저 빌드하고 validation을 통과한 ZIP을 Cloud로 넘기는 방식입니다. 로컬 파일 접근, OCR/CLIP, 큰 폴더 처리, 품질 리포트가 필요한 경우 데스크탑을 씁니다.

둘 중 어느 경로로 넣어도 최종적으로 OpenCrab Cloud에 들어간 팩은 같은 MCP URL로 접근할 수 있습니다.

Expert는 단순히 더 많은 인제스트를 하는 플랜이 아니라, 자기 전문성을 팩으로 만들고 판매하거나 에이전트 작업 결과를 다시 지식 자산으로 남기는 플랜입니다.

판매를 준비할 때는 팩 설명, 샘플 질문, 출처, 한계, 저작권 권한을 먼저 정리합니다. OpenCrab 검수는 품질뿐 아니라 판매 권한과 상업적 적합성도 확인합니다.

MCP 역방향 인제스트는 Codex/Claude Code 같은 도구에서 작업한 결과를 다시 OpenCrab에 저장하는 기능입니다. 프로젝트 의사결정, 코드 리뷰 기준, 도메인 정책 변경을 팩 업데이트로 남길 때 유용합니다.

Codex, Claude Code, Antigravity 같은 코딩 에이전트에서는 OpenCrab을 프로젝트 메모리처럼 붙여 쓰면 좋습니다. 작업 전에 관련 팩을 검색하게 하고, 구현 중에는 정책이나 도메인 용어를 확인하게 합니다.

리뷰 작업에서는 '이 PR이 OpenCrab의 제품 정책 또는 도메인 지식과 충돌하는지 확인해줘'처럼 요청합니다. 그러면 에이전트가 코드만 보는 것이 아니라, 연결된 팩의 근거까지 함께 확인할 수 있습니다.

Expert 계정이라면 작업 후 요약, 결정사항, 새로 생긴 정책을 reverse ingest로 남겨 다음 작업자가 다시 검색할 수 있게 만듭니다.