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

使える(--header か .mcp.json)

ドメインの直下のブログだけ使える(下の注意を参照)

claude.ai・Claude Desktop(カスタムコネクタ)

Claude 側の「Request headers」が使える組織だけ(ベータ)

使える

OAuth を使うには、OAuth 認可サーバーも有効にします(OAuth で MCP サーバーに接続する)。API トークンだけで使うなら、OAuth 認可サーバーは無効のままでかまいません。

API トークンを発行する

API トークンは、トークンを使うユーザー本人が、自分のユーザー編集画面で発行します(ほかのユーザーのトークンは発行できません)。AI 専用のユーザーを使うときは、そのユーザーでログインして発行します。

  1. 自分のユーザー編集画面の「API トークン」で、トークンを発行します。トークン名は用途が分かるもの(例: Claude Code 用)にします。

  2. スコープは AI に任せる範囲だけを選びます。読ませるだけなら read、下書きの作成までなら「リソースごとに選ぶ」でエントリーの読み書きとカテゴリーの読み取りなどを選びます。公開まで任せないなら、強い権限の entries:publish は選びません。

  3. 発行直後に表示されるトークンを控えます。閉じた後は二度と表示されません。

画面の項目とスコープの一覧は REST API の認証と API トークン、スコープの選び方の例は MCP を安全に使うための運用 を参照してください。

Claude Code から API トークンで接続する

  1. トークンを環境変数に入れます。コマンドの履歴や共有するファイルにトークンの値を残さないためです。

  2. Claude Code に MCP サーバーを登録します(下のコマンドか .mcp.json)。

  3. 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" claude

Claude Code から OAuth で接続する

事前に、MCP サーバーと OAuth 認可サーバーの両方を有効にしておきます(OAuth で MCP サーバーに接続する)。

  1. ヘッダーを付けずに MCP サーバーを登録します。

  2. Claude Code で /mcp を実行し、acms の認証(Authenticate)を選びます。ターミナルから claude mcp login acms を実行しても始められます。

  3. ブラウザで a-blog cms にログインします(AI に使わせるユーザー。二要素認証を設定しているユーザーは、それも通ります)。

  4. 「アプリの接続を確認」の画面で、アプリの名前が「Claude Code」、アプリの識別子が https://claude.ai/oauth/claude-code-client-metadata であることを確かめ、AI に任せないスコープを外して許可します。

  5. Claude Code に戻り、/mcp で acms が接続済みになっていれば完了です。

claude mcp add --transport http acms https://example.com/mcp/
claude mcp login acms

Claude 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 8080

claude.ai・Claude Desktop から接続する(カスタムコネクタ)

claude.ai のカスタムコネクタは、Anthropic のクラウドから MCP サーバーへ接続します。インターネットから届く HTTPS の URL が要り、「接続元 IP アドレス」で接続元を絞っていると接続できません。Claude Desktop(デスクトップアプリ)も、claude.ai のアカウントに登録したコネクタを使います。

個人のプラン(Free・Pro・Max など)での手順です。画面の名前は Anthropic のドキュメント(2026 年 11 月時点)に合わせています。

  1. a-blog cms で、MCP サーバーと OAuth 認可サーバーを有効にします。

  2. claude.ai の「Customize」→「Connectors」で「Add custom connector」を選び、コネクタの名前(例: サンプルサイト)と MCP サーバーの URL(https://example.com/mcp/)を入力します。

  3. 認証の設定は、Claude が読み取って「Detected」と表示したものをそのまま使います。OAuth のクライアントは「Use Claude's published identity」(a-blog cms の「CIMD の受け入れ」で登録されます)か「Register automatically」(「動的クライアント登録(DCR)」で登録されます)を選びます。client ID と secret は入力しません。

  4. コネクタの「Connect」を押し、a-blog cms にログインして「アプリの接続を確認」の画面でスコープを確かめて許可します。

  5. チャットの「+」→「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 の許可ホスト」で接続できるアプリを絞る場合は、「アプリの接続を確認」の画面の「識別子のホスト」に表示された値を登録します。

接続できたかを確かめる

  1. クライアントの画面で接続済みになっているかを確かめます。Claude Code では claude mcp list か、起動中の /mcp で確かめます。claude mcp get acms で 1 件の詳細も見られます。

  2. AI に「acms_site_overview を呼んで、ユーザー・スコープ・MCP で許可する操作を教えて」と頼みます。

  3. 結果の me.user(AI が使うユーザー)、me.scopes(トークンのスコープ)、me.token.name(API トークンの名前。OAuth ではアプリの名前)、mcp.access_level(上限)が意図どおりかを確かめます。

  4. 読めなかった部分があると、結果に errors が付き、理由の code(insufficient_scope など)が入ります。

claude mcp list
claude mcp get acms

acms_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 が /rest-api/mcp/ ではなく /mcp/ か、URL のブログで有効にしたかを確かめます(MCP サーバーを有効にする(設定項目の一覧))。

401(missing_token)

トークンが届いていません。

クライアントの設定のヘッダー名が Authorization、値が Bearer で始まっているかを確かめます。環境変数を使う場合は、その変数がクライアントを起動したシェルに設定されているかを確かめます。Apache では、同梱の .htaccess の RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] の行を消していないかを確かめます。

401(invalid_token・token_expired)

トークンが違うか、失効・期限切れです。

「API トークン」の画面で、トークンの有効期限と状態を確かめます。OAuth のトークンは、OAuth 認可サーバーを無効にしている間も invalid_token になります。

403(https_required)

HTTP で接続しています。

URL を https:// にします。

403(ip_restricted)

接続元 IP アドレスの制限の外です。

claude.ai のコネクタは Anthropic のクラウドから接続するため、IP アドレスで絞っていると接続できません。

403(api_access_not_allowed)

ユーザーの権限種別が「API・MCP を使える権限」に入っていません。

「REST API設定」の「API・MCP を使える権限」を確かめます。

429(rate_limited)

認証失敗の上限などに達しました。

間違ったトークンで試し続けると、接続元 IP アドレスごとに 10 分間つながりません。時間をおいてから試します。

301 が返り、本文が失われる

URL の末尾に / がありません(古い .htaccess)。

URL を https://example.com/mcp/ のように / で終わらせます。

400(invalid_parameter)がすぐに返る

ヘッダー X-Acms-Mcp-Tools の値が compact でも full でもありません。

ヘッダーの値を確かめます。

Claude Code の OAuth でブラウザが開かない・認可サーバーが見つからない

OAuth 認可サーバーが無効か、パスのあるブログです。

認可サーバーのメタデータが取得できるかを curl https://example.com/.well-known/oauth-authorization-server で確かめます(OAuth のメタデータの URL と .htaccess)。

「アプリと接続できません」の画面になる

アプリの登録が見つからないか、戻り先(リダイレクト URI)が登録と一致しません。

事前登録したクライアントで接続している場合は、「OAuth クライアント」のリダイレクト URI が http://localhost:8080/callback のように、ホスト(localhost)とパス(/callback)まで合っているかを確かめます(ループバックの http はポートだけ違ってよい)(OAuth で MCP サーバーに接続する)。

acms_site_overview の結果が途中で切れる

カスタムフィールドの定義が多く、クライアントが受け取れる大きさを超えています。

Claude Code は既定で 25,000 トークンまでしか受け取りません。環境変数 MAX_MCP_OUTPUT_TOKENS(例: 50000)で上限を上げられます。