Buddy를 ChatGPT, Claude, Claude Code에 연결하기

Buddy의 MCP 서버를 쓰면 AI 에이전트가 Buddy AI Note의 할 일, 오늘의 노트, 파일, 캘린더를 다룰 수 있고, 이메일과 문체가 필요한 일은 Buddy에게 맡길 수 있습니다. 설치할 것은 없습니다. 앱에 URL 하나를 추가하고 브라우저에서 Buddy에 로그인하면 됩니다.

서버 URL

https://ainote.tech/api/mcp

앱이 처음 연결할 때 Buddy 로그인 페이지가 열립니다. Buddy AI Note 계정으로 로그인하고 접근을 허용하세요. 복사할 키는 없습니다.

Claude Code

  1. 1

    서버를 추가합니다.

    claude mcp add --transport http buddy https://ainote.tech/api/mcp
  2. 2
    /mcp를 실행하고 buddy를 선택한 뒤 인증합니다. 브라우저에서 Buddy 로그인 페이지가 열립니다.
  3. 3
    Claude Code로 돌아오면 Buddy의 도구를 쓸 수 있습니다. 먼저 다음 할 일을 물어보세요.

Claude

  1. 1
    사용자 지정, 커넥터 순서로 열고 사용자 지정 커넥터 추가를 선택합니다.
  2. 2
    이름을 Buddy AI Note로 정하고 서버 URL을 붙여 넣은 뒤 추가합니다.
  3. 3
    연결한 뒤 열리는 창에서 Buddy에 로그인합니다.
  4. 4
    대화에서 Claude에게 Buddy를 사용해 달라고 요청하세요. 허용하기 전까지 Claude는 도구를 쓸 때마다 확인합니다.

무료 플랜에서는 사용자 지정 커넥터를 하나만 추가할 수 있습니다. Team과 Enterprise 플랜에서는 Owner가 먼저 추가합니다. Anthropic 가이드를 참고하세요.

ChatGPT

  1. 1
    설정을 열고 앱(Apps 또는 Plugins로 표시)을 찾습니다. 직접 앱을 추가할 수 없다면 먼저 고급 설정에서 개발자 모드를 켭니다.
  2. 2
    새 앱을 만들고 이름을 Buddy AI Note로 정한 뒤, 서버 URL을 붙여 넣고 인증 방식으로 OAuth를 선택합니다.
  3. 3
    열리는 창에서 Buddy에 로그인합니다.
  4. 4
    대화에서 ChatGPT에게 Buddy AI Note를 사용해 달라고 요청하세요. 앱 권한 설정에 따라 무언가를 바꾸는 작업 전에 확인을 요청합니다.

직접 앱을 추가할 수 있는지는 ChatGPT 플랜과, 워크스페이스라면 관리자 설정에 따라 다릅니다. OpenAI 가이드를 참고하세요.

기타 MCP 클라이언트

Streamable HTTP 원격 MCP 서버와 OAuth 로그인을 지원하는 앱이라면 위 URL로 연결할 수 있습니다. OAuth를 지원하지 않는 앱이라면 Buddy의 연동, API 키에서 키를 만들어 헤더로 보내세요.

Authorization: Bearer YOUR_API_KEY

에이전트가 할 수 있는 일

에이전트에게는 이 도구들과 각각 언제 쓰는지에 대한 짧은 안내가 보입니다. 할 일 도구는 할 일 ID의 앞 몇 글자만으로도 지정할 수 있습니다.

할 일

next지금 가장 먼저 할 일.
list_tasks상태, 단어, 프로젝트로 고른 할 일 목록.
list_projects프로젝트 목록.
get_task할 일과 메모. 맡긴 할 일이라면 Buddy의 진행 상황까지.
add_task할 일을 목록에 추가합니다.
update_task할 일의 제목, 메모, 상태, 마감일, 프로젝트를 바꿉니다.
complete_tasks할 일을 완료로 표시하고 결과를 메모로 남깁니다.
dismiss_tasks더 이상 필요 없는 할 일을 내려놓습니다.

Buddy에게 맡기기

delegate_task할 일을 Buddy에게 맡깁니다. 결과물은 파일에 만들어집니다.
wait_for_task맡긴 할 일을 Buddy가 끝낼 때까지 기다립니다.
ask캘린더, 이메일, 노트를 바탕으로 Buddy에게 질문합니다.
get_run시간이 걸리는 질문의 답.

오늘의 노트

get_notes하루 또는 기간을 지정한 오늘의 노트.
log오늘의 노트에 한 줄 추가합니다.

파일

list_files파일의 폴더 하나를 보여줍니다.
find_files이름, 종류, 날짜, 폴더로 파일을 찾습니다.
grep_files파일 안에서 어떤 문구가 나오는 곳을 찾습니다.
read_file파일의 본문. 승인 전 Buddy의 결과물은 미리보기 링크로 돌아옵니다.
review_fileBuddy의 문서를 승인 버튼과 함께 보여줍니다.
approve_file요청할 때 Buddy의 문서를 승인합니다. 크레딧을 씁니다.

캘린더, 이메일, 검색

list_events캘린더 일정.
create_event아무도 초대하지 않고 캘린더에 시간을 잡습니다.
search_emails이메일 스레드를 검색합니다.
search노트, 페이지, 문서를 의미로 검색합니다.

대화 안에서 Buddy의 문서 검토하기

Buddy가 문서를 건네면 에이전트는 review_file로 보여줄 수 있습니다. ChatGPT와 Claude에서는 대화 속 카드로 열립니다.

  1. 1
    미리보기를 한 페이지씩 읽어보세요. 승인하기 전까지 워터마크가 남아 있습니다.
  2. 2
    승인하고 워터마크 제거를 누릅니다. 크레딧은 한 번만 쓰이고, 카드에는 최종 본문이 표시됩니다.
  3. 3
    에이전트도 승인했다는 사실을 알게 되고(앱에 따라 메시지로 보내도록 요청합니다), 그때부터 최종 본문을 읽을 수 있습니다.

Claude Code처럼 카드를 표시하지 않는 앱에서는 에이전트가 미리보기 링크와 Buddy에서 승인하는 페이지를 알려줍니다.

내 손에 남는 것

내가 확인하지 않은 것은 다른 사람에게 가지 않습니다. 이메일 초안은 앱에서 나를 기다리고, 에이전트가 만든 일정에는 참석자가 없습니다.

승인 전 Buddy의 문서는 워터마크가 들어간 미리보기로 남습니다. 에이전트는 본문을 읽을 수 없고, 내가 요청할 때만 승인합니다.

할 일, 노트, 파일, 캘린더를 읽고 편집하는 것은 무료입니다. Buddy의 문서는 만들고 다시 만드는 것이 무료이고, 승인할 때 크레딧을 냅니다. Buddy에게 질문할 때도 크레딧을 쓰며, 가격은 앱과 같습니다.

문제 해결

Buddy 도구가 로그인되어 있지 않다고 합니다

다시 로그인하세요. Claude Code에서는 /mcp를 실행해 다시 인증합니다. ChatGPT나 Claude에서는 커넥터 연결을 해제한 뒤 다시 연결합니다.

미리보기 카드가 나타나지 않습니다

앱이 MCP Apps 카드를 표시하지 않거나, 에이전트가 파일을 읽는 방법을 택했습니다. review_file로 문서를 보여 달라고 요청하거나, 에이전트가 알려준 미리보기 링크를 여세요.

크레딧이 부족하다고 합니다

할 일 맡기기, 질문, 승인에는 크레딧이 필요합니다. 플랜과 크레딧을 확인하세요.

그래도 해결되지 않나요? 지원팀에 문의하세요.

더 알아보기

AI 에이전트에서 Buddy 쓰기: 개요와 bnote CLI