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)」をオフにし、管理者が登録したアプリだけをつながせたいとき。
確認の画面に「このサイトの管理者が登録したアプリ」と表示させ、利用者が安心して許可できるようにしたいとき。
ルートブログの管理者で、「API 連携」の「OAuth クライアント」を開きます。
名前、リダイレクト URI(アプリの設定にある戻り先の URL)、種類(公開クライアント: secret なし・ブラウザやローカルのアプリ向け/機密クライアント: secret あり・サーバーで動くアプリ向け)を入力して登録します。
機密クライアントでは、
client_idとclient_secretが一度だけ表示されます。両方を控えます。公開クライアントではclient_idだけを使います。アプリの接続の設定に
client_id(機密クライアントではclient_secretも)を入れます。
項目(登録のフォーム) | 説明・入力例 |
|---|---|
名前 | 一覧や確認の画面に表示するアプリの名前です。例: 社内の記事作成ツール |
リダイレクト URI | 認可が終わったあとアプリへ戻す URL です。10 件まで登録できます。https の URL か、ループバック( |
種類 | 「公開クライアント(secret なし。ブラウザ・ローカルのアプリ向け)」か「機密クライアント(secret あり。サーバーで動くアプリ向け)」 |
認可のときのリダイレクト URI は、登録したものと完全に一致するものだけを受け付けます。ループバックの http だけは、ポートが違っても受け付けます(手元のアプリは毎回ちがうポートで待ち受けることがあるため)。ホストとパスは一致させます。
登録後は、名前とリダイレクト URI を変えられます。種類は変えられません。機密クライアントは secret を再発行できます(古い secret はすぐに使えなくなり、既存の接続は切れません)。クライアントを無効にする、または削除すると、そのクライアントの接続をすべて失効します(無効は戻せますが、失効した接続は戻りません。削除は元に戻せません)。
事前登録したクライアントで Claude Code をつなぐ例
「OAuth クライアント」で、名前「Claude Code(社内)」、リダイレクト URI
http://localhost:8080/callback、種類「公開クライアント」で登録し、client_idを控えます。次のコマンドで 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 以外はポートも一致させます)。クライアントの「状態」が「無効」になっていないかも確かめます。