note.com MCP Server

MCPnote.comAPI利用記事閲覧投稿情報取得Claude Desktopn8n他MCP実行

移行知2025年11月

移行

• 旧: shimayuz/note-mcp-server 削除済
• 新: shimayuz/note-com-mcp 現在

移行内容

• 同機能: MCP機能変更
• 改善: 簡単手順

新

# 新
git clone https://github.com/shimayuz/note-com-mcp.git
cd note-com-mcp

# 既存手順従
npm install
npm run build
npm run start:http

古使用必新利用

新機能: HTTP/SSE 対応2025年11月

Streamable HTTP対応

• ****: Cloudflare Tunnel使用VPS上n8n安全可能
• ****: 認証情報PC保持利用可能
• 自動化: n8n自動化統合
• 無料: Cloudflare Tunnel無料利用可能

n8n統合

# 1. HTTP起動
npm run start:http

# 2. Cloudflare Tunnel起動
cloudflared tunnel --url http://localhost:3000

# 3. n8n接続
# HTTP Stream URL: 表示Cloudflare URL + /mcp

詳細 Cloudflare Tunnel 参照

目次

• 移行知
• 新機能: HTTP/SSE 対応
• 機能
• • 利用Claude Desktop等
  • 利用n8n等
  • 自動起動設定macOS
• 使方
• 利用可能

完了2025年5月30日

2900行16分割保守性性能大幅改善

• 93%削減: 106KB 7.5KB
• 設計: 機能別整理明確構造
• 高速化: 化起動実行速度向上
• 開発効率: 保守拡張容易

機能

MCP以下機能利用

• 記事検索閲覧新着順人気順急上昇対応
• 含note全体検索
• 検索閲覧
• 記事詳細分析分析分析価格分析
• 自分記事一覧下書含取得
• 記事投稿編集下書
• 閲覧投稿
• 管理取得追加削除
• 検索閲覧
• 記事閲覧
• PV統計情報取得
• 情報取得閲覧
• 生成競合分析

認証

読取機能記事検索情報認証利用一方以下機能使用note.com認証情報必要

• 記事投稿下書
• 投稿
• /削除
• PV統計情報取得
• 情報取得

認証情報作成 .env 設定.env.example 使用自身情報入力 .env .gitignore 含安全認証情報管理

必要

• Node.js (v18以上)
• npm yarn
• Claude Desktop
• note.com投稿機能使場合

手順

1. :

   git clone https://github.com/note-mcp-developer/note-mcp-server.git <好名>
   cd <好名>
   

2. 依存:

   npm install
   

3. 環境設定作成:
   .env.example .env 名前作成

   cp .env.example .env
   

   作成 .env 開note.com認証情報設定
   詳細認証情報設定方法 .env.example 内参照

   重要: .env .gitignore Git追跡対象除外個人的認証情報誤環境安全管理

4. 起動:

   npm run build && npm run start
   

   TypeScript起動

MCP設計高保守性実現

構造

src/
 config/          # 環境設定API設定
 types/           # TypeScript型定義
 utils/           # 共通
 tools/           # 機能別MCP
 prompts/         # 
 note-mcp-server-refactored.ts  # 

利用可能

• npm run start: 本番用起動stdio
• npm run start:refactored: 版起動stdio
• npm run start:http: HTTP版起動
• npm run dev:refactored: 開発用起動stdio
• npm run dev:http: 開発用起動HTTP
• npm run dev:watch: 監視
• npm run dev:ts: TypeScript直接実行開発用stdio
• npm run dev:http:ts: TypeScript直接実行開発用HTTP

改善

• ****: 106KB 7.5KB93%削減
• 起動速度: 読込高速化
• 保守性: 機能別分離開発効率向上

認証情報設定方法

投稿情報取得機能使 .env 認証情報設定.env.example 参考以下方法設定

方法認証推奨

.envnote.comID設定

重要: 下書編集機能使用場合Cookie note_gql_auth_token 値取得.env NOTE_GQL_AUTH_TOKEN 設定必要

NOTE_EMAIL=your_email@example.com
NOTE_PASSWORD=your_password
NOTE_USER_ID=your_note_user_id

方法Cookie期限切心配少起動時自動的認証

方法Cookie認証代替方法非推奨

開発者使用note.com際Cookie情報取得.env設定

NOTE_SESSION_V5=your_session_v5_cookie_value
NOTE_XSRF_TOKEN=your_xsrf_token_cookie_value
NOTE_USER_ID=your_note_user_id

注意: Cookie認証有効期限定期的更新必要場合

Claude Desktop連携

1. Claude Desktop起動

2. Claude Desktop設定開:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 設定以下内容追加以下方法設定

   方法設定直接認証情報記述推奨

   {
     "mcpServers": {
       "note-api": {
         "command": "node",
         "args": [
           "/path/to/noteMCP/build/note-mcp-server-refactored.js"
         ],
         "env": {
           "NOTE_EMAIL": "note.com",
           "NOTE_PASSWORD": "note.com",
           "NOTE_USER_ID": "user ID"
         }
       }
     }
   }
   

   Cookie認証利用場合以下設定:

   {
     "mcpServers": {
       "note-api": {
         "command": "node",
         "args": [
           "/path/to/noteMCP/build/note-mcp-server-refactored.js"
         ],
         "env": {
           "NOTE_SESSION_V5": "v5",
           "NOTE_XSRF_TOKEN": "xsrf",
           "NOTE_USER_ID": "user ID"
         }
       }
     }
   }
   

   注意: /path/to/noteMCP 実際絶対置換

   方法.env使用上級者向

   方法先作成.env使用設定場所指定

   {
     "mcpServers": {
       "noteMCP": {
         "command": "npm",
         "args": ["run", "start"],
         "cwd": "/path/to/your/note-mcp-server", // 
         "mcp_version": "0.0.1"
       }
     }
   }
   

   注意:

   • 方法.env環境変数自動的読込
   • 方法操作慣方向

4. Claude Desktop再起動

Cursor連携

1. Cursor起動

2. CursorMCP設定開

   • macOS: ~/.cursor/mcp.json
   • Windows: %APPDATA%\.cursor\mcp.json
     Cursor settings開MCP設定画面開Add new global MCP server押

3. 設定以下内容追加

   {
     "mcpServers": {
       "note-api": {
         "command": "node",
         "args": [
           "/path/to/noteMCP/build/note-mcp-server-refactored.js"
         ],
         "env": {
           "NOTE_EMAIL": "note.com",
           "NOTE_PASSWORD": "note.com",
           "NOTE_USER_ID": "user ID"
         }
       }
     }
   }
   

   注意: /path/to/noteMCP 実際絶対置換

4. Cursor再起動

Windsurf連携

1. Windsurf起動

2. WindsurfMCP設定開

   • macOS: ~/.codeium/windsurf/mcp_config.json
   • Windows: %APPDATA%\.codeium\windsurf\mcp_config.json
     Windsurf settings開Manage Plugins開View Raw Config押

3. 設定以下内容追加

   {
     "mcpServers": {
       "note-api": {
         "command": "node",
         "args": [
           "/path/to/noteMCP/build/note-mcp-server-refactored.js"
         ],
         "env": {
           "NOTE_EMAIL": "note.com",
           "NOTE_PASSWORD": "note.com",
           "NOTE_USER_ID": "user ID"
         }
       }
     }
   }
   

   注意: /path/to/noteMCP 実際絶対置換

4. Windsurf再起動

MCP接続HTTP/SSE

Streamable HTTP使用CursorChatGPTOpenAI Responses APIMCP接続

推奨構成: Cloudflare Tunnel 使用接続

VPS上n8n場合Cloudflare Tunnel使用認証情報PC保持安全

詳細手順 Cloudflare Tunnel 参照

HTTP起動

# 起動
npm run build && npm run start:http

# 開発起動
npm run dev:http

http://127.0.0.1:3000 起動変更場合.env以下追加

MCP_HTTP_PORT=3000
MCP_HTTP_HOST=127.0.0.1

利用可能

• ****: http://127.0.0.1:3000/health
• MCP: http://127.0.0.1:3000/mcp
• SSE: http://127.0.0.1:3000/sse

n8n接続設定

n8nMCP Client HTTP Streamable使用接続

# n8n接続用URL取得
./scripts/manage-services.sh test

n8n設定:

HTTP Stream URL: https://note-mcp.composition2940.com/mcp
HTTP Connection Timeout: 60000
Messages Post Endpoint: (空欄)
Additional Headers: (空欄)

対応機能:

• tools/list - 23個一覧取得
• tools/call - search-notes, get-note実行
• JSON-RPC POST対応
• note.com認証情報連携

利用可能HTTP対応:

• search-notes: note.com記事検索
• get-note: 記事詳細取得
• 他21個一覧表示stdio推奨

Cursor接続設定

Cursor設定~/.cursor/mcp.json以下追加

{
  "mcpServers": {
    "note-api-remote": {
      "url": "http://127.0.0.1:3000/mcp",
      "transport": "sse"
    }
  }
}

ChatGPT / OpenAI Responses API接続

OpenAI API使用場合以下MCPURL指定

from openai import OpenAI

client = OpenAI()
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "note人気記事検索"}],
    mcp_servers=[{
        "url": "http://127.0.0.1:3000/mcp",
        "transport": "sse"
    }]
)

関注意

• 127.0.0.1localhost可能
• 外部許可場合適切設定認証機構実装
• 本番環境HTTPS使用強推奨

自動起動設定macOS

macOS使用場合note-mcp-serverCloudflare TunnelPC起動時自動起動設定

自動起動

# 1. 管理実行可能設定
chmod +x scripts/manage-services.sh

# 2. 自動起動設定macOS LaunchAgent
./scripts/manage-services.sh setup

# 3. 起動
./scripts/manage-services.sh start

# 4. 状態確認
./scripts/manage-services.sh status

管理

# 状態確認
./scripts/manage-services.sh status

# 起動
./scripts/manage-services.sh start

# 停止
./scripts/manage-services.sh stop

# 再起動
./scripts/manage-services.sh restart

# 表示
./scripts/manage-services.sh logs

# 
./scripts/manage-services.sh health

# n8n接続用URL表示
./scripts/manage-services.sh test

自動起動仕組

• LaunchAgent: macOS標準機能PC起動時自動実行
• note-mcp-server: ~/Library/LaunchAgents/com.note-mcp-server.plist
• Cloudflare Tunnel: ~/Library/LaunchAgents/com.cloudflared.note-mcp.plist
• 管理: ~/noteMCP/logs/ 保存

手動起動/停止

# 個別制御
launchctl start com.note-mcp-server
launchctl stop com.note-mcp-server
launchctl start com.cloudflared.note-mcp
launchctl stop com.cloudflared.note-mcp

使方

以下Claude Desktop試

検索閲覧認証不要

• note関人気記事検索
• note記事新着順検索
• username記事分析人気要因教
• note興味全体検索
• 関記事詳細分析傾向教

認証場合使機能

• 私note下書記事一覧取得
• 下書記事ID: n12345編集開
• 記事本文下書記事作成
• 私note最新記事PV数教
• 記事
• 記事投稿

利用可能

MCP以下利用

検索関連認証利用可能

• search-notes: 記事検索順 sort 指定可能
• search-all: note全体検索記事
• analyze-notes: 記事詳細分析競合分析分析分析

記事関連認証利用可能

• get-note: 記事ID詳細情報取得下書記事取得可能
• get-category-notes: 記事一覧取得

関連認証利用可能

• search-users: 検索
• get-user: 詳細情報取得
• get-user-notes: 記事一覧取得

関連認証利用可能

• search-magazines: 検索
• get-magazine: 詳細取得

自分記事関連認証必須

• get-my-notes: 自分記事一覧下書含取得
• post-draft-note: 下書記事投稿更新
• open-note-editor: 記事編集URL生成

認証必須

• get-comments: 記事一覧取得認証可能
• post-comment: 記事投稿
• get-likes: 記事一覧取得認証可能
• like-note: 記事
• unlike-note: 記事削除

統計認証必須

• get-stats: PV統計情報取得

関連認証必須

• get-membership-summaries: 加入済一覧取得
• get-membership-plans: 情報取得
• get-membership-notes: 記事一覧取得

制限事項注意点

MCP以下制限事項

API制限

• 下書保存機能post-draft-note: 未実装

• 検索結果上限: 単一検索取得結果最大20件程度多結果取得場合start使用行

• 認証情報更新: Cookie認証使用場合Cookie有効期限12週間程度切認証必要機能使定期的Cookie値更新認証利用

機能制限

• **analyze-notes **: 記事詳細分析機能note.com API提供基一部分析指標例実際閲覧数API提供場合利用

• ****: sort``new新着順popular人気順hot急上昇3種類利用note.comAPI変更一部機能場合

• get-my-notes: 下書記事取得note.comAPI実装一部情報取得場合

• edit-note/publish-note: 下書編集公開機能使用NOTE_GQL_AUTH_TOKEN設定必要設定場合編集時認証発生

下書編集機能利用方法

記事下書編集公開機能使用手順

1. note.com
2. 開発者Chrome場合 F12 右調査開
3. ApplicationStorage選択左側Cookieshttps://note.com選択
4. note_gql_auth_token探値
5. .env以下行追加

   NOTE_GQL_AUTH_TOKEN=値
   

6. MCP再起動変更反映

認証正設定下書編集機能正常動作

新機能使用例

記事詳細分析例

// 基本的使用例
analyze-notes(query: "ChatGPT")

// 詳細指定
analyze-notes(
  query: "AI", 
  size: 30, 
  sort: "popular", 
  includeUserDetails: true,
  analyzeContent: true,
  priceRange: "paid"
)

// 日付範囲指定
analyze-notes(
  query: "", 
  category: "technology",
  dateRange: "3m",  // 3月以内
  sort: "new"
)

使用例

// 新着順記事検索
search-notes(query: "AI", sort: "new")

// 人気順全体検索
search-all(query: "", context: "user,hashtag,note", sort: "popular")

// 急上昇検索
search-notes(query: "ChatGPT")

起動

• .env正作成設定確認.env.example .env 作成必要認証情報入力確認
• Node.js18以上確認node -v確認
• 依存確認npm install実行
• npm run buildTypeScript正確認npm run start 本番用起動場合

認証発生

• .env 設定認証情報/Cookie値ID正最新確認
• Cookie認証場合有効期限切可能性
• 認証必要機能確認
• 下書編集機能発生場合NOTE_GQL_AUTH_TOKEN設定必要note.com開発者Cookienote_gql_auth_token値取得設定

API発生

• note.comAPI仕様変更可能性
• 最新版確認発生箇所見直

確認

• 有効 .env 以下行追記:

  DEBUG=true
  

• .env 存在場合上記手順従 .env.example 作成

開発者向高速開発

版以下開発利用

# TypeScript直接実行不要最速
npm run dev

# 変更監視自動的再再起動開発時便利
npm run dev:watch 

# 本番用起動
npm run start

個別

各独立個別適宜調整

# 特定Node.js直接実行後
node build/utils/api-client.js 
node build/tools/search-tools.js

注意事項

• note.com非公式API利用
• API仕様変更一部全部機能動作可能性
• Cookie認証有効期限定期的更新必要認証定期的更新様
• note.com利用規約遵守使用
• 発展途上等見issue教

MIT