Remote MCP：claude.aiや任意のMCPクライアントから自分のDuDuClawに直接接続する

duduclaw http-server は標準的なMCP Streamable HTTPエンドポイント（POST /mcp）と、完全なOAuth 2.1認可フローを提供する。これにより、claude.aiのカスタムコネクタ（Custom Connector）、Claudeモバイルアプリ、MCP Inspector、またはremote MCPサーバーに対応する任意のアプリから、自分でホストするDuDuClawに直接接続し、記憶やナレッジベースなどのツール群を利用できる。

クイックスタート

# 1. HTTPサーバーを起動する（デフォルトではloopbackのみにバインド）
duduclaw http-server --bind 127.0.0.1:8765

# 2. 外部公開が必要な場合はトンネルを開く（または自前のリバースプロキシ／ドメインを使う）
duduclaw tunnel          # Cloudflare quick tunnel。画面にhttps URLが表示される

外部公開用のURLを取得したら、claude.aiの「設定 → コネクタ → カスタムコネクタを追加」（設定 → 連接器 → 新增自訂連接器）に貼り付ける：

https://<あなたのURL>/mcp

claude.aiは自動的にOAuthディスカバリー（RFC 9728 → RFC 8414 → 動的登録）を実行し、 DuDuClawの認可ページへ遷移する。ページ上で内部MCP APIキー（config.toml [mcp_keys] 内で is_external = false になっているキー）を貼り付け、「接続に同意する」（同意連線）をクリックすれば完了する。

認可モデル（重要）

OAuthが発行するアクセストークンは常に「外部クライアント」ティアとして扱われ、外部向けツール面と同じscopeポリシーを共有する。別ルールは存在しない：

基本ツール面（7つの基本ツール）は常に利用可能。
コネクタが要求するscopeは外部に付与可能なホワイトリスト （memory:read / memory:write / wiki:read / wiki:write / messaging:send）に絞り込まれる。コネクタ系（Odoo/Google/Notion）、実行系、名簿、Adminは、クライアントがどう要求しようともOAuth経由では絶対に開放されない。
同意ページに貼り付けるのは内部キーでなければならない（外部キーは自分自身をアップグレードできない）。

トークンの詳細：アクセストークンは1時間、リフレッシュトークンは30日間有効で使用のたびにローテーションされる。認可コードは1回限り有効で10分間。PKCE S256は必須。すべてのトークンは SHA-256ハッシュとしてのみディスクに保存される（~/.duduclaw/mcp_oauth_issued.json、パーミッション0600）。

エンドポイント一覧

パス	用途
`POST /mcp`	標準MCPエンドポイント（initialize／tools/list／tools/call／ping）
`GET /.well-known/oauth-protected-resource`	RFC 9728リソースメタデータ（401の `WWW-Authenticate` ヘッダーがここを指す）
`GET /.well-known/oauth-authorization-server`	RFC 8414認可サーバーメタデータ
`POST /oauth/register`	RFC 7591動的クライアント登録（public client）
`GET /oauth/authorize` → `POST /oauth/decision`	認可コードフロー＋オペレーター同意ページ
`POST /oauth/token`	トークンの発行／更新
`POST /mcp/v1/call`、`GET /mcp/v1/stream`	既存のDuDuClaw REST/SSE面（変更なし）

静的Bearerキー（ddc_…）とOAuthトークン（ddc_oauth_…）は同じ Authorization: Bearer インターフェースを共有する。スクリプトや自社の連携は引き続き静的キーを使えばよく、OAuthは claude.aiのように「OAuthしか話さない」クライアント向けに用意されている。

セキュリティに関する補足

ブラウザのオリジン（Origin ヘッダー）はloopbackと config.toml [gateway] allowed_origins のホワイトリスト（アンカーマッチ）に照合され、それ以外はすべて403となる。ブラウザ以外のクライアントには影響しない。
quick tunnelのURLは起動のたびに変わる。本番の外部公開では固定ドメイン（リバースプロキシまたはCloudflareのnamed tunnel）を使うこと。OAuthフローのissuerはリクエストの Host／X-Forwarded-Proto から導出される。
発行済みの接続をすべて失効させるには ~/.duduclaw/mcp_oauth_issued.json を削除すればよい（次のリクエストから即座に無効になる）。