무료 사용자도 Nado MCP를 쓸 수 있나요?

무료 사용자는 nado_save_article로 읽기 자료를 무제한 저장하고, 이미 Nado 안에 저장된 카드로 퀴즈와 쓰기 연습을 만들 수 있습니다. MCP는 새 암기 카드를 만들지 않습니다.

Pro 사용자는 무엇이 다른가요?

MCP 기준으로 아티클 저장은 무료/무제한입니다. Pro 기능은 Nado 앱 안의 AI 분석과 학습 흐름에서 제공되며, MCP는 카드 생성을 우회 제공하지 않습니다.

Nado MCP

Nado MCP 설치 및 사용 가이드

ChatGPT, Claude, Codex, OpenCode 같은 AI 클라이언트에서 Nado Language 읽기 자료와 기존 단어장 연습을 연결합니다. MCP는 읽기 자료를 무료로 저장하고, 새 암기 카드는 Nado 안에서 읽으면서 선택한 모르는 표현으로 만듭니다.

AI 클라이언트가 읽기 자료를 보내고 Nado MCP가 아티클로 저장한 뒤 기존 저장 카드로 퀴즈와 쓰기 연습을 만드는 흐름 — 이미지 추적 ID: `mcp-flow`. 이 이미지를 교체할 때는 guide-assets.json의 usedBy와 path를 함께 수정합니다.

설치

remote MCP를 지원하는 클라이언트는 설치 없이 Nado MCP URL을 연결할 수 있습니다. remote MCP를 아직 지원하지 않는 로컬 앱이나 CLI는 npm, Homebrew, Chocolatey 설치 경로를 사용합니다.

Remote MCP

https://ptbwzhxifxdnfmqsiugi.supabase.co/functions/v1/mcp

remote 연결은 표준 Streamable HTTP MCP 엔드포인트입니다. 클라이언트가 Bearer 토큰 또는 자체 OAuth 연결을 지원해야 개인 Nado 암기장 저장/조회가 가능합니다.

npm

npm install --global @nado-language/mcp

macOS Homebrew

brew tap jintonyc/tap
brew install nado-mcp

Windows Chocolatey

choco install nado-mcp -y

AI 초보자 기준 사용자는 "Nado MCP 설치하고 로그인해줘"라고 요청하면 됩니다. 설치 단계가 Codex Desktop, Claude Desktop, OpenCode, Cursor, Windsurf, Gemini CLI 설정을 자동 등록하고, 로그인은 브라우저에서 별도로 완료합니다.

클라이언트 연결

Nado MCP는 특정 AI 앱 전용이 아닙니다. 일반 사용자는 설치 또는 업데이트 후 로그인하고, AI 데스크톱 앱을 재시작한 다음 새 대화를 시작하면 됩니다. 설치 과정에서 Codex Desktop, Claude Desktop, OpenCode, Cursor, Windsurf, Gemini CLI 설정을 가능한 범위에서 자동 등록합니다.

npm install --global @nado-language/mcp@latest
nado-mcp login

remote MCP를 지원하는 클라이언트는 URL을 직접 연결하고, stdio만 지원하는 클라이언트는 로컬 서버 설치를 사용합니다. Codex에는 로컬 Nado Language 플러그인과 번들 MCP 정보도 함께 설치합니다.

클라이언트	명령	설명
Remote MCP	`https://ptbwzhxifxdnfmqsiugi.supabase.co/functions/v1/mcp`	Streamable HTTP 방식입니다. 클라이언트가 remote MCP와 Bearer 인증을 지원하면 별도 npm/brew 설치 없이 연결할 수 있습니다.
설치/업데이트	`npm install --global @nado-language/mcp@latest`	Codex Desktop, Claude Desktop, OpenCode, Cursor, Windsurf, Gemini CLI 설정을 가능한 범위에서 자동 등록합니다. Codex CLI가 있으면 `codex plugin add nado-language@nado-language`도 실행합니다. 브라우저 로그인은 열지 않습니다.
브라우저 로그인	`nado-mcp login`	Nado 웹 로그인으로 로컬 MCP 토큰을 저장합니다. Google, Kakao, Naver, Apple 등 Nado 웹 로그인 방식을 그대로 사용합니다.
재연결	`nado-mcp connect`	설치, 로그인, 앱 재시작 후에도 AI 앱이 Nado 도구를 보지 못할 때만 로컬 MCP 클라이언트를 다시 등록하고 브라우저 로그인을 시작합니다.
Codex 재연결	`nado-mcp connect codex`	Codex MCP 설정을 다시 쓰고 브라우저 로그인을 시작합니다. 일반 설치 흐름에서는 필요하지 않습니다.
Claude Desktop 재연결	`nado-mcp connect claude`	Claude Desktop 설정 파일에 `mcpServers` 항목을 다시 추가합니다.
OpenCode 재연결	`nado-mcp connect opencode`	`~/.config/opencode/opencode.json`의 `mcp` 설정에 local 서버를 추가합니다.
Cursor/Windsurf/Gemini 재연결	`nado-mcp connect cursor` `nado-mcp connect windsurf` `nado-mcp connect gemini`	각 클라이언트의 표준 `mcpServers` JSON 설정에 Nado 서버를 추가합니다.
기타 MCP 클라이언트	`nado-mcp config`	stdio command, `mcpServers` JSON, direct map JSON, `mcp_servers` JSON, OpenCode JSON을 출력합니다.

설치 또는 연결 후 이미 열려 있던 데스크톱 앱은 완전히 재시작하고 새 대화에서 확인해야 합니다. 로컬 MCP 도구는 대화 시작 시점에 로드되는 경우가 많습니다.

Codex에서 설정에는 보이는데 대화에 도구가 안 보일 때 Codex 설정 화면의 서버 목록은 등록 상태입니다. codex plugin list는 nado-language@nado-language, codex mcp list 또는 채팅/TUI의 /mcp는 nado_language 서버를 확인하는 진단입니다. 일반 사용 흐름에서는 필수 명령이 아닙니다. Windows에서는 Codex MCP 설정의 작업 중인 디렉토리/cwd를 비워 두세요. Nado 서버에는 필요 없고, ~/code처럼 존재하지 않거나 확장되지 않는 값은 stdio 서버 시작을 막을 수 있습니다.

이용 방법

브라우저 로그인은 로컬의 OS 사용자 설정 경로에 토큰을 저장합니다. MCP 서버는 실행될 때 이 파일을 자동으로 읽습니다.

nado-mcp login
nado-mcp status
nado-mcp logout

nado-mcp doctor는 문제 해결용 진단 명령입니다. 평소 사용에는 필요 없고, 로컬 서버 도구 노출, 클라이언트 설정 등록, 인증 토큰 상태를 분리해서 확인할 때만 사용합니다.

브라우저 로그인은 성공했지만 로컬 helper 연결이 브라우저 보안 정책 때문에 실패하면, 화면에 수동 코드 명령이 표시됩니다. 그 경우 표시된 nado-mcp login --code ... 명령을 같은 터미널에서 실행하면 됩니다. 이 코드는 계정 접근 권한을 포함하므로 공유하지 마세요.

도구	용도
`nado_whoami`	현재 연결된 Nado 계정과 프로필을 확인합니다.
`nado_update_study_item`	이미 Nado 안에 저장된 카드에 description, 설명, 뜻, 예문, 변형 표현을 추가하거나 수정할 때 사용합니다. 새 카드는 만들 수 없습니다.
`nado_save_article`	무료/무제한. "Nado 기사로 저장해줘", "아티클로 저장", "읽을 자료로 저장"처럼 전체 글이나 웹페이지 발췌를 읽기 자료로 저장할 때 사용합니다. `custom_articles`와 선택 highlight를 저장하며 암기장 카드는 만들지 않습니다.
`nado_list_study_items`	저장된 단어와 문장 카드를 조회합니다.
`nado_generate_practice`	"암기장에 있는 단어로 작문연습하자"처럼 저장된 카드 기반 연습 요청에서 사용합니다. 작문연습, 쓰기연습, 영작하기는 `writing` 모드로 처리합니다.

사용 예시

1. 읽기 자료 저장

무료 사용자는 AI 클라이언트가 전체 글이나 발췌를 nado_save_article로 저장합니다. 암기 카드는 이후 Nado 안에서 읽으면서 선택한 모르는 단어와 표현으로 만듭니다.

{
  "title": "Project handoff notes",
  "content": "She will take over as project lead next month. The team wrote down the full context before reviewing unknown phrases.",
  "source": "MCP",
  "selectedText": "take over"
}

2. 다른 글 저장

선택 문장을 함께 보내면 article highlight도 저장됩니다.

{
  "title": "Example Article",
  "content": "This article text is saved as reading material. Later, the learner can turn selected phrases into cards.",
  "source": "https://example.com/article",
  "selectedText": "selected phrases"
}

3. 저장된 단어로 퀴즈 만들기

{
  "mode": "vocabulary_quiz",
  "query": "take over",
  "limit": 3
}

4. 저장된 단어로 쓰기 연습

{
  "mode": "writing",
  "query": "take over",
  "limit": 3
}

지원되는 practice mode는 vocabulary_quiz, writing, conversation, sentence_completion, translation입니다. 모든 연습 결과는 어떤 저장 카드에서 나온 문제인지 알 수 있도록 sourceCardIds를 포함합니다.

무료와 Pro 기능 차이

MCP는 무료로 아티클을 저장하고 기존 카드 연습을 제공하며, 새 카드는 Nado 앱 안에서 만든다는 비교 — 이미지 추적 ID: `mcp-pricing-boundary`. 가격 정책 또는 기능 경계가 바뀌면 이미지 파일명과 manifest를 함께 갱신합니다.

구분	무료 사용자	Pro/Admin 사용자
아티클 저장	`nado_save_article` 무료/무제한	동일하게 사용 가능
새 카드 생성	Nado 앱에서 읽으면서 선택한 표현으로 생성	동일하게 앱 내부 학습 흐름 사용
연습	저장된 카드 기반 퀴즈, 쓰기, 회화, 문장 완성, 번역 사용 가능	동일하게 사용 가능
MCP 저장 경계	`custom_articles`와 `highlights`만 생성	동일하게 flashcards를 직접 생성하지 않음
Nado AI 비용	MCP 아티클 저장에는 발생하지 않음	MCP 아티클 저장에는 발생하지 않음

이미지와 문서 연결 추적

이 페이지의 이미지는 HTML의 data-guide-asset-id와 guide-assets.json manifest로 연결합니다. 이미지가 바뀌면 기존 파일을 덮어쓰지 말고 새 버전 파일명을 추가한 뒤 manifest의 path, usedBy, lastUpdated를 갱신합니다.