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

무료 사용자는 자신의 AI 클라이언트가 만든 정형 카드 데이터를 nado_save_flashcard로 저장하고, 저장된 카드로 퀴즈와 쓰기 연습을 만들 수 있습니다.

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

Pro/Admin 사용자는 nado_analyze_and_save_flashcard로 Nado AI가 검증된 뜻, 뉘앙스, 예문, 변형 표현을 생성해 저장하는 품질 경로를 사용할 수 있습니다.

Nado MCP

Nado MCP 설치 및 사용 가이드

ChatGPT, Claude, Codex, OpenCode 같은 AI 클라이언트에서 Nado Language 단어장을 연결합니다. 사용자의 AI가 만든 카드 내용을 저장하거나, Pro/Admin 사용자는 Nado AI가 검증한 품질 카드 생성을 사용할 수 있습니다.

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

설치

가장 넓은 배포 경로는 npm입니다. Homebrew와 Chocolatey는 패키지 등록 후 같은 CLI를 감싸는 설치 경로로 사용할 수 있습니다.

npm

npm install --global @nado-language/mcp

macOS Homebrew

brew tap nado-language/tap
brew install nado-mcp

Windows Chocolatey

choco install nado-mcp -y

AI 초보자 기준 사용자는 "Nado MCP 설치하고 로그인해줘"라고 요청하면 됩니다. AI 에이전트는 패키지 설치 후 아래 연결 명령을 실행하면 됩니다.

클라이언트 연결

Nado MCP는 특정 AI 앱 전용이 아니라 표준 stdio MCP 서버입니다. 자동 등록을 지원하는 클라이언트는 한 줄로 연결하고, 그 외 클라이언트는 표준 MCP JSON을 출력해 붙이면 됩니다.

클라이언트	명령	설명
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 서버를 추가합니다.
기타 MCP 클라이언트	`nado-mcp config`	stdio command, generic `mcpServers` JSON, OpenCode JSON을 출력합니다.

nado-mcp connect codex
nado-mcp connect claude
nado-mcp connect opencode
nado-mcp config

이용 방법

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

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

도구	용도
`nado_whoami`	현재 연결된 Nado 계정과 프로필을 확인합니다.
`nado_save_flashcard`	사용자의 AI가 생성한 정형 flashcard를 저장합니다. 무료 사용자도 사용합니다.
`nado_analyze_and_save_flashcard`	Pro/Admin 전용. Nado AI가 뜻, 뉘앙스, 예문, 변형 표현을 생성하고 저장합니다.
`nado_list_study_items`	저장된 단어와 문장 카드를 조회합니다.
`nado_generate_practice`	저장된 카드만 사용해 퀴즈, 쓰기, 회화, 문장 완성, 번역 연습을 만듭니다.

사용 예시

1. 단어 저장

무료 사용자는 AI 클라이언트가 아래처럼 구조화된 값을 만들어 nado_save_flashcard로 저장합니다.

{
  "original": "take over",
  "type": "phrase",
  "definition": "이어받다, 장악하다",
  "inlineDefinition": "이어받다",
  "explanation": "역할이나 책임을 넘겨받을 때 쓴다.",
  "exampleSentences": ["She will take over as project lead next month."],
  "contextSentence": "She will take over as project lead next month."
}

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

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

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

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

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

무료와 Pro 기능 차이

무료 사용자는 자신의 AI로 카드 내용을 만들고 Pro와 Admin 사용자는 Nado AI 품질 생성 경로를 사용할 수 있다는 비교 — 이미지 추적 ID: `mcp-pricing-boundary`. 가격 정책 또는 기능 경계가 바뀌면 이미지 파일명과 manifest를 함께 갱신합니다.

구분	무료 사용자	Pro/Admin 사용자
카드 내용 생성	사용자의 AI 클라이언트가 생성	Nado AI가 검증된 품질로 생성 가능
저장	`nado_save_flashcard` 사용 가능	무료 저장 경로 + Nado AI 저장 경로 사용 가능
연습	저장된 카드 기반 퀴즈, 쓰기, 회화, 문장 완성, 번역 사용 가능	동일하게 사용 가능
품질 책임	사용자의 AI와 프롬프트 품질에 의존	Nado가 CEFR, 한국어 설명, 예문, 변형 표현 품질을 통제
Nado AI 비용	발생하지 않음	Pro/Admin 권한으로 통제

이미지와 문서 연결 추적

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