own-it읽고, 정하고, 넘긴다

연결하기

코드를 읽는 일은 내 컴퓨터에서 합니다. 그래서 작은 프로그램 하나를 MCP 를 쓰는 곳에 등록해야 합니다. 서버로 오는 것은 20줄 이하의 발췌뿐입니다.

  1. 토큰을 하나 발급합니다

    기계마다 하나씩 만들어 두면 노트북을 잃어버렸을 때 그것만 폐기할 수 있습니다.

    토큰 발급하러 가기 →

  2. 터미널에 이 한 줄을 붙여 MCP 서버를 등록합니다

    발급 화면에서 토큰을 복사해 아래 자리에 넣고 터미널에서 실행합니다.

    claude mcp add own-it -s user -e OWN_IT_TOKEN=<발급한 토큰> -e OWN_IT_API=https://own-your-flowers.vercel.app -- npx -y own-it-mcp

  3. 클로드 앱을 완전히 껐다 켭니다

    새 대화를 여는 것으로는 안 됩니다. 앱은 켤 때 한 번만 설정을 읽기 때문에, 종료 후 다시 켜야 붙습니다. 터미널에서 claude 를 새로 실행하는 경우는 그때 읽으므로 재시작이 필요 없습니다.

  4. 붙었는지 확인합니다

    터미널에서 claude mcp list 를 실행하거나, 클로드코드 대화창에서 /mcp 를 치면 목록에 own-it 이 보입니다.

  5. 리뷰를 부릅니다

    리뷰할 프로젝트 폴더에서 관점을 붙여 부릅니다. 그냥 “내 코드 봐줘” 라고 하면 시작되지 않습니다. 슬래시로 불러야 분석법이 대화에 들어갑니다.

    예시:

    /mcp__own-it__review 에러 처리

    끝나면 카드가 프로젝트 에 쌓입니다.

직접 실행 / 디버그용

  1. 터미널에서 Stdio 모드로 직접 실행해 봅니다

    MCP 서버가 정상적으로 부팅되는지 터미널에서 즉시 검증할 수 있습니다. 정상 실행 시 stderr 로 프로젝트 정보가 출력되고 입력을 기다립니다.

    터미널에서 실행하세요:

    OWN_IT_TOKEN=<발급한 토큰> OWN_IT_ROOT=/절대경로/내프로젝트 OWN_IT_API=https://own-your-flowers.vercel.app npx -y own-it-mcp

  2. 공식 MCP Inspector CLI 로 디버깅 및 도구 테스트

    Anthropic/MCP 공식 인스펙터 도구를 사용하면 웹 UI 환경에서 own-it 의 5개 도구와 프롬프트를 직접 호출해 보고 입출력을 확인할 수 있습니다.

    터미널에서 실행하세요:

    npx @modelcontextprotocol/inspector -e OWN_IT_TOKEN=<발급한 토큰> -e OWN_IT_ROOT=/절대경로/내프로젝트 -e OWN_IT_API=https://own-your-flowers.vercel.app npx -y own-it-mcp

  3. 저장소 소스코드에서 로컬 개발할 때

    이 저장소의 코드를 직접 수정하며 테스트할 때는 빌드 후 node 로 직접 실행할 수 있습니다:

    npm run build -w own-it-mcp
OWN_IT_TOKEN=<발급한 토큰> OWN_IT_ROOT=$(pwd) node packages/mcp/dist/index.js