MCP 연동

리캐치2026-08-28

Re:catch MCP(Model Context Protocol)는 Claude 같은 AI 도구가 Re:catch CRM을 직접 조회하고 기록할 수 있게 연결해주는 기능이에요. 데이터를 복사해서 붙여넣거나 화면을 이리저리 오갈 필요 없이, 대화 중에 바로 딜·회사·연락처를 찾고 메모를 남길 수 있어요.

이런 질문을 바로 해결할 수 있어요.

  • 최근 한 달 간 생성된 리드를 UTM 기준으로 분류해서 채널별 건수를 보여줘

  • Drop된 딜들의 사유를 분류해서, 가장 많이 놓치는 이유를 알려줘

  • 이번 분기 성사된 MRR 실적과 진행중인 딜들의 MRR 합계를 계산해서 목표 달성 가능성을 추산해줘

  • '비즈니스캔버스' 딜에 ~한 미팅 내용 추가해주고, '예상 마감일'을 9월 15일로 변경해줘

MCP 활성화 요청(파일럿 기간 중)

문의 폼을 통해서 요청해 주세요.

▶ 활성화가 완료되면 아래 메뉴가 생성됩니다.

- 팀 관리자: [설정] > [MCP 관리]

연결·감사 이력, 팀 관리자에게만 보입니다.

- 팀원 전원: [설정] > [MCP 승인함]

멤버별 쓰기 권한 설정 (초기값 : 읽기 전용)

쓰기 기능이 필요한 멤버가 있다면,

팀 관리자[설정] > [멤버]에서 직접 권한을 부여해 주세요.

접속 주소는 모두 동일합니다 : https://api.recatch.cc/mcp

주로 사용하시는 AI 도구를 선택해 연결을 진행해 주세요.

  • Claude Code (CLI)

  • Claude 데스크톱 · claude.ai (커넥터)

  • Codex CLI

  • Codex app(Chatgpt)

  1. 터미널에 아래 명령어 입력

Plaintext
claude mcp add --transport http recatch https://api.recatch.cc/mcp
  1. Claude Code에서 /mcp 입력 → 인증 항목 선택

  2. 브라우저로 Re:catch 로그인·동의 화면 승인→ 연결 완료

  1. Admin 계정에서 설정 → 커넥터 → 커스텀 커넥터 추가

  1. HTTPS 주소 입력 → https://api.recatch.cc/mcp

  1. 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 recatch 주소 입력

  1. 브라우저 동의 화면 승인 → 연결 완료

  • MCP 서버 등록 → 허용된 scope 체크하고 로그인

Plaintext
codex mcp add recatch --url https://api.recatch.cc/mcp
codex mcp login recatch --scopes mcp:read,mcp:write

Codex 로그인 시 필수 확인

  • 권한(scope)구문을 생략하면 계약 밖 scope오류가 나며 등록이 거부됩니다.

  • 읽기 전용 로그인

    codex mcp login recatch --scopes mcp:read

  • ChatGPT 앱을 이용하실 경우, 앱 내 Codex를 사용하여 진행해 주세요.

승인 화면에 아래와 같은 요청 권한이 표시됩니다.

  • Re:catch 데이터 읽기 : 딜·회사·연락처·대화 조회

  • Re:catch 데이터 쓰기 : 메모·활동 기록 추가 (※ 팀 관리자에게 권한을 부여받은 경우에만 표시)

Tip. "클라이언트 제공 이름 · 미검증" 표기는 정상입니다. 프로그램이 자체적으로 보고한 이름이라는 뜻이니 안심하고 진행하세요.

도구

하는 일

권한

describe_workspace

워크스페이스 구조·필드 정의 조회

읽기

search_records

키워드로 레코드 검색

읽기

list_records

조건으로 레코드 목록 조회

읽기

get_record

레코드 상세 조회(대화 내역 포함)

읽기

get_record_activity

레코드 활동 이력 조회

읽기

add_note

레코드에 메모 추가

쓰기

log_activity

레코드에 활동 기록 추가

쓰기

update_record

레코드 필드의 값 추가 및 수정

쓰기

  • 데이터 추가만 가능합니다.

    • 메모·활동을 새로 남길 수 있을 뿐, 기존 데이터를 수정하거나 삭제하는 도구는 제공하지 않습니다. (예: 딜 단계 변경, 금액 수정, 레코드 삭제 불가)

  • 기존 권한 체계를 그대로 따릅니다.

    • 인앱에서 볼 수 없는 딜은 AI에게도 보이지 않습니다. 도구를 연결한다고 해서 접근 권한이 넓어지지 않습니다.

  • 모든 호출이 기록됩니다.

    • [설정] > [MCP 관리] > [감사 이력]에서 누가·언제·어떤 도구를 썼는지 확인할 수 있습니다.

    • 뉴스피드에도 해당 내용이 노출됩니다.

  • 외부 유입 텍스트를 읽은 세션의 쓰기는 사람의 승인을 거칩니다.

    • 즉시 실행되지 않고 [설정] > [MCP 승인함]에 대기합니다. (→ 아래 MCP 승인함 참조)

  • 연결한 클라이언트는 즉시 해제할 수 있습니다.

    • [설정] > [MCP 관리]에서 '연결 해제'를 누르면 즉시 클라이언트 요청이 차단되고 토큰도 무효화됩니다.

파일럿 이전에 발급받은 정적 토큰(rctk_로 시작)은 목록에 나타나지 않으므로, 회수나 교체가 필요하면 채널톡으로 문의 남겨주세요.

 AI가 고객 데이터(대화·메모·활동)를 읽고 새로운 기록을 남길 때, 원본 데이터에 숨겨진 악의적 지시어자동 실행되는 것을 막기 위한 안전장치입니다.

이 안전장치는 특정 조건에서만 작동하기 때문에 실제로 승인함으로 이동하는 경우는 많지 않습니다. 평소 대부분의 작업은 승인 절차 없이 빠르고 편리하게 사용해 주세요.

  1. 승인 대상으로 전환

    Re:catch에 저장된 고객의 대화·메모·활동을 AI가 읽으면, 같은 대화에서 이어지는 쓰기 요청은 승인함으로 이동합니다.

  2. 저장 대기

    AI가 메모나 활동을 기록하려 할 때, 즉시 저장되지 않고 [승인 대기] 상태로 일시 정지됩니다.

  1. 내용 확인 및 승인

    설정MCP 승인함으로 이동해 AI가 저장하려는 내용을 직접 읽어보고 [승인] or [거절]을 클릭합니다.

  1. 안전하게 저장 완료

    승인하는 즉시 화면에 보였던 내용 그대로 안전하게 저장됩니다. 승인 과정에서 AI가 내용을 임의로 바꾸거나 재생성하지 않으며, 중복 저장도 발생하지 않습니다.

  • 승인은 요청한 '본인'만 할 수 있습니다.

    승인함 메뉴는 팀원 누구나 들어갈 수 있지만, 각자 자신이 요청한 내역만 보입니다. 팀 관리자나 Re:catch 담당자가 대신 승인하거나 거절할 수 없습니다.

  • 외부 데이터를 읽지 않은 작업은 바로 저장됩니다.

    Re:catch에 저장된 고객의 대화·메모·활동을 먼저 조회하지 않은 일반적인 쓰기 작업은 바로 실행됩니다. 특정 딜을 지정해 메모 추가만 요청한 경우도, 그 전에 고객 내용을 조회하지 않았다면 바로 저장됩니다.

  • 24시간이 지나면 만료됩니다.

    대기 중인 건은 24시간 내에 결정하지 않으면 자동으로 만료되어 실행되지 않습니다. 한 번 거절하거나 만료된 건은 되살릴 수 없으므로 AI에게 새로 요청해 주셔야 합니다.

  • 대기함은 50개까지만 보관됩니다.

    승인 대기 중인 항목이 50개에 도달하면 새로운 AI 요청이 거부됩니다. 원활한 사용을 위해 승인함을 수시로 확인하고 정리해 주세요.

더 궁금한 점이 있다면 여기로 언제든 문의해 주세요.

빠른 문제 해결 Tip. 오류 상황을 문의하실 때 '발생 시각'을 함께 알려주시면 더욱 빠른 확인이 가능합니다.

  • 확인 위치: [설정] > [MCP 관리] > [감사 이력]