AI 앱을 Recoble MCP로 연결하기

Recoble MCP를 연결하면 ChatGPT, Claude, Claude Code처럼 MCP를 지원하는 AI 앱에서 Recoble 스페이스의 노트·워크보드·캘린더·메일·채팅을 바로 찾고, 읽고, 만들고, 고칠 수 있습니다. 스페이스마다 연결 주소가 하나씩 있고, 그 주소를 AI 앱에 넣으면 됩니다.

MCP란?

MCP(Model Context Protocol)는 AI 앱이 외부 서비스의 기능을 "도구"로 불러 쓰는 표준 방식입니다. Recoble MCP 서버는 노트 찾기, 항목 만들기, 일정 잡기 같은 Recoble 기능을 도구로 제공합니다. AI 앱은 사용자의 요청을 보고 필요한 도구를 골라 부릅니다.

사용자는 도구 이름을 몰라도 됩니다. 평소 말하듯 요청하면 됩니다.
AI 앱은 연결한 스페이스와 허용한 기능 안에서만 Recoble에 접근합니다.
접근할 수 있는 범위는 내 계정 권한과 같습니다. 내가 볼 수 없는 노트나 항목은 AI 앱도 볼 수 없습니다.

이런 일을 할 수 있습니다

회의와 문서: "어제 회의록 노트에서 결정 사항만 정리해 줘", "'3분기 로드맵' 노트 끝에 다음 단계 섹션을 추가해 줘"
업무 관리: "개발 백로그에서 이번 주가 마감인 내 항목을 알려 줘", "'로그인 오류 수정' 항목 진행률을 50%로 바꿔 줘"
일정: "내일 오후 3시에 디자인 리뷰 일정을 잡아 줘", "이번 주 일정을 요일별로 정리해 줘"
메일과 채팅: "'청구서' 메일을 찾아서 요약해 줘", "나를 멘션한 채팅 메시지를 보여 줘"
연결과 추적: "요구사항 노트와 '로그인 오류 수정' 항목을 연결해 줘", "이 노트와 연결된 항목을 그래프로 보여 줘"
개발 작업: Claude Code에서 워크보드 항목을 읽고 작업한 뒤, 끝나면 댓글을 남기고 상태를 바꿉니다.

시작하기 전에

연결 주소는 스페이스마다 다릅니다. 여러 스페이스를 쓰려면 스페이스마다 따로 연결합니다.
그 스페이스의 멤버만 연결할 수 있습니다.
캘린더·메일·채팅·대시보드는 스페이스가 아니라 계정에 붙은 기능입니다. 이 기능은 기본 스페이스로 연결할 때만 함께 허용할 수 있습니다.

연결 주소 확인하기

연결할 스페이스의 메뉴에서 스페이스 설정 을 엽니다.
연결 탭을 고르고 AI 도구 연결 을 엽니다. 설정을 연 스페이스의 주소가 나옵니다.
연결 URL 옆의 복사 를 눌러 주소를 복사합니다.

주소는 https://mcp.recoble.com/s/<스페이스 ID>/mcp 형태입니다. 이 주소로 연결하면 그 스페이스에서 쓸 수 있는 기능 전부가 연결됩니다.

✋ 참고: 연결 URL은 스페이스 전용입니다. 스페이스를 바꾸려면 기존 연결을 해제하고 새 스페이스의 주소로 다시 연결하세요.

ChatGPT·Claude 같은 AI 앱에서 연결하기

웹이나 데스크톱 AI 앱은 Recoble 로그인으로 연결합니다(OAuth). 토큰을 따로 만들 필요가 없습니다.

AI 앱의 설정에서 커넥터(또는 앱, MCP 서버)를 추가하는 화면을 엽니다. 메뉴 이름과 사용할 수 있는 요금제는 앱마다 다르니 각 앱의 안내를 확인하세요.
사용자 지정 커넥터를 추가하고, 복사한 연결 URL 을 붙여 넣습니다.
연결을 시작하면 Recoble 로그인 창이 열립니다. 연결할 계정으로 로그인합니다.
연결 허용 화면에서 AI 앱 이름, 대상 스페이스, 요청한 권한을 확인합니다. 스페이스를 고르라고 나오면 연결할 스페이스 에서 고릅니다.
기본 스페이스를 연결하는 경우 내 계정 기능도 허용 에서 캘린더·메일·채팅·대시보드 중 AI 앱이 쓸 기능을 체크할 수 있습니다.
허용 을 누르면 연결이 끝납니다.

💡 팁: 연결한 뒤 AI 앱에서 Recoble 도구가 보이지 않으면 새 대화를 시작하거나 커넥터를 다시 연결해 보세요. AI 앱은 연결할 때 도구 목록을 받아 옵니다.

Claude Code·스크립트에서 연결하기 (액세스 토큰)

터미널 도구, 스크립트, 서버 연동처럼 로그인 창을 띄우기 어려운 곳에서는 액세스 토큰을 헤더에 넣어 연결합니다.

스페이스 설정 › 연결 › AI 도구 연결 아래의 액세스 토큰 (스크립트 · CLI용) 으로 갑니다.
액세스 토큰 이름 을 적습니다. 어디에 쓰는 토큰인지 알아볼 수 있는 이름이 좋습니다.
권한을 고릅니다.
- 읽기 — 찾고 읽는 도구만 씁니다. 만들기·고치기·지우기는 할 수 없습니다.
- 읽기+쓰기 — 만들기·고치기·지우기 도구까지 씁니다.
필요하면 AI 기능 접근 에서 캘린더·메일·채팅·대시보드를 고릅니다. 기본 스페이스에서 발급하는 토큰에서만 고를 수 있고, 고르지 않으면 이 스페이스의 노트·워크보드만 씁니다.
만료 기간 을 7일·30일·90일·180일·365일 중에서 고릅니다.
발급 을 누르고, 나타난 토큰을 바로 복사합니다. 토큰은 이때 한 번만 보입니다.

Claude Code에서는 다음 명령으로 연결합니다. <스페이스 ID> 와 <액세스 토큰> 을 바꿔 넣으세요.

claude mcp add --transport http recoble https://mcp.recoble.com/s/<스페이스 ID>/mcp \
  --header "Authorization: Bearer <액세스 토큰>"

다른 도구에서도 같은 방식입니다. 연결 주소에 Authorization: Bearer <액세스 토큰> 헤더를 붙여 HTTP 방식 MCP 서버로 등록합니다.

✋ 참고: 액세스 토큰은 비밀번호와 같습니다. 가진 사람은 누구나 이 스페이스 데이터에 접근할 수 있습니다. 저장소나 채팅에 올리지 말고, 유출되면 즉시 해지하세요.

사용할 수 있는 도구

AI 앱은 아래 도구 가운데 연결 권한에 맞는 것을 받아, 요청에 맞게 골라 씁니다. 한 도구가 여러 동작을 하면 괄호 안에 동작 이름(method)을 적었습니다.

읽기 연결에는 "읽기" 표시가 된 도구만 들어갑니다.
캘린더·메일·채팅·대시보드 도구는 그 기능을 허용했을 때만 들어갑니다.

스페이스
- get_connection_info — 연결된 스페이스와 계정, 연결된 메일 계정 이름을 확인합니다. (읽기)
- list_space_children — 사이드바에서 한 단계 아래의 노트·워크보드를 순서대로 봅니다. (읽기)
- reorder_children — 사이드바 순서를 바꾸거나 다른 곳의 항목을 옮겨 옵니다. (쓰기)
- get_task_result — 시간이 오래 걸리는 작업(예: 큰 검색)의 결과를 받아 옵니다. (읽기)

노트
- list_notes — 노트 목록을 봅니다. 최근 만든·고친·본 노트, 태그, 즐겨찾기, 하위 노트로 좁힐 수 있습니다. (읽기)
- search_notes — 제목과 본문에서 노트를 찾습니다. (읽기)
- read_note — 노트 본문을 읽습니다. 긴 노트는 제목 단위나 일부분만 읽을 수 있습니다. (읽기)
- note_read (tree, find, headings, tags) — 노트 계층, 한 노트 안에서 찾기, 제목 목록, 태그 목록을 봅니다. (읽기)
- note_write (create, update) — 새 노트를 만들거나 제목·아이콘·위치·고정·즐겨찾기·태그를 바꿉니다. (쓰기)
- edit_note — 본문의 일부(섹션, 문장, 목록 항목 등)만 고칩니다. 나머지 본문은 그대로 둡니다. (쓰기)
- update_note_content — 본문 전체를 새로 쓰거나, 맨 앞·맨 뒤에 내용을 붙입니다. (쓰기)
- note_delete — 노트를 휴지통으로 옮깁니다. (쓰기)
- publish_note · unpublish_note — 노트를 웹에 게시해 공개 링크를 만들거나 게시를 멈춥니다. (쓰기)

워크보드
- list_workboards — 워크보드 목록을 보고, 이름이나 항목 키(예: REC)로 보드를 찾습니다. (읽기)
- list_workboard_items — 보드의 항목을 검색·필터합니다(상태, 우선순위, 담당자, 만든 날짜, 마감 임박 등). (읽기)
- workboard_read (get, statuses, fields, critical_path) — 보드 설정, 상태 목록, 사용자 정의 필드, 주경로(가장 긴 의존 경로)를 봅니다. (읽기)
- item_read (mine, get, comments) — 내 담당 항목, 항목 하나의 전체 내용, 항목 댓글을 봅니다. (읽기)
- workboard_write (create, update) — 워크보드를 만들거나 이름·설명·기간·보기 설정을 바꿉니다. (쓰기)
- workboard_setup (status_create, status_update, field_create) — 상태를 추가·변경하거나 사용자 정의 필드를 추가합니다. (쓰기)
- update_workboard_field — 사용자 정의 필드의 이름과 선택지를 바꿉니다. (쓰기)
- item_write (create, update, comment_create) — 항목을 만들거나 고치고, 댓글을 남깁니다. (쓰기)
- item_delete — 항목을 휴지통으로 옮깁니다(30일 안에 휴지통에서 복원). (쓰기)
- workboard_delete (delete, status_delete) — 워크보드를 휴지통으로 옮기거나 상태 하나를 지웁니다. (쓰기)
- delete_workboard_item_comment — 내가 잘못 단 댓글을 지웁니다. 되돌릴 수 없습니다. (쓰기)

연결(링크)
- link_read (types, list, graph) — 연결 유형, 한 항목의 연결 목록, 주변 연결 그래프를 봅니다. (읽기)
- link_write (type_create, create, trace_view_save) — 연결 유형을 만들고, 노트·항목·워크보드·일정을 서로 연결하고, 추적표를 저장합니다. (쓰기)
- link_delete — 연결 하나를 지웁니다. 되돌릴 수 없습니다. (쓰기)

이미지와 첨부
- image_read (image, attachment) — 노트·항목에 있는 이미지를 보거나, 첨부한 PDF·글 파일의 내용을 읽습니다. (읽기)
- image_write (upload, attach) — 이미지를 올려 노트 본문, 항목 설명, 항목 댓글에 넣습니다. (쓰기)

캘린더 (허용했을 때)
- list_calendar_events — 기간 안의 일정을 봅니다. 아무 조건이 없으면 오늘 일정입니다. (읽기)
- calendar_read (search_events, calendars) — 일정을 검색하거나 내 캘린더 목록을 봅니다. (읽기)
- calendar_write (event_create, calendar_create, calendar_update) — 일정을 만들고, 캘린더를 만들거나 설정을 바꿉니다. (쓰기)
- calendar_edit (event_update, occurrence_update) — 일정을 고칩니다. 반복 일정은 전체 또는 한 회차만 고칠 수 있습니다. (쓰기)
- calendar_delete (event_delete, occurrence_exclude, calendar_delete) — 일정을 지우거나, 반복 일정의 한 회차를 빼거나, 캘린더를 지웁니다. (쓰기)

메일 (허용했을 때)
- email_read (accounts, list, search, unread_counts) — 연결된 메일 계정, 폴더의 메일 목록, 메일 검색, 안 읽은 메일 수를 봅니다. (읽기)
- get_email — 메일 한 통의 전체 내용을 읽습니다. (읽기)
- email_send — 새 메일을 보냅니다. (쓰기)
- email_respond (reply, forward) — 받은 메일에 답장하거나 전달합니다. (쓰기)
- email_write (mark_read, save_as_note) — 메일을 읽음·안 읽음으로 표시하거나 노트로 저장합니다. (쓰기)
- email_delete (delete, empty_folder) — 메일을 휴지통으로 옮기거나 폴더를 비웁니다. (쓰기)

채팅 (허용했을 때)
- chat_read (list, messages, search, mentions, thread) — 내가 속한 채널·대화의 목록, 메시지, 검색 결과, 나를 멘션한 메시지, 스레드 답글을 봅니다. (읽기)
- chat_send — 대화에 메시지를 보냅니다. 받는 사람에게 알림이 갑니다. (쓰기)

대시보드 (허용했을 때)
- dashboard_read (list, get) — 내 대시보드 목록과 한 대시보드의 위젯 설정을 봅니다. (읽기)
- dashboard_create — 여러 워크보드의 데이터를 모아 차트 대시보드를 만듭니다. (쓰기)
- update_dashboard — 대시보드 이름과 위젯 설정을 바꿉니다. 위젯 설정은 통째로 바뀝니다. (쓰기)

데이터를 지키는 장치

확인 후 실행: 메일 보내기·답장·전달·지우기, 채팅 보내기, 노트 지우기 같은 동작은 확인 표시 없이 부르면 아무 일도 일어나지 않습니다. 그래서 AI 앱은 먼저 대상과 내용을 보여 주고 사용자의 확인을 받은 뒤 실행합니다.
휴지통: 노트·워크보드·항목을 지우면 휴지통으로 옮겨집니다. 화면에서는 바로 사라지지만 휴지통에서 되살릴 수 있습니다. 메일을 지우거나 폴더를 비울 때도 메일은 휴지통으로 옮겨집니다.
되돌릴 수 없는 동작: 연결(링크) 지우기와 항목 댓글 지우기는 되돌릴 수 없습니다.
버전 기록: 노트 본문을 새로 쓰거나 고쳐도 이전 내용은 노트의 버전 기록에 남습니다.
호출 한도: 연결(토큰)마다 1분에 읽기 100번, 쓰기 30번, 보내기·지우기 5번(하루 50번)까지 부를 수 있습니다. 넘으면 잠시 뒤 다시 시도하라는 안내가 돌아옵니다.

연결 관리하기

연결된 앱: 스페이스 설정 › 연결 › 연결된 앱 에서 로그인으로 연결한 AI 앱 목록을 봅니다. 앱·스페이스·권한·연결일·최근 사용·상태가 표시됩니다. 더 이상 쓰지 않는 앱은 연결 해제 를 누르면 즉시 차단됩니다.
액세스 토큰: AI 도구 연결 의 토큰 목록에서 토큰마다 권한·접근 가능 기능·만료일·최근 사용을 볼 수 있습니다. 해지 를 누르면 그 토큰을 쓰는 모든 연동이 즉시 끊깁니다.

잘 쓰는 방법

익숙한 일부터 시작하세요. 노트 찾기·요약처럼 읽기 위주의 요청으로 시작하면 AI 앱이 어떻게 움직이는지 알기 쉽습니다.
이름을 구체적으로 말하세요. "그 노트" 보다 "'3분기 로드맵' 노트", "백로그" 보다 "'개발 백로그' 보드" 처럼 말하면 엉뚱한 대상을 고르는 일이 줄어듭니다.
필요한 만큼만 허용하세요. 조회만 할 거라면 읽기 토큰을 쓰고, 캘린더·메일·채팅·대시보드는 쓸 때만 허용하세요.
큰 변경은 먼저 계획을 물어보세요. 여러 항목을 한꺼번에 바꾸기 전에 "무엇을 바꿀지 먼저 보여 줘" 라고 요청하면 실수를 줄일 수 있습니다.

자주 묻는 질문(FAQ)

어떤 AI 앱을 연결할 수 있나요?

원격 MCP 서버(HTTP)를 지원하는 AI 앱이면 연결할 수 있습니다. 로그인(OAuth)으로 연결하는 앱은 연결 URL만 있으면 되고, 헤더를 넣는 방식의 도구는 액세스 토큰을 함께 씁니다.

한 번 연결로 여러 스페이스를 쓸 수 있나요?

아니요. 연결 하나는 스페이스 하나에만 접근합니다. 다른 스페이스도 쓰려면 그 스페이스의 연결 URL로 하나 더 연결하세요.

캘린더나 메일 도구가 보이지 않아요.

캘린더·메일·채팅·대시보드는 기본 스페이스로 연결하고 그 기능을 허용했을 때만 들어갑니다. 로그인 연결은 연결 허용 화면의 내 계정 기능도 허용 을, 액세스 토큰은 AI 기능 접근 을 확인하세요. 메일 도구를 쓰려면 Recoble에 메일 계정이 연결되어 있어야 합니다.

조회만 하도록 연결하고 싶어요.

읽기 권한으로 발급한 액세스 토큰을 쓰세요. 이 연결에는 찾고 읽는 도구만 들어가서 아무것도 바꿀 수 없습니다.

AI 앱이 "도구가 없다"고 해요.

새 대화를 시작하거나 커넥터를 다시 연결해 보세요. 그래도 안 되면 연결된 앱 목록이나 토큰 목록에서 연결 상태가 활성 인지, 토큰이 만료되지 않았는지 확인하세요.

다른 사람이 내 연결로 데이터를 볼 수 있나요?

연결은 그 연결을 만든 사람의 계정 권한으로 동작합니다. 액세스 토큰을 다른 사람에게 주면 그 사람도 같은 권한을 갖게 되니 공유하지 마세요.

연결을 해제하면 어떻게 되나요?

해제하거나 해지하는 즉시 그 연결로는 더 이상 Recoble에 접근할 수 없습니다. 다시 쓰려면 새로 연결하세요.