Claude Code・claude.ai から MCP サーバーに接続する
この機能は Ver. 3.3.0 で追加予定の、リリース前の機能です
このページは、アルファ版(Ver. 3.3.0-alpha.1)時点の内容です。正式版までに仕様や設定項目が変わる可能性があります。本番サイトでは使わず、検証環境でお試しください。
先に MCP サーバーを有効にする(設定項目の一覧) の手順で MCP サーバーを有効にしてください。例の https://example.com/mcp/ は、お使いのブログの MCP サーバーの URL に置き換えます。Cursor・VS Code などは Cursor・VS Code などから MCP サーバーに接続する で説明します。
接続の方法を選ぶ
MCP サーバーへの接続には、Authorization: Bearer のトークンが要ります。トークンの受け取り方は 2 つあります。
方法 | トークンの用意 | 向いている使い方 |
|---|---|---|
API トークン(アプリパスワード) | ユーザーが管理画面で発行し、クライアントの設定に書く | ヘッダーを設定できるクライアント。パスで分けた子ブログ・サブディレクトリのサイト。AI 専用のユーザーで決まった範囲だけを任せる運用 |
OAuth | クライアントが接続のときにブラウザでユーザーの許可を得て、自動で受け取る | claude.ai のコネクタなど、ヘッダーを設定できないクライアント。トークンを手で扱いたくない場合 |
クライアント | API トークン | OAuth |
|---|---|---|
Claude Code | 使える( | ドメインの直下のブログだけ使える(下の注意を参照) |
claude.ai・Claude Desktop(カスタムコネクタ) | Claude 側の「Request headers」が使える組織だけ(ベータ) | 使える |
OAuth を使うには、OAuth 認可サーバーも有効にします(OAuth で MCP サーバーに接続する)。API トークンだけで使うなら、OAuth 認可サーバーは無効のままでかまいません。
API トークンを発行する
API トークンは、トークンを使うユーザー本人が、自分のユーザー編集画面で発行します(ほかのユーザーのトークンは発行できません)。AI 専用のユーザーを使うときは、そのユーザーでログインして発行します。
自分のユーザー編集画面の「API トークン」で、トークンを発行します。トークン名は用途が分かるもの(例: Claude Code 用)にします。
スコープは AI に任せる範囲だけを選びます。読ませるだけなら
read、下書きの作成までなら「リソースごとに選ぶ」でエントリーの読み書きとカテゴリーの読み取りなどを選びます。公開まで任せないなら、強い権限のentries:publishは選びません。発行直後に表示されるトークンを控えます。閉じた後は二度と表示されません。
画面の項目とスコープの一覧は REST API の認証と API トークン、スコープの選び方の例は MCP を安全に使うための運用 を参照してください。
Claude Code から API トークンで接続する
トークンを環境変数に入れます。コマンドの履歴や共有するファイルにトークンの値を残さないためです。
Claude Code に MCP サーバーを登録します(下のコマンドか
.mcp.json)。Claude Code を起動し、
/mcpでacmsが接続済みになっているかを確かめます。
# ~/.zshrc など、シェルの設定ファイルに書く(値は発行したトークン)
export ACMS_API_TOKEN='acms_xxxxxxxxxxxxxxxxxxxxxxxx'コマンドで登録する例です(acms は Claude Code の中での名前で、自由に付けられます)。
claude mcp add --transport http acms https://example.com/mcp/ \
--header "Authorization: Bearer ${ACMS_API_TOKEN}"このコマンドでは、シェルが展開したトークンの値が Claude Code の設定(~/.claude.json)に保存されます。登録先は --scope で選びます。local(既定。今のプロジェクトだけ)と user(すべてのプロジェクト)は ~/.claude.json、project はプロジェクトの直下の .mcp.json に書かれます。
設定ファイルにトークンの値を残したくないときや、チームで設定を共有するときは、プロジェクトの直下に .mcp.json を置き、値は環境変数から読ませます。Claude Code は url・headers の中の ${変数名} を環境変数の値に置き換えます。
{
"mcpServers": {
"acms": {
"type": "http",
"url": "https://example.com/mcp/",
"headers": {
"Authorization": "Bearer ${ACMS_API_TOKEN}"
}
}
}
}変数名に
ANTHROPIC_API_KEYのような Claude Code や クラウドの認証情報の名前を使わないでください。Claude Code はこれらを空として扱うため、Bearerだけが送られて 401 になります。.mcp.jsonのサーバーは、初めて使うときに Claude Code が使ってよいかを確かめます。許可すると接続します。ツールの出し方を「1 機能 1 ツール」にするときは、ヘッダー
X-Acms-Mcp-Toolsを足します(コマンドなら--header "X-Acms-Mcp-Tools: full"を足します)。
{
"mcpServers": {
"acms": {
"type": "http",
"url": "https://example.com/mcp/",
"headers": {
"Authorization": "Bearer ${ACMS_API_TOKEN}",
"X-Acms-Mcp-Tools": "full"
}
}
}
}自己署名の証明書を使うローカル環境では、Claude Code(Node.js)がその証明書を信頼せず、接続に失敗します。証明書(またはその発行元の証明書)を NODE_EXTRA_CA_CERTS に指定して起動します。
NODE_EXTRA_CA_CERTS="$HOME/certs/local-ca.pem" claudeClaude Code から OAuth で接続する
事前に、MCP サーバーと OAuth 認可サーバーの両方を有効にしておきます(OAuth で MCP サーバーに接続する)。
ヘッダーを付けずに MCP サーバーを登録します。
Claude Code で
/mcpを実行し、acmsの認証(Authenticate)を選びます。ターミナルからclaude mcp login acmsを実行しても始められます。ブラウザで a-blog cms にログインします(AI に使わせるユーザー。二要素認証を設定しているユーザーは、それも通ります)。
「アプリの接続を確認」の画面で、アプリの名前が「Claude Code」、アプリの識別子が
https://claude.ai/oauth/claude-code-client-metadataであることを確かめ、AI に任せないスコープを外して許可します。Claude Code に戻り、
/mcpでacmsが接続済みになっていれば完了です。
claude mcp add --transport http acms https://example.com/mcp/claude mcp login acmsClaude Code から OAuth で接続できるのは、ドメインの直下のブログだけです
Claude Code は、ドメインの直下の /.well-known/oauth-authorization-server だけを見て認可サーバーを探します(2026 年 11 月時点)。ルートブログ(https://example.com/)とサブドメインの子ブログ(https://news.example.com/)はつながりますが、パスで分けた子ブログ(https://example.com/news/)やサブディレクトリに設置したサイトでは、API トークンで接続してください。
確認の画面のスコープは、求められたものすべてにチェックが入った状態で並びます。必要なものだけを残してから「許可する」を押してください。
管理者が事前に登録した OAuth クライアントを使う場合は、登録したときの client_id とコールバックのポートを指定します。OAuth クライアントには、リダイレクト URI として http://localhost:8080/callback を登録しておきます(OAuth の接続とクライアントを管理する)。機密クライアントの secret を使う場合は --client-secret も付けると、secret の入力を求められます。
claude mcp add --transport http acms https://example.com/mcp/ \
--client-id acms_c_xxxxxxxxxxxx --callback-port 8080claude.ai・Claude Desktop から接続する(カスタムコネクタ)
claude.ai のカスタムコネクタは、Anthropic のクラウドから MCP サーバーへ接続します。インターネットから届く HTTPS の URL が要り、「接続元 IP アドレス」で接続元を絞っていると接続できません。Claude Desktop(デスクトップアプリ)も、claude.ai のアカウントに登録したコネクタを使います。
個人のプラン(Free・Pro・Max など)での手順です。画面の名前は Anthropic のドキュメント(2026 年 11 月時点)に合わせています。
a-blog cms で、MCP サーバーと OAuth 認可サーバーを有効にします。
claude.ai の「Customize」→「Connectors」で「Add custom connector」を選び、コネクタの名前(例: サンプルサイト)と MCP サーバーの URL(
https://example.com/mcp/)を入力します。認証の設定は、Claude が読み取って「Detected」と表示したものをそのまま使います。OAuth のクライアントは「Use Claude's published identity」(a-blog cms の「CIMD の受け入れ」で登録されます)か「Register automatically」(「動的クライアント登録(DCR)」で登録されます)を選びます。client ID と secret は入力しません。
コネクタの「Connect」を押し、a-blog cms にログインして「アプリの接続を確認」の画面でスコープを確かめて許可します。
チャットの「+」→「Connectors」で、このコネクタがオンになっていることを確かめます。
Team・Enterprise のプランでは、組織の管理者が「Organization settings」→「Connectors」→「Add」→「Custom」(種類を聞かれたら「Web」)で追加し、メンバーは「Customize」→「Connectors」で「Connect」を押して、それぞれのユーザーで許可します。
API トークンで接続したい場合は、認証に「No sign-in」を選び、「Request headers」で authorization に Bearer とトークンを続けた値(例: Bearer acms_xxxxxxxx)を入れます。Anthropic のドキュメントでは、Request headers はベータで一部の組織だけで使えるとされています。表示されない場合は OAuth を使ってください。
claude.ai ではツールの出し方を設定で決めます
claude.ai のコネクタでは、独自のヘッダー(X-Acms-Mcp-Tools)は Anthropic の承認を受けた名前でないと保存できません。ツールの出し方は、a-blog cms の「ツールの出し方」(mcp_tool_mode)で決めてください。
「CIMD の許可ホスト」で接続できるアプリを絞る場合は、「アプリの接続を確認」の画面の「識別子のホスト」に表示された値を登録します。
接続できたかを確かめる
クライアントの画面で接続済みになっているかを確かめます。Claude Code では
claude mcp listか、起動中の/mcpで確かめます。claude mcp get acmsで 1 件の詳細も見られます。AI に「
acms_site_overviewを呼んで、ユーザー・スコープ・MCP で許可する操作を教えて」と頼みます。結果の
me.user(AI が使うユーザー)、me.scopes(トークンのスコープ)、me.token.name(API トークンの名前。OAuth ではアプリの名前)、mcp.access_level(上限)が意図どおりかを確かめます。読めなかった部分があると、結果に
errorsが付き、理由の code(insufficient_scopeなど)が入ります。
claude mcp list
claude mcp get acmsacms_site_overview の結果の例です(実際の値はサイトによって変わります。項目を一部省いています)。
{
"me": {
"user": { "id": 5, "code": "ai-writer", "name": "AI 投稿用", "status": "open", "auth": "contributor", "blog_id": 1 },
"auth": { "administrator": false, "editor": false, "contributor": true, "subscriber": true },
"scopes": ["entries:read", "entries:write", "categories:read", "blogs:read", "field-definitions:read"],
"token": { "name": "Claude Code 用", "prefix": "acms_21b", "expire": "2027-02-10T14:12:48+09:00" },
"blog_id": 1
},
"blogs": { "items": [ { "id": 1, "code": "", "name": "サンプルサイト", "status": "open", "parent_id": null, "url": "https://example.com/" } ], "meta": { "total": 1, "page": 1, "limit": 100, "last_page": 1 } },
"categories": { "items": [ { "id": 3, "code": "news", "name": "お知らせ", "status": "open", "parent_id": null, "blog_id": 1 } ], "meta": { "total": 1, "page": 1, "limit": 100, "last_page": 1 } },
"field_definitions": { "items": [ { "id": 1, "code": "default", "label": "デフォルト", "status": "open", "entity_type": "entry", "scope": "local", "fields": [ { "key": "event_date", "label": "開催日", "type": "date", "parent_key": null, "required": "none" } ] } ], "meta": { "total": 1, "page": 1, "limit": 100, "last_page": 1 } },
"mcp": { "access_level": "write", "allowed_kinds": ["read", "write"] }
}ツールが 1 つも出ない、または acms_site_overview だけで acms_execute_* が出ない場合は、下の表と MCP のツールの使い方(compact と full) の「よくある質問・つまずき」を確かめます。
よくある質問・つまずき
症状 | 原因 | 確かめ方 |
|---|---|---|
404 | MCP サーバーが無効か、URL が違います。 | URL が |
401( | トークンが届いていません。 | クライアントの設定のヘッダー名が |
401( | トークンが違うか、失効・期限切れです。 | 「API トークン」の画面で、トークンの有効期限と状態を確かめます。OAuth のトークンは、OAuth 認可サーバーを無効にしている間も |
403( | HTTP で接続しています。 | URL を |
403( | 接続元 IP アドレスの制限の外です。 | claude.ai のコネクタは Anthropic のクラウドから接続するため、IP アドレスで絞っていると接続できません。 |
403( | ユーザーの権限種別が「API・MCP を使える権限」に入っていません。 | 「REST API設定」の「API・MCP を使える権限」を確かめます。 |
429( | 認証失敗の上限などに達しました。 | 間違ったトークンで試し続けると、接続元 IP アドレスごとに 10 分間つながりません。時間をおいてから試します。 |
301 が返り、本文が失われる | URL の末尾に | URL を |
400( | ヘッダー | ヘッダーの値を確かめます。 |
Claude Code の OAuth でブラウザが開かない・認可サーバーが見つからない | OAuth 認可サーバーが無効か、パスのあるブログです。 | 認可サーバーのメタデータが取得できるかを |
「アプリと接続できません」の画面になる | アプリの登録が見つからないか、戻り先(リダイレクト URI)が登録と一致しません。 | 事前登録したクライアントで接続している場合は、「OAuth クライアント」のリダイレクト URI が |
| カスタムフィールドの定義が多く、クライアントが受け取れる大きさを超えています。 | Claude Code は既定で 25,000 トークンまでしか受け取りません。環境変数 |