Ramidecodes MCP Server Notion

🚀 Notion MCP サーバー

このサーバーは、公式 Notion SDK を提供するモデルコンテキストプロトコル (MCP) サーバーで、AI モデルが Notion ワークスペースとやり取りできるようにします。

🚀 クイックスタート

1. Notion インテグレーションの設定

1. https://www.notion.so/my-integrations にアクセスします。
2. 新しいインテグレーションを作成します。
3. API キーをコピーします。

2. Notion ページをインテグレーションに接続する

インテグレーションが Notion のコンテンツにアクセスできるようにするには、ページまたはデータベースを明示的に共有する必要があります。

1. インテグレーションを介してアクセスしたい Notion ページまたはデータベースに移動します。
2. 右上隅の「共有」ボタンをクリックします。
3. 「人員、グループ、またはインテグレーションを追加」フィールドで、ドロップダウンリストからインテグレーションを選択します。
4. 「招待」をクリックします。
5. 各ページまたはデータベースに対して繰り返します。

⚠️ 重要提示

インテグレーションは、明示的に共有されたページとデータベースにのみアクセスできます。親ページのアクセス権は、子ページに自動的には適用されません。

3. AI アシスタントに追加する

この MCP サーバーを Claude Desktop、Cursor AI、または Claude.ai に以下のいずれかの構成形式で追加できます。

コマンドライン形式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON 構成形式

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=your-notion-integration-key"
    ],
    "env": {},
    "executable": "npx"
  }
}

your-notion-integration-key を手順1で取得した API キーに置き換えてください。

設定場所

• Claude Desktop: 設定 > 高度 > モデルコンテキストプロトコル
• Cursor AI: 設定 > AI > MCP サーバー
• Claude.ai: ドキュメントに記載されている該当の設定方法

✨ 主な機能

以下は、サーバーが提供する主な機能です。

1. 検索: AI モデルが Notion のコンテンツを検索できます。
2. データベース操作: Notion データベースで CRUD 操作（作成、読み取り、更新、削除）をサポートします。
3. ページ管理: ページの作成、編集、削除機能を提供します。
4. ブロック処理: Notion ページ内のテキストや画像などのさまざまなコンテンツブロックを処理できます。

🔧 トラブルシューティング

一般的な問題

1. API エラー: API キーが正しく構成されていることを確認し、インテグレーションに適切なアクセス権があることを確認してください。
2. 接続問題: ネットワーク接続が正常で、Notion サービスが利用可能であることを確認してください。
3. エラーメッセージ: 詳細なエラーメッセージを確認して、デバッグ情報を取得してください。

解決策

1. キーの再生成: 認証エラーが発生した場合は、API キーを再生成してみてください。
2. アクセス権の確認: インテグレーションが必要なリソースにアクセスするための適切なアクセス権を持っていることを確認してください。
3. 依存関係の更新: すべての関連する依存関係が最新バージョンに更新されていることを確認してください。

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。