#api (2)

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 必須。

+server.ts = サーバー専用APIエンドポイント

SvelteKitのファイル規約:

ファイル	役割
+page.svelte	ページUI（ブラウザ）
+page.server.ts	ページ用サーバー処理
+server.ts	純粋なAPIエンドポイント

Next.jsとの対応:

Next.js	SvelteKit
app/api/xxx/route.ts	src/routes/api/xxx/+server.ts

Cloudflare環境変数の取得パターン

// +server.ts 内（サーバー専用、フロントに露出しない）
const apiKey = platform?.env?.CLAUDE_API_KEY;

• platform.env = Cloudflare Workers の Bindings（環境変数）
• process.env ではなく platform.env を使うのがCF固有のパターン
• ?. は ローカル開発時に platform が undefined になる可能性があるため