OAuth の接続とクライアントを管理する


この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です

このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。

OAuth 認可サーバーの設定と接続の流れは OAuth で MCP サーバーに接続する で説明しています。

画面の場所

  • 接続済みアプリ(本人): ユーザー編集画面の「接続済みアプリ」。自分の接続の確認・実行ログ・失効ができます。

  • OAuth の接続(ルートブログの管理者): 管理画面の「API 連携」。全ユーザーの接続の確認・失効、ユーザーごとの一括失効ができます。

  • OAuth クライアント(ルートブログの管理者): 管理画面の「API 連携」。クライアントの事前登録・変更・secret の再発行・無効化・削除ができます(「REST API設定」の「OAuth 認可サーバー」からも開けます)。

「API 連携」には、「API トークン」(全ユーザーの API トークン。REST API の認証と API トークン)・「OAuth クライアント」・「OAuth の接続」の 3 つがあります。

接続済みアプリ(本人)

自分のユーザー編集画面の「接続済みアプリ」で、OAuth で接続しているアプリを確認します。心当たりのない接続や使わなくなった接続は、失効します。

接続ごとに、アプリの名前、アプリの種別(事前登録した「このサイトの管理者が登録したアプリ」か、CIMD・動的登録の「未確認のアプリ」)、アプリの識別子(client ID。CIMD のアプリは URL。同じ名前のアプリはここで見分けます)、接続先(MCP サーバーか REST API とその URL)、スコープ、接続した日時、最終使用、直近の実行ログ(監査ログへの入口つき)が分かります。

同じアプリでも、接続するたびに別の接続として並びます。失効すると、その接続のアクセストークンとリフレッシュトークンはすぐに使えなくなります。アプリからもう一度接続すると、新しい接続になります。

OAuth の接続(管理者)

ルートブログの管理者は、「API 連携」の「OAuth の接続」で、全ユーザーの接続を確認して失効できます。アカウントの乗っ取りが疑われるユーザーは、そのユーザーの接続をまとめて失効します。

OAuth クライアント(事前登録)

claude.ai のコネクタ・Claude Code・Cursor のように CIMD か動的登録(DCR)に対応したアプリは、登録しなくても自動で登録されます。次の場合に事前登録します。

  • CIMD・動的登録に対応していないアプリをつなぐとき。

  • 「CIMD の受け入れ」と「動的クライアント登録(DCR)」をオフにし、管理者が登録したアプリだけをつながせたいとき。

  • 確認の画面に「このサイトの管理者が登録したアプリ」と表示させ、利用者が安心して許可できるようにしたいとき。

  1. ルートブログの管理者で、「API 連携」の「OAuth クライアント」を開きます。

  2. 名前、リダイレクト URI(アプリの設定にある戻り先の URL)、種類(公開クライアント: secret なし・ブラウザやローカルのアプリ向け/機密クライアント: secret あり・サーバーで動くアプリ向け)を入力して登録します。

  3. 機密クライアントでは、client_id と client_secret が一度だけ表示されます。両方を控えます。公開クライアントでは client_id だけを使います。

  4. アプリの接続の設定に client_id(機密クライアントでは client_secret も)を入れます。

項目(登録のフォーム)

説明・入力例

名前

一覧や確認の画面に表示するアプリの名前です。例: 社内の記事作成ツール

リダイレクト URI

認可が終わったあとアプリへ戻す URL です。10 件まで登録できます。https の URL か、ループバック(127.0.0.1・[::1]・localhost)の http だけを入力できます。例: https://tool.example.com/callback、http://localhost:8080/callback

種類

「公開クライアント(secret なし。ブラウザ・ローカルのアプリ向け)」か「機密クライアント(secret あり。サーバーで動くアプリ向け)」

認可のときのリダイレクト URI は、登録したものと完全に一致するものだけを受け付けます。ループバックの http だけは、ポートが違っても受け付けます(手元のアプリは毎回ちがうポートで待ち受けることがあるため)。ホストとパスは一致させます。

登録後は、名前とリダイレクト URI を変えられます。種類は変えられません。機密クライアントは secret を再発行できます(古い secret はすぐに使えなくなり、既存の接続は切れません)。クライアントを無効にする、または削除すると、そのクライアントの接続をすべて失効します(無効は戻せますが、失効した接続は戻りません。削除は元に戻せません)。

事前登録したクライアントで Claude Code をつなぐ例

  1. 「OAuth クライアント」で、名前「Claude Code(社内)」、リダイレクト URI http://localhost:8080/callback、種類「公開クライアント」で登録し、client_id を控えます。

  2. 次のコマンドで MCP サーバーを登録し、/mcp か claude mcp login acms で接続します。確認の画面のアプリの種別が「このサイトの管理者が登録したアプリ」になります。

claude mcp add --transport http acms https://example.com/mcp/ \
  --client-id acms_c_xxxxxxxxxxxx --callback-port 8080

機密クライアントで登録した場合は、--client-secret を付けると secret の入力を求められます。

claude mcp add --transport http acms https://example.com/mcp/ \
  --client-id acms_c_xxxxxxxxxxxx --client-secret --callback-port 8080

--client-id・--client-secret・--callback-port と戻り先の形(http://localhost:ポート/callback)は、Claude Code のドキュメント(2026 年 11 月時点)に拠ります。事前登録したクライアントで Claude Code から接続した動作は、手元では確かめていません。

接続が失効するとき

きっかけ

失効するもの

本人が「接続済みアプリ」で「失効する」を押した

その接続

管理者が「OAuth の接続」で「失効する」・「このユーザーの接続をすべて失効」を押した

その接続・そのユーザーのすべての接続

管理者が「OAuth クライアント」で「無効にする」・「削除する」を押した

そのクライアントのすべての接続

使用済みのリフレッシュトークン・認可コードが再び使われた

その接続(漏えいとみなす)

ユーザーを削除した・ブログを削除した

そのユーザー・ブログの接続

バックアップをリストアした

すべての OAuth の接続と API トークン(リストアのあとは、アプリの再接続と API トークンの再発行が要ります)

「CIMD の受け入れ」「動的クライアント登録(DCR)」をオフにした・「CIMD の許可ホスト」から外した

その方法で登録されたクライアントは使えなくなります

OAuth 認可サーバーを無効にしている間は、発行済みの OAuth のトークンは使えませんが、接続は失効しません。有効に戻すと、有効期間内のトークンは再び使えます。

よくある質問・つまずき

「API 連携」がメニューに無い

「API 連携」の画面は、ルートブログの管理者だけが使えます。子ブログの管理者やほかの権限のユーザーには表示されません。

同じアプリが何件も並んでいる

接続するたびに新しい接続ができます。使っていない古い接続は失効してかまいません。どれが使われているかは「最終使用」で確かめます。

secret を控え忘れた

secret は登録・再発行のときに一度だけ表示されます。「secret を再発行」で新しい secret を発行し、アプリの設定を書き換えます。

リダイレクト URI を保存できない

https の URL か、ループバック(127.0.0.1・[::1]・localhost)の http だけを入力できます。独自のスキーム(myapp:// など)は登録できません。

事前登録したクライアントで接続すると「アプリと接続できません」になる

アプリが送るリダイレクト URI と登録が一致していません(ループバックの http 以外はポートも一致させます)。クライアントの「状態」が「無効」になっていないかも確かめます。