공개 노트

Tilnote MCP Server - AI를 사용하다가 노트로 정리하거나 블로그 글 등으로 공유하고 싶을 때

2026-03-16Views 1,085약 6분

Summary

Claude, ChatGPT, 클로드 코드, 코덱스 같은 AI 를 쓰다 보면, 작업 중 떠오른 아이디어나 정리한 내용을 노트로 남기거나 블로그 글과 같은 공유 글로 공유하고 싶은 경우가 있습니다. 그런데 매번 브라우저를 열고 노트 앱이나 공유 서비스에 접속하는 것은 불편하죠.

Tilnote MCP Server는 이 문제를 해결합니다. AI 어시스턴트 안에서 바로 마크다운 노트인 틸노트 노트를 생성하고, 조회하고, 검색하고, 수정할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

그리고 이제 AI가 쓴 글을 대화창에서 바로 블로그로 발행할 수 있습니다. "이거 블로그에 올려줘" 한마디면 노트 작성부터 공개 발행까지 끝나고, 바로 접속 가능한 공개 URL이 나옵니다.

쓰는 흐름은 자연스럽게 이어집니다. AI와 작업하다 나온 결과를 노트로 남기고, 그중 남들과 나눌 만한 것을 블로그로 발행하는 것. 노트는 부담 없이 쌓고, 발행은 골라서 하면 됩니다.

연결에 필요한 건 URL 하나입니다. 설치도, API 키 발급도 없습니다.

https://tilnote.io/mcp

MCP가 뭔가요?

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구와 데이터에 접근할 수 있게 해주는 표준 프로토콜입니다. MCP 서버를 연결하면, AI가 단순한 대화를 넘어서 실제 서비스와 상호작용할 수 있게 됩니다.

Tilnote MCP Server를 연결하면 AI 어시스턴트에게 "이 내용을 틸노트에 저장해줘"라고 말하는 것만으로 노트가 생성됩니다.

연결하기

처음 연결할 때 틸노트 로그인 화면이 한 번 뜹니다. 로그인하고 권한을 허용하면 끝이고, 이후로는 다시 묻지 않습니다.

Claude (웹 / 데스크톱)

좌측 하단 프로필 → 설정 → 커넥터
커스텀 커넥터 추가
이름에 틸노트, URL에 https://tilnote.io/mcp
연결 → 틸노트 로그인 → 권한 허용

Claude Code

터미널에서 한 줄이면 됩니다.

claude mcp add --transport http tilnote https://tilnote.io/mcp

등록 후 /mcp 를 입력해 tilnote 를 선택하면 브라우저가 열리고 로그인이 진행됩니다.

OpenAI Codex CLI

터미널에서 등록합니다.

codex mcp add tilnote --url https://tilnote.io/mcp

설정 파일(~/.codex/config.toml)에 직접 적어도 됩니다.

[mcp_servers.tilnote]
url = "https://tilnote.io/mcp"

등록하면 Codex가 OAuth를 자동으로 감지하고 로그인 창을 띄웁니다. 나중에 다시 인증하려면 codex mcp login tilnote 를 쓰시면 됩니다.

원격 서버가 인식되지 않는다면 Codex 버전이 낮은 경우입니다. 업그레이드하시는 게 가장 확실합니다.

ChatGPT (웹)

ChatGPT는 커스텀 커넥터가 개발자 모드 안에 있습니다. 두 단계입니다.

설정 → 플러그인 → 개발자 모드 켜기
같은 플러그인 화면에서 검색창 오른쪽의 ⊕ 버튼 클릭 → URL에 https://tilnote.io/mcp 입력 → 인증 방식 OAuth

목록에 있는 Gmail·GitHub 같은 추천 플러그인 옆의 + 가 아니라, 화면 우측 상단 검색창 옆에 따로 있는 ⊕ 입니다. 이걸 못 찾아서 헤매는 경우가 많습니다.

예전에 "앱" 또는 "커넥터"로 불리던 메뉴가 플러그인으로 이름이 바뀌었습니다. 오래된 안내 글을 보고 계시다면 이 점만 바꿔 읽으시면 됩니다.

개발자 모드는 무료 요금제에서도 켤 수 있고, 노트 작성·블로그 발행 같은 쓰기 기능도 무료에서 그대로 동작합니다. 이 안내는 웹 버전 기준입니다.

Cursor, VS Code 등

원격 MCP를 지원하는 도구라면 대부분 설정 파일에 URL만 넣으면 됩니다. Cursor 기준 mcp.json:

{
  "mcpServers": {
    "tilnote": {
      "url": "https://tilnote.io/mcp"
    }
  }
}

Google Antigravity처럼 원격 MCP 지원 여부가 버전마다 다른 도구도 있습니다. 위 방식으로 연결되지 않는다면 아래 로컬 설치로 쓰시면 됩니다. 블로그 발행만 빼면 동일하게 동작합니다.

제공하는 도구

연결하면 도구 13개가 붙습니다. AI가 알아서 골라 쓰기 때문에 이름을 외울 필요는 없습니다.

도구	기능
`publish_note`	공개 블로그에 발행하고 URL 반환 (새 글이면 작성과 발행이 한 번에) 사용자가 액션을 승인해야만 발행됩니다.
`create_note`	마크다운 형식의 새 노트 생성 (초안 상태로 저장되고 나온 URL을 클릭해 편집하거나 공개 글로 공유할 수 있음)
`append_to_note`	기존 노트 끝에 이어쓰기 (전체를 다시 보내지 않아 빠릅니다)
`update_note`	기존 노트의 제목이나 내용 수정
`get_note`	페이지 ID로 노트 전체 내용 조회
`list_notes`	최근 노트 목록 확인
`search_notes`	키워드로 노트 검색
`create_book`	새 책 (book) 생성
`list_books`	책 목록 조회
`get_book`	특정 책 상세 조회 (포함된 노트 목록 포함)
`add_page_to_book`	기존 노트를 책에 추가
`remove_page_from_book`	책에서 노트 제거

활용 예시

설정을 마치면 AI 어시스턴트와 대화하듯 노트를 관리할 수 있습니다.

"오늘 회의 내용을 틸노트에 정리해줘"
"지난주에 작성한 React 관련 노트 찾아줘"
"이 코드 리뷰 내용을 노트로 저장해줘"
"기존 프로젝트 노트에 새로운 내용 추가해줘"
"지금 정리한 노트들을 'React 학습' 책으로 묶어줘"
"내 책 목록 보여줘"
"이 내용을 AI 활용법 책에 추가해줘"

발행까지 한 번에 시킬 수도 있습니다.

"방금 정리한 내용 틸노트에 블로그로 발행해줘. 태그는 Next.js, 성능최적화로"
"지난주에 쓴 도커 노트 찾아서, 오늘 배운 멀티스테이지 빌드 부분 뒤에 이어서 추가해줘"

코딩 작업 중 컨텍스트를 전환하지 않고도 자연스럽게 노트를 관리할 수 있다는 점이 가장 큰 장점입니다.

노트 저장 예시

현재 코드 베이스를 바탕으로 틸노트에 대해 소개하는 글을 써줘.

결과로 나온 URL을 누르면 틸노트로 이동해서 편집 가능. (기본 비공개)

확인 후 블로그 글로 공유하거나 공유 링크가 있는 사람들만 접근할 수 있는 공유 글로 만들어서 공유할 수 있습니다. 모든 노트는 마크다운 (.md) 파일로 다운로드 받을 수 있습니다.

노트 보기 예시

"틸노트에 있는 노트 리스트를 보여줘"

블로그 발행 예시

편집 없이 바로 공개하고 싶다면 발행까지 한 번에 맡기면 됩니다.

발행 규칙

블로그 공개 발행은 스팸 방지를 위해 웹에서 직접 쓸 때와 동일한 기준이 적용됩니다.

하루 10건까지 (웹에서 발행한 글과 합산됩니다)
본문 최소 150자 — 너무 짧은 글은 발행되지 않습니다
가입 7일 미만이거나 공개 글이 3편 미만이면 검색엔진 색인 요청이 잠시 미뤄집니다. 발행과 공개 자체는 정상이고, 사이트맵에도 들어갑니다
AI 기반 스팸 검증을 통과해야 합니다

또 다른 방법: 로컬 설치 (API 키 + npx)

연결 방식은 두 가지가 있습니다. 위에서 안내한 원격 커넥터 외에, 내 컴퓨터에서 직접 실행하는 npx tilnote-mcp-server 방식도 있습니다. 둘 다 정식으로 지원하며, 상황에 맞는 쪽을 고르시면 됩니다.

	원격 커넥터	로컬 설치 (npx + API 키)
준비물	URL 하나	Node.js, API 키 발급, 설정 파일 편집
인증	브라우저 로그인 (OAuth)	API 키를 설정 파일에 저장
도구	13개	10개
블로그 발행	○	✕
업데이트	자동	직접 재설치
소스 공개	—	MIT 라이선스로 전체 공개

원격 커넥터를 권합니다. 설정이 한 줄이고 블로그 발행이 됩니다.

로컬 설치는 이럴 때 유용합니다. 코드를 직접 확인하고 쓰고 싶을 때, 사내 정책상 외부 OAuth 연결이 어려울 때, 또는 자체 환경에 맞게 고쳐 쓰고 싶을 때.

사전 준비

Node.js 18 이상 설치 (npx 포함)
Tilnote API 키 발급: tilnote.io/tilnote-api에서 생성

클라이언트별 설정

별도 설치 없이 npx로 바로 실행됩니다. 각 AI 클라이언트의 설정 파일에 아래 내용을 추가하면 됩니다.

이 노트 URL을 에이전트에게 주고 세팅을 도와달라고 하세요.

Claude Code (.mcp.json):

파일 위치:

파일	위치	범위
`.mcp.json`	프로젝트 루트	해당 프로젝트에서만 적용
`~/.mcp.json`	홈 디렉토리	모든 프로젝트에서 적용

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

파일 위치:

또는 다음 위치에서 직접 열기

OS	파일 위치
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%Claudeclaude_desktop_config.json`

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Google Antigravity (~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "tilnote": {
      "command": "npx",
      "args": ["-y", "tilnote-mcp-server"],
      "env": {
        "TILNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

OpenAI Codex CLI (~/.codex/config.toml):

[mcp_servers.tilnote]
command = "npx"
args = ["-y", "tilnote-mcp-server"]
env = { TILNOTE_API_KEY = "your_api_key_here" }

마무리

클로드나 챗GPT, 클로드 코드를 사용하다가 바로 노트를 만들거나 블로그 글을 만들어서 공유해 보세요. 학습이 정말 쉬워지고 콘텐츠 생성도 너무나 쉽게 됩니다. 생산성을 높여 여러분의 삶을 변화시켜 보세요.

원격 커넥터 URL: https://tilnote.io/mcp
GitHub (로컬 패키지, MIT 라이선스): wisdomcrane/tilnote-mcp-server
npm: npx -y tilnote-mcp-server
API 키 발급 (로컬 방식 전용): tilnote.io/tilnote-api

AI 어시스턴트를 자주 사용하신다면, MCP 서버 연결을 통해 노트 관리를 한 단계 편리하게 만들어 보세요.

ChaGPT나 클로드 등의 강력한 기능들을 틸노트와 연결해서 사용할 수 있습니다. AI에게 노트와 블로그를 쥐어주세요. 놀랍고 창의적인 일들을 해보세요~