ChatGPT와 Claude 연동하기 (MCP)

투두리(toodoori)를 ChatGPT와 Claude에 연결하면 대화로 할 일을 보고 정리할 수 있습니다. 연결에는 MCP(Model Context Protocol, AI 앱이 외부 서비스의 기능을 쓰는 표준)를 씁니다. 연결된 앱은 허용한 권한 안에서만 투두리의 작업을 읽고 바꿉니다.

연결하면 ChatGPT나 Claude에게 이렇게 요청할 수 있습니다.

“이번 주 마감인 작업 보여줘”, “이 프로젝트에 ‘리뷰 요청’ 작업 만들어줘”, “끝낸 작업들 완료로 옮겨줘”

연결 방법은 네 가지입니다.

ChatGPT: 사용자 지정 MCP 서버를 추가하고 투두리에 로그인합니다. ChatGPT 대화에서 투두리 도구를 쓸 수 있습니다.
claude.ai 커넥터: 연결 주소를 넣고 투두리에 로그인합니다. 설치할 것이 없어 대부분은 이 방법이 편합니다.
Claude Code: 명령 한 줄로 연결 주소를 등록하고 브라우저에서 투두리에 로그인합니다. 토큰을 발급하지 않아도 됩니다.
개인 액세스 토큰: 토큰(PAT)을 발급하고, Claude Code나 Claude 데스크톱 앱에서 투두리 MCP 서버를 내 컴퓨터에서 직접 실행합니다. 내 컴퓨터의 파일을 경로로 첨부하려면 이 방법을 씁니다.

ChatGPT에 연결하기

준비할 것

투두리 계정
ChatGPT 계정: 사용자 지정 MCP 서버를 추가할 수 있어야 합니다.

아래 절차는 2026-10-11에 ChatGPT Pro 계정의 개발자 모드에서 확인했습니다. 메뉴와 이용 조건이 달라지면 OpenAI의 ChatGPT 연결 안내를 확인합니다.

1단계: 사용자 지정 MCP 서버 추가하기

ChatGPT 플러그인 페이지를 열고 오른쪽 추가 메뉴에서 사용자 지정 MCP 서버 추가를 고릅니다.
이름에 Toodoori, 설명에 투두리의 작업을 조회하고 관리합니다를 입력합니다. MCP 서버 주소에는 아래 주소를 넣습니다.

https://api.toodoori.com/mcp

인증 방식은 OAuth로 둡니다. 고급 OAuth 설정은 자동으로 찾은 값을 유지합니다. 클라이언트 ID나 비밀값을 직접 입력할 필요는 없습니다.
기본 권한 범위의 read, write 선택을 유지하고, 필수 권한 범위에 offline_access를 입력합니다.
위험 안내를 확인한 뒤 플러그인 생성을 누릅니다.

생성을 마치면 추가한 Toodoori 플러그인 화면이 열립니다.

2단계: 투두리에 로그인하고 권한 고르기

플러그인을 만든 뒤 연결을 계속합니다. 투두리 화면이 열리면 로그인합니다.
연결할 투두리 계정이 맞는지 확인합니다. 앱 이름은 ChatGPT, 앱 주소는 chatgpt.com인지 확인합니다.
필요한 권한을 고릅니다. 조회만 하려면 읽기만, 작업을 만들고 바꾸려면 읽기와 쓰기를 고릅니다.
허용을 누릅니다. ChatGPT로 돌아오면 연결된 계정과 OAuth 인증 표시를 확인할 수 있습니다.

다른 투두리 계정으로 연결하려면 허용하기 전에 다른 계정으로 연결을 누릅니다.

3단계: 대화에서 연결 확인하기

플러그인 화면에서 채팅에서 사용해 보기를 누릅니다. 새 채팅에서는 @로 Toodoori를 선택할 수도 있습니다.
아래와 같이 요청합니다.

투두리 프로젝트 목록 보여줘

ChatGPT가 투두리 도구를 사용하고 프로젝트 목록을 보여주는지 확인합니다. 연결한 뒤에는 작업 조회와 생성, 수정도 대화로 요청할 수 있습니다. 작업을 바꾸려면 투두리 연결 권한을 읽기와 쓰기로 허용해야 합니다.

claude.ai 커넥터로 연결하기

준비할 것

투두리 계정
Claude 계정: Anthropic 안내에 따르면 사용자 지정 커넥터는 Free, Pro, Max, Team, Enterprise 요금제에서 쓸 수 있고, Free 요금제는 1개까지 추가할 수 있습니다.

1단계: 커넥터 추가하기

claude.ai에서 설정을 열고 커넥터 화면으로 갑니다.
추가를 누르고 사용자 지정 커넥터를 고릅니다.
이름은 투두리처럼 알아보기 쉽게 적고, 주소에 아래 연결 주소를 넣습니다.

https://api.toodoori.com/mcp

추가한 커넥터에서 연결을 누릅니다.

Team, Enterprise 요금제에서는 조직 설정의 커넥터 화면에서 관리자가 추가합니다. 메뉴 이름과 위치는 Claude 화면이 바뀌면 달라질 수 있습니다. 최신 순서는 Anthropic 도움말 Get started with custom connectors using remote MCP에서 확인할 수 있습니다.

연결 주소는 투두리 마이페이지의 연동 탭에서도 복사할 수 있습니다.

2단계: 투두리에 로그인하고 권한 고르기

연결을 누르면 투두리 화면이 열립니다. 로그인하지 않은 상태라면 로그인부터 하고, 로그인하면 연결 확인 화면으로 돌아옵니다. 이 화면에서 다음을 확인합니다.

앱: 연결하려는 앱입니다. claude.ai에서 연결했다면 claude.ai가 보입니다.
계정: 연결할 투두리 계정입니다. 다른 계정에 연결하려면 다른 계정으로 연결을 누릅니다.
돌아갈 곳: 허용한 뒤 돌아갈 주소입니다.
권한: 둘 중 하나를 고릅니다.
- 읽기만: 작업과 회고를 볼 수만 있습니다.
- 읽기와 쓰기: 보기에 더해 작업을 만들고, 고치고, 옮기고, 보관하고, 지울 수 있습니다.

허용을 누르면 Claude로 돌아가고 연결이 완료됩니다. 권한을 바꾸려면 마이페이지에서 연결을 해제한 뒤 Claude에서 다시 연결합니다.

모르는 앱이거나 돌아갈 곳이 예상과 다르면 거부를 누릅니다. 다음 두 경우에는 연결 확인 화면에 경고가 함께 보입니다. 앱이 스스로 등록해 이름을 확인할 수 없을 때와, 이 컴퓨터의 프로그램으로 돌아갈 때입니다. 직접 연결을 시작한 앱인지 확인한 뒤 허용합니다.

3단계: 대화에서 쓰기

대화 입력창 왼쪽 아래의 + 버튼에서 커넥터를 열고 투두리를 켭니다. Claude 설정의 커넥터 화면에서는 도구마다 바로 쓸지, 쓸 때마다 승인을 받을지 정할 수 있습니다. 작업을 바꾸는 도구를 승인받도록 설정하면 Claude가 무엇을 하려는지 확인하고 허용할지 정할 수 있습니다.

Anthropic 안내에 따르면 claude.ai에서 추가한 커넥터는 같은 Claude 계정의 데스크톱 앱과 모바일 앱에서도 쓸 수 있습니다. 투두리 로그인은 claude.ai 웹에서 하는 것을 권합니다.

Claude Code에서 연결하기

Claude Code에서도 토큰을 발급하지 않고 같은 연결 주소로 연결할 수 있습니다. 로그인과 권한 선택은 claude.ai 커넥터와 같습니다.

터미널에서 투두리를 사용자 범위로 등록합니다. 모든 프로젝트에서 쓸 수 있고, 설정 파일에는 주소만 저장되고 토큰은 들어가지 않습니다.

claude mcp add --transport http --scope user toodoori https://api.toodoori.com/mcp

Claude Code를 실행하고 /mcp를 입력한 뒤, 목록에서 toodoori를 골라 Authenticate를 누릅니다.
브라우저에 투두리 연결 확인 화면이 열립니다. claude.ai 커넥터의 2단계처럼 계정과 권한을 확인하고 허용을 누르면 Claude Code로 돌아옵니다.

Claude Code는 인증을 마친 뒤 이 컴퓨터의 프로그램으로 돌아오므로 연결 확인 화면에 경고가 함께 보입니다. /mcp에서 직접 연결을 시작했다면 허용해도 됩니다.

개인 액세스 토큰 방법으로 이미 toodoori를 등록했다면 다른 이름으로 등록하거나, claude mcp remove toodoori로 기존 등록을 지운 뒤 등록합니다.

연결 확인하고 해제하기

투두리 마이페이지의 연동 탭에 있는 연결된 AI 앱에서 연결한 앱, 고른 권한, 연결한 날, 마지막으로 쓴 날을 볼 수 있습니다. 연결 해제를 누르면 그 앱은 더 이상 투두리를 읽거나 바꿀 수 없습니다. 다시 쓰려면 연결한 앱에서 다시 연결합니다.

연동 탭에 연결 주소 대신 “지금은 새 AI 앱 연결을 받지 않아요”가 보이면 투두리가 잠시 새 연결을 받지 않는 상태입니다. 이미 연결한 앱은 같은 화면에서 확인하고 해제할 수 있습니다.

개인 액세스 토큰으로 연결하기

Claude Code나 Claude 데스크톱 앱에서 MCP 서버(@peoplenexteam/toodoori-mcp)를 내 컴퓨터에서 직접 실행하는 방법입니다. 내 컴퓨터의 파일을 경로로 첨부할 때 씁니다. 이 방법으로 보낸 요청도 PAT로 투두리 서버의 인증과 권한 검사를 거칩니다.

준비할 것

투두리 계정과 개인 액세스 토큰
Claude Code 또는 Claude 데스크톱 앱
Node.js (npx 실행용)

1단계: 개인 액세스 토큰 발급하기

toodoori.com에 로그인합니다.
마이페이지의 액세스 토큰 탭으로 갑니다.
토큰 발급을 눌러 이름을 적고, 필요한 권한(스코프)만 고르고, 만료 기간을 정합니다.
발급된 토큰(tdr_pat_...)을 복사합니다.

토큰은 발급 직후 한 번만 표시됩니다. 비밀번호처럼 안전한 곳(시크릿 매니저 등)에 보관하세요.

스코프는 작업, 프로젝트, 하위 프로젝트, 스테이지, 라벨, 사용자, 회고, 내보내기마다 읽기와 쓰기로 나뉩니다. 쓰기를 고르면 같은 항목의 읽기도 함께 켜집니다. 읽기만 필요하면 읽기만 고르고, 작업을 만들거나 바꿀 항목에만 쓰기를 켭니다.

2단계: Claude에 등록하기

Claude 데스크톱 앱

claude_desktop_config.json에 아래를 붙여 넣고, tdr_pat_...만 1단계에서 복사한 토큰으로 바꿉니다(주소는 그대로 둡니다).

{
  "mcpServers": {
    "toodoori": {
      "command": "npx",
      "args": ["-y", "@peoplenexteam/toodoori-mcp"],
      "env": {
        "TOODOORI_PAT": "tdr_pat_...",
        "TOODOORI_API_BASE": "https://api.toodoori.com"
      }
    }
  }
}

저장한 뒤 Claude 데스크톱 앱을 다시 시작하면 투두리 도구가 나타납니다.

이 설정 파일은 내 컴퓨터의 개인 폴더(~/Library/Application Support/Claude/)에 있어 코드 저장소(git)에는 올라가지 않습니다. 다만 토큰이 평문으로 저장되므로 꼭 필요한 권한만 고르고 만료 기간을 짧게 정합니다. 유출이 의심되면 바로 폐기하세요.

Claude Code

토큰 없이 연결하려면 위의 Claude Code에서 연결하기를 따릅니다. 토큰으로 연결할 때는 아래 순서를 따릅니다.

토큰을 명령에 직접 넣어 claude mcp add를 실행하면 그 프로젝트에서만 동작하고, 토큰이 파일에 남아 실수로 git에 올라갈 수 있습니다. 아래처럼 토큰을 셸 환경변수로 두고 사용자 범위(--scope user)로 등록하면, 모든 프로젝트에서 쓰면서 토큰을 어떤 설정 파일에도 저장하지 않습니다.

먼저 셸 프로필(~/.zshrc 또는 ~/.bashrc)에 토큰을 추가합니다.

export TOODOORI_PAT="tdr_pat_..."
export TOODOORI_API_BASE="https://api.toodoori.com"

추가한 뒤 터미널을 새로 열거나 source ~/.zshrc를 실행합니다. 그다음 사용자 범위로 등록합니다(토큰을 명령에 넣지 않습니다).

claude mcp add --scope user toodoori -- npx -y @peoplenexteam/toodoori-mcp

등록 정보는 홈 디렉터리(~/.claude.json)에 저장되고 토큰은 들어가지 않습니다. MCP 서버는 실행될 때 위 환경변수를 그대로 물려받으므로, 환경변수가 설정된 터미널에서 claude를 실행합니다.

팀과 설정을 공유할 때는 토큰을 넣은 채로 --scope project(저장소의 .mcp.json)를 쓰지 마세요. 토큰 없는 설정만 커밋하고, 각자 셸 환경변수로 토큰을 넣도록 안내합니다. 토큰을 적어 둔 .env 같은 파일은 .gitignore에 추가합니다.

무엇을 할 수 있나요?

허용한 권한 안에서 다음 일을 할 수 있습니다.

보기: 프로젝트, 보드, 스테이지, 작업 검색과 상세, 라벨, 하위 프로젝트, 통계, 보관함, 회고, 자동화 규칙, 첨부
작업 정리: 작업 만들기, 고치기, 옮기기(한 개나 여러 개), 보관과 복원, 지우기, 라벨 바꾸기, 체크리스트, 노트, 관계, 외부 링크, 첨부 올리기
구성: 라벨 만들기, 하위 프로젝트와 노트, 프로젝트 브리프, 자동화 규칙
회고와 내보내기: 회고 쓰기와 고치기, 회고와 작업을 마크다운으로 내보내기, 내보내기 템플릿

읽기만 허용했거나 해당 스코프가 없으면 바꾸는 요청은 거부됩니다. 회원 탈퇴, 결제와 구독, 액세스 토큰 관리, 연결된 앱 관리, 공간, Jira 연동은 연결한 앱으로 할 수 없습니다. 투두리에 로그인해서 직접 합니다.

알아두면 좋은 규약

마감일은 expectedEnd로 표현됩니다.
작업 본문, 회고, 노트는 마크다운 문자열로 주고받습니다.
프로젝트와 하위 프로젝트 ID는 인코딩된 문자열입니다. 임의로 만들지 말고 목록 도구가 돌려준 id를 그대로 씁니다.
오류는 { error, code, status } 형태로 돌아오고, 연결된 앱은 code를 보고 요청을 고쳐 다시 시도합니다.

보안 주의

연결된 앱과 액세스 토큰은 쓰지 않게 되면 바로 해제하거나 폐기합니다.
필요한 최소 권한만 허용하고, 토큰은 만료 기간을 짧게 둡니다.
PAT는 헤더로만 보냅니다. URL이나 코드 저장소에 노출하지 마세요.
토큰이 유출됐다면 마이페이지의 액세스 토큰 탭에서 바로 폐기하거나 회전(새 토큰을 발급하고 기존 토큰을 즉시 무효화)합니다.

다음 단계

연결했다면 ChatGPT나 Claude에게 오늘 볼 작업이나 정리할 작업을 물어보세요. 대화에서 만들고 옮긴 작업도 보드와 지난 작업에 그대로 남습니다.

보드를 아직 만들지 않았다면 toodoori로 칸반 시작하기부터 따라 해 보세요.
AI와 나눈 대화에서 얻은 결론을 작업에 남기는 방법은 AI 작업 기록, 어디에 남길까에 정리했습니다.
끝낸 작업은 지난 작업과 보관함에서 다시 볼 수 있습니다.

ChatGPT와 Claude 연동하기 (MCP)

ChatGPT에 연결하기

준비할 것

1단계: 사용자 지정 MCP 서버 추가하기

2단계: 투두리에 로그인하고 권한 고르기

3단계: 대화에서 연결 확인하기

claude.ai 커넥터로 연결하기

준비할 것

1단계: 커넥터 추가하기

2단계: 투두리에 로그인하고 권한 고르기

3단계: 대화에서 쓰기

Claude Code에서 연결하기

연결 확인하고 해제하기

개인 액세스 토큰으로 연결하기

준비할 것

1단계: 개인 액세스 토큰 발급하기

2단계: Claude에 등록하기

Claude 데스크톱 앱

Claude Code

무엇을 할 수 있나요?

알아두면 좋은 규약

보안 주의

다음 단계

첫 번째 칸, 여기서부터