← 戻る

Notion MCP連携ドキュメント移行のポイント

notion mcp markdown api

API キーは Internal Integration で

Public Integrationだと承認必須項目が大量。Internal Integrationなら設定が少なく、素早くセットアップできる。

ページ取得フロー

  1. ページ一覧取得
  2. 各ページのブロック子要素を再帰取得
  3. ブロックタイプごとにMarkdown変換

トラブルシューティング

query-data-source がエラー

データベースクエリは MCPの query-data-source より REST API 直接呼び出しが堅牢：

POST /v1/databases/{id}/query

テーブルブロック変換

テーブルブロックは table_row 子要素を取得して変換が必須。単独のテーブルブロック情報では行・セル情報が不足。

Notion 固有ブロック

  • toggle: details + summary で実装
  • callout: blockquote + emoji prefix で代替
  • 内部リンク: notion.so/xxxx → VitePress 内リンクに変換

.mcp.json 配置

プロジェクトルートの .mcp.json は認識されるが、.claude/mcp.json は認識されない可能性あり。APIキーを含むため gitignore 必須。