Discord と Notion を使うコミュニティ向けの、セルフホスト型 MCP サーバー。メンバーは Discord でログインし、ロールに付与した権限の範囲で AI から Discord を読み、Notion を読み書きする。
| 権限 | ツール |
|---|---|
discord:read |
discord_list_channels discord_list_threads discord_read_messages discord_get_message discord_search_messages discord_find_member discord_list_pins discord_list_events |
notion:read |
notion_search notion_get_page notion_get_users notion_query_database notion_get_database notion_get_comments |
notion:write |
notion_create_page notion_append_content notion_edit_content notion_update_properties notion_archive_page notion_list_recent_changes notion_revert_change |
notion:write（画面では「Notion 編集」）はnotion:readを含む。- Discord は本人と Bot の両方が閲覧できるチャンネルのみ。読ませたい非公開チャンネル（またはカテゴリ）には Bot を追加する（管理者にすると全チャンネルを読めてしまう）。
- Notion の権限は Notion 連携に共有されたすべてのページ・データベースが対象。
- Notion の本文は Notion 公式の Markdown API（拡張 Markdown: メンション・色・コールアウト・トグル・カラム）で読み書きする。
- Notion への書き込みはページにコメントで記録され、
/dashboard/auditまたはnotion_revert_changeで取り消せる。本文の追記・編集は書き込み前の本文に置き換えて取り消す。変更後にページが編集されていた場合は、その編集を消さないよう取り消さず、手作業で直す。取り消しで戻せないほど大きい（約 450 KB 超の）ページには書き込まない。子ページ・データベースを作るタグは本文に書けない。 - ツール呼び出しはユーザーごとに最大 30 回まで連続、以降は毎秒 1 回。
- Developer Portal でアプリを作成
- OAuth2 → Redirects に
https://<domain>/api/auth/callback/discord - Bot → Message Content Intent と Server Members Intent を ON、トークンを発行
https://discord.com/oauth2/authorize?client_id=<CLIENT_ID>&scope=bot&permissions=66560で Bot をサーバーに招待（チャンネルを見る・メッセージ履歴を読む のみ）
- Integrations で Internal integration を作成（Read / Update / Insert content、Read / Insert comments、User information without email addresses）
- 公開したいページの「…」→ コネクト で追加
- このリポジトリを Git リモートに push し、Coolify で Application（Build Pack: Dockerfile）として追加
- Port
3000、Domain を設定（Port Mappings は空のまま。サーバーに公開するとプロキシを経ずに届き、送信元 IP を偽ってレート制限を回避できる） - Persistent Storage:
/data - 環境変数を設定してデプロイ
| 名前 | 必須 | 内容 |
|---|---|---|
PUBLIC_URL |
✓ | https://<domain> |
BETTER_AUTH_SECRET |
✓ | openssl rand -base64 32 |
DISCORD_CLIENT_ID |
✓ | |
DISCORD_CLIENT_SECRET |
✓ | |
DISCORD_BOT_TOKEN |
✓ | |
DISCORD_GUILD_ID |
✓ | 対象サーバー ID |
NOTION_TOKEN |
未設定なら Notion ツール無効 | |
PORT |
既定 3000 |
|
DATABASE_PATH |
既定 ./data/app.db（Docker は /data/app.db） |
|
TRUSTED_PROXY_COUNT |
既定 1。Cloudflare 経由なら 2 |
- サーバーオーナーと Administrator 権限のロールは自動で
admin（全権限）。 - それ以外は
https://<domain>/dashboardでロールまたはユーザーに付与。 - 「トークンを失効」で即時に接続を切れる。
- ダッシュボードはいずれかの権限を持つメンバーが閲覧できる（書き込み履歴は
notion:writeが必要で、管理者以外は自分の分だけ）。権限ページと変更操作は管理者のみ。 - ツール呼び出しは統計用に記録し、90 日で削除する（引数は保存しない）。
https://<domain>/ に手順を表示する。
Claude Code:
claude mcp add --transport http --scope user ndmcp https://<domain>/mcpClaude Code 内で /mcp を開いてログイン。
Codex:
codex mcp add ndmcp --url https://<domain>/mcp
codex mcp login ndmcpbun install
cp .env.example .env
bun run dev # .env の PORT で起動（PUBLIC_URL も同じポートにする）
bun run preview # サンプルデータで UI 確認: http://localhost:3920/dev