AI 에이전트 (MCP)
MCP는 모든 플랜에서 작동해요. Free와 Basic은 읽기 도구 10개를 모두 읽기 전용으로 쓸 수 있어요 (Free는 하루 100회 요청으로 제한돼요). Pro와 Ultra는 전체 읽기 및 쓰기 접근(도구 27개)을 쓰고, 원하면 읽기 전용 모드로 바꿀 수 있어요.
MCP(Model Context Protocol)를 쓰면 ChatGPT, Claude 같은 AI 어시스턴트와 코딩 어시스턴트, 자동화 도구를 TellDone 데이터에 바로 연결할 수 있어요. 연결하면 어시스턴트가 노트, 작업, 이벤트, 리포트, 태그, 변경 기록을 읽을 수 있어요. Pro 이상에서는 항목을 만들고, 수정하고, 삭제하고, 복원할 수도 있어요. 도구는 27개예요. 읽기용 10개(모든 플랜)와 쓰기용 17개(Pro 이상)예요.
iPhone에서 **설정 > 연동 > AI 에이전트 (MCP)**를 열면 액세스 토큰이 기본적으로 가려진 MCP 설정 화면이 나와요.

웹에서는 이렇게 보여요.

연결하는 두 가지 방법
AI 클라이언트를 연결하는 방법은 두 가지예요.
- TellDone으로 로그인 (OAuth) (추천) - TellDone 계정으로 로그인하고 앱이 요청하는 권한을 승인해요. ChatGPT와 Claude가 이 방식을 쓰며, 복사할 토큰이 없어요.
- Bearer 토큰 - 설정에서 액세스 토큰을 복사해 클라이언트 설정에 붙여넣어요. 스크립트, 명령줄 도구, 기본 OAuth 흐름이 없는 클라이언트에 가장 간단해요.
| 클라이언트 | 추천 방식 |
|---|---|
| ChatGPT (chatgpt.com 또는 ChatGPT 데스크톱 앱, 모바일 앱 제외) | OAuth - MCP URL로 사용자 지정 MCP 서버를 추가한 다음 로그인 |
| Claude (웹사이트, Desktop, iPhone 앱) / Cowork | OAuth - MCP URL로 사용자 지정 커넥터를 추가한 다음 로그인 |
| Claude Code (CLI) | 당분간은 Bearer 토큰 - 토큰을 넣어 Authorization 헤더를 추가 |
| 스크립트 또는 직접 만든 코드 | Bearer 토큰 - 자동화하기 가장 간단해요 |
| 목록에 있는 커넥터 중에서만 고를 수 있는 클라이언트 | MCP URL로 TellDone을 사용자 지정 커넥터로 추가하거나 Bearer 토큰을 사용하세요. TellDone은 아직 어떤 커넥터 디렉터리에도 없어요 |
플랜별 요구 사항
| 플랜 | MCP |
|---|---|
| Free | 읽기 전용 (읽기 도구 10개), 하루 100회 요청 |
| Basic | 읽기 전용 (읽기 도구 10개), 하루 한도 없음 |
| Pro | 읽기 및 쓰기 (도구 27개) - 읽기 전용 모드로 전환 가능 |
| Ultra | 읽기 및 쓰기 (도구 27개) - 읽기 전용 모드로 전환 가능 |
Free의 하루 100회 요청 한도는 도구 호출만 세어요. 연결, 로그인, 도구 목록 조회는 포함되지 않아요. 하루는 계정에 저장된 시간대를 따르고 자정에 초기화돼요. 한도에 도달하면 어시스턴트가 그렇다는 메시지를 받아요. 쓰기 도구는 Free와 Basic에서 거부돼요. 액세스 토큰을 쓰면 연결이 읽기 전용이고 만들기와 수정은 Pro 이상이 필요하다고 응답해요. 로그인(OAuth)을 쓰면 대부분 "Insufficient scope"로 응답해요. Free와 Basic 연결에는 쓰기 권한이 주어지지 않기 때문이에요.
앱 안의 화면
설정 > 연동을 열고 AI 에이전트 섹션에서 **AI 에이전트 (MCP)**를 누르세요. 화면에는 "ChatGPT, Claude 등 AI 어시스턴트가 TellDone의 노트, 작업, 이벤트를 다룰 수 있게 해요."라는 문구와 현재 플랜이 나와요.
- Free: "현재 플랜: 읽기 전용 접근, 하루 100회 요청. 쓰기는 Pro에서 가능해요."
- Basic: "현재 플랜: 읽기 전용 접근"
- Pro와 Ultra: "현재 플랜: 읽기 및 쓰기 접근"
MCP가 꺼져 있는 동안에는 활성화를 눌러 켜세요.
활성화하면 화면에 이런 항목이 나와요.
- 접근 모드 (Pro와 Ultra) - 언제든 읽기 전용이나 읽기 및 쓰기를 고를 수 있어요.
- 어시스턴트 연결 - ChatGPT, Claude, 다른 어시스턴트의 연결 단계예요. 어시스턴트 안에서 TellDone에 로그인하므로 토큰은 필요 없어요.
- 연결된 앱 - 연결한 어시스턴트 목록이고, 각각 연결 해제 버튼이 있어요. 첫 연결 전까지는 비어 있어요.
- 개발자용 (기본적으로 접혀 있음) - 액세스 토큰 필드(가려져 있고 보기 / 숨기기와 복사 포함), 토큰 재생성, 그리고 준비된 텍스트와 자체 복사 버튼이 있는 Claude Code / Cursor / 기타 전환이 있어요. Claude Code는
claude mcp add명령을, Cursor는.cursor/mcp.json용 JSON을, 기타는 서버 주소와 OAuth 로그인 옵션,Authorization: Bearer헤더를 알려줘요. 토큰이 가려져 있는 동안 스니펫에는YOUR_TOKEN이 들어 있어요. 보기를 누르면 실제 토큰이 들어가요.
웹에도 같은 컨트롤이 다른 배치로 있고, 접히는 개발자 섹션은 없어요. 복사 버튼이 있는 OAuth 주소, 토큰 컨트롤, 연결 해제가 있는 연결된 앱, 클라이언트 선택지가 여섯 개(Claude Code, Cursor, Windsurf, Codex, OpenClaw, cURL)인 Manual bearer token setup이에요. 웹에서는 토큰 필드가 숨겨져 있어도 스니펫에 항상 실제 토큰이 들어 있으니 토큰과 똑같이 다루세요.
- 문서 - 이 페이지로 가는 링크예요.
- 비활성화 - MCP를 꺼요. "연결된 모든 AI 도구의 접근이 해제돼요."라고 나오며 확인해요. 토큰이 삭제되고 모든 연결이 중지돼요. MCP를 다시 활성화하면 새 토큰이 발급되고, 로그인(OAuth)으로 연결한 앱은 다시 로그인하지 않아도 작동해요. 앱을 완전히 제거하려면 연결된 앱에서 연결 해제를 누르세요.
액세스 토큰은 비공개로 유지하세요. 토큰이 있는 사람은 누구나 TellDone 데이터에 접근할 수 있어요. 유출이 의심되면 토큰 재생성을 누르세요.
활성화하는 방법
두 플랫폼 어디서든 MCP를 설정할 수 있어요.
- iPhone: 설정 > 연동 > AI 에이전트 (MCP)
- 웹: app.telldone.app > 설정 > 연동 > AI agents (MCP)
단계는 이래요.
- 활성화를 누르세요.
- Pro와 Ultra에서는 접근 모드(읽기 전용 또는 읽기 및 쓰기)를 고르세요. Free와 Basic은 읽기 전용이에요.
- ChatGPT나 Claude를 연결하려면 어시스턴트 연결에서 해당 항목을 누르고 단계를 따르세요 (아래 참고). 토큰은 필요 없어요.
- iPhone에서 코딩 클라이언트를 쓰려면 개발자용을 열고 보기를 누른 다음 Claude Code, Cursor, 기타 중 하나를 고르고 스니펫 아래의 복사를 누르세요. 보기를 누르기 전에 복사하면 스니펫에 토큰 대신
YOUR_TOKEN이 들어 있어요. 웹에서는 Manual bearer token setup에서 클라이언트를 고르고 스니펫을 복사하세요. 이미 토큰이 들어 있어요. - 스니펫을 클라이언트나 설정 파일에 붙여넣으세요.
OAuth로 연결하기
ChatGPT, Claude, Cowork에는 OAuth를 추천해요. 토큰을 복사하는 대신 TellDone 계정으로 로그인해요.
OAuth용 MCP URL: https://api.telldone.app/mcp/user
같은 서버가 https://api.telldone.app/mcp/user/mcp에서도 응답하고, 두 주소 모두 Bearer 토큰을 받아요. OAuth 로그인에는 첫 번째 주소를 쓰세요.