4
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

はじめに

Claude Code でワークフローを組んで社内に配ろうとしたら、Google 認証の壁で見事に詰まりました。
自分のアカウントを渡すと AI が個人ドライブまで触れそうで踏み切れない。
結局、認証は全部 n8n に丸投げするのが正解でした。

TL;DR

  • Claude Code に自分の Google アカウントを渡す前提を捨て、n8n を「認証ゲートウェイ」にする
  • ワークフロー専用の Credential を n8n に持たせれば、AI が触れる範囲を最小化できる
  • n8n は GUI で速く組めるけど、同じ発想は AWS / GCP / Cloudflare でも実装できる

1. やりたかったこと vs. ぶつかった壁

社内配布したかったのは「Claude Code 製のワークフロー」です。
ただ実際にやってみると、配布側にも自分側にも別の壁が待っていました。

1-1. やりたかったこと

Claude Code で組んだワークフローを、社内のチームメンバーに配って一緒に使ってもらいたい——スタート地点はこれだけです。

操作対象は Google サービス。具体的にはこんな粒度のものを想定していました。

  • Sheets に行を追加する
  • Drive から関連ドキュメントを検索して読み込む
  • Apps Script を Claude から呼び出して定型処理を走らせる

派手な仕組みではありません。でも「全員が同じ手順で使える状態にする」という一点で詰まりました。

1-2. 壁 1:配布相手に OAuth フローを踏ませる難しさ

最初に検討したのは、利用者ひとりひとりにブラウザで OAuth 2.0 のフローを踏んでもらう構成です。

これが想像以上に面倒でした。配布側は Google Cloud Console で OAuth クライアントを作って承認画面を準備し、利用者側にもクライアントID登録やブラウザでの同意操作が発生します。「とりあえず使ってみて」が成立しない構成です。

1-3. 壁 2:自分のアカウントで認証すると AI に見せたくないファイルまで触りそう

次に考えたのは、自分の Google アカウントで認証して、その認証情報を Claude Code に渡す方式です。配布の問題を一旦置けば、少なくとも自分用には動きます。

が、ここで踏ん張れませんでした。自分のアカウントを渡すと、AI が触れる範囲=Google アカウント全体になります。個人で使っているドライブ・メール・カレンダーの中身までスコープに入る。

OAuth スコープは API 単位(drive、sheets など)で切るのが基本で、「このフォルダだけ」みたいな細粒度の制限はかけにくい。自動化に踏み切れなかった最大の理由はここでした。

1-4. 壁 3:MCP サーバ経由でも本質的に同じ問題

「ツールを変えれば解けるかも」と思って Google 系の MCP サーバも試しました。

結論から言うと同じです。MCP 経由でも結局は「個人アカウントで認証して使う」前提。認証情報の保持先が Claude Code の隣にあることは変わらないし、ワークフローごとの権限分離もできません。ここで「ツールの問題じゃなくて構造の問題だな」と気づきました。

3つの壁を構造の側面で並べるとこうなります。

壁 何が起きるか 構造的な問題
配布相手の OAuth フロー 利用者ごとにブラウザ操作と設定作業が必要 認証作業が利用者側に分散する
自分のアカウントを AI に渡す 個人ドライブ・メール・カレンダーまでスコープに入る AI が触れる範囲=認証で開いた範囲
MCP サーバ経由 結局は個人アカウントで認証する前提 認証情報の保持先が Claude の隣のまま

共通する根本原因は「認証情報が Claude のすぐ隣にある」ことでした。

2. 解決策:n8n を「認証ゲートウェイ」にする

壁の正体が「認証情報の置き場所」なら、置き場所を変えれば崩れるはずです。

2-1. 認証情報を Claude から引き剥がす

OAuth で取ったトークンも MCP サーバが握る認証情報も、結局は Claude が直接読める場所に置かれます。これだと AI が触れる範囲=認証で開いた範囲。OAuth スコープを絞っても API 単位までで、「このフォルダだけ」みたいな細かい制御は効きません。

なので、認証情報を Claude から物理的に引き剥がせばいい——というのが解決の方向です。

2-2. 認証ゲートウェイという発想

引き剥がし方はシンプルで、認証情報を別レイヤに置いて、Claude はそこに「お願い」するだけにする。
このパターンに名前を付けるなら「認証ゲートウェイ」です。

ゲートウェイ側が認証を持って、Claude は HTTP リクエストを送るだけ。ゲートウェイ単位で何が触れる範囲かを完全に制御できます。Claude には認証情報そのものが渡らないので、AI が動ける範囲はゲートウェイ越しに開いた範囲だけになります。

2-3. n8n の Credentials をゲートウェイ役に転用する

このゲートウェイを何で作るか。自分は n8n を選びました。GUI で API を組み合わせて動かすワークフロー自動化ツールで、Google や Slack 用のノードが既製で揃っています。

n8n には「Credentials」という、API 認証情報を保管してワークフロー内で参照する仕組みがあります。本来は「自分が組むワークフローで API 認証情報を再利用する」ための機能ですが、これを少しずらして「Claude からの依頼を受けて、自分の代わりに Google を触る」役に転用します。

2-4. ビフォー・アフター構成図

文章だけだと変わった点が見えにくいので、構成図で対比します。

image.png

image.png

ビフォーでは Claude が Google アカウントを直接抱えています。アフターでは Claude と Google の間に n8n が入り、認証情報は n8n 側にだけ存在する。Claude が知っているのは Webhook の URL とトークンだけです。

2-5. なぜ3つの壁が同時に崩れるのか

この構成にすると、第1章の3つの壁が一気に解けます。

  • 壁 1(配布の面倒さ):配布相手には Webhook の URL と簡易トークンだけ渡せば OK。OAuth フローを踏ませる必要なし
  • 壁 2(過剰アクセス):n8n の Credentials はワークフロー単位で切り出せるので、「このスプレッドシートだけ」「このフォルダだけ」みたいな最小権限化が現実的に組める
  • 壁 3(MCP の限界):認証保持の場所を Claude 外に出したので、構造的に解決

新しい認証方式を発明したわけではなくて、置き場所を変えただけ。それだけで壁が崩れます。

3. 実装の要点

ここからは Service Account を n8n に登録するパスを Step 形式で。

3-1. Step 0 — GCP 側の下準備

n8n を触る前に、GCP 側で3つやっておきます。

  • サービスアカウントを作って JSON キーを落としておく
  • 使う API(Sheets / Drive / Apps Script など)を有効化
  • 触らせたいリソース(スプレッドシートやフォルダ)にサービスアカウントを「閲覧者」か「編集者」で共有

サービスアカウント作成の手順自体は GCP 公式ドキュメントを参照してください。

最後の「リソースに共有する」が抜けると、n8n からアクセスしたときに権限エラーが返ります。Sheets なら共有設定画面にサービスアカウントのメールアドレスを入れるだけです。

Drive のマイドライブ制約:2025年4月15日以降に作成された Service Account は、個人ユーザーの「マイドライブ」にあるファイルにアクセスできません。共有ドライブ(Shared Drive)上のファイルにしかアクセスできない点に注意です(n8n 公式ドキュメント参照)。Drive 系のワークフローを組むなら、対象ファイルを共有ドライブ配下に置くか、ドメイン全体委任で別ユーザーになりすます構成にする必要があります。

3-2. Step 1 — n8n で Credential を作成

n8n の Credentials メニューを開いて、新規 Credential を作成します。

種別は「Google Service Account」を選択。JSON キーから2つの値を抜き出して、client_email を「Service Account Email」欄、private_key を「Private Key」欄にコピーします。JSON ファイル全体を貼り付ける UI ではない点だけ要注意(n8n 公式ドキュメント)。

スコープも併せて指定します。最小限に絞るのが大事で、Sheets だけ触るワークフローなら spreadsheets スコープだけにする、というイメージです。

image.png

JSON キーは秘匿情報です。n8n を信頼できない環境に立てるとここから漏れます。社内ネットワーク内の専用サーバか、信頼できるマネージドサービス上で運用するのが前提です。

3-3. Step 2 — Webhook ノードを入口に置く

Credential ができたら、新規ワークフローを作って入口に Webhook ノードを置きます。

設定する項目はこの4つだけ。

  • HTTP Method: POST
  • Path: 識別しやすい任意の文字列(推測されにくいランダム文字列を推奨)
  • Authentication: Header Auth を有効化(理由は Step 4 で)
  • Respond: 「Using 'Respond to Webhook' Node」を選択

最後の Respond だけ補足です。デフォルトのままだと Webhook ノードが即座に 200 を返してしまい、後段の処理結果を返せません。Respond to Webhook ノードからレスポンスを返したいので、ここで切り替えておきます。

image.png

Path はワークフローごとに変えます。「sheets-append-row」「drive-search-doc」みたいに用途が分かる名前にしておくと、curl を書くときも迷いません。

3-4. Step 3 — Google 系ノードを繋ぐ

Webhook の後ろに Google 系ノードを繋ぎます。よく使うのはこのあたり。

  • Google Sheets ノード:行の追加・読み取り
  • Google Drive ノード:ファイル検索・取得
  • HTTP Request ノード:Apps Script を実行する場合の汎用呼び出し

各ノードの Credential 欄で、Step 1 で作った Service Account Credential を選択します。Webhook で受け取ったパラメータは Expression 機能で {{ $json.row }} のように参照できます。

image.png

最後に Respond to Webhook ノードを繋いで、結果を JSON で返します。

3-5. Step 4 — Webhook 認可(Header Auth)

Step 2 で有効化した Header Auth を仕上げます。n8n の Credentials で「Header Auth」を新規作成し、ヘッダ名と値を設定するだけです。

Header Name : X-Workflow-Token
Header Value: <推測されにくいランダム文字列>

Webhook ノードからこの Credential を参照すれば、正しいヘッダを付けたリクエストだけが通ります。

社内配布でも Webhook URL は流出する可能性があるので、Header Auth は 必須レベル で設定しておくのが安全です。より堅牢な認可(JWT 検証や OAuth Proxy)が必要な場面もありますが、まずはこれで土台を作ります。

3-6. Step 5 — Claude Code 側から curl で叩く

ここまで来たら、あとは Claude Code から Webhook を curl で叩くだけ。Sheets に1行追加するワークフローへの呼び出しはこんな形です。

curl -X POST https://n8n.example.com/webhook/sheets-append-row \
  -H "Content-Type: application/json" \
  -H "X-Workflow-Token: <ランダム文字列>" \
  -d '{
    "spreadsheet_id": "1AbCdEfGhIjKlMnOpQrStUv",
    "sheet": "Log",
    "row": ["2026-06-02", "Claude Code から追加", "OK"]
  }'

payload はそのまま Webhook で受け取って、n8n 側の Expression で参照します。

{
  "spreadsheet_id": "1AbCdEfGhIjKlMnOpQrStUv",
  "sheet": "Log",
  "row": ["2026-06-02", "Claude Code から追加", "OK"]
}

レスポンスも JSON で返します。後続処理に使いやすい形にしておきます。

{
  "status": "ok",
  "appended_range": "Log!A10:C10",
  "updated_at": "2026-06-02T09:00:00Z"
}

Claude Code 側のスキル定義に出てくるのは Webhook URL と簡易トークンだけ。認証情報そのものは登場しません。

3-7. Step 6 — 動作確認とトラブルシュート

組んだらそのまま動作確認まで通します。curl 実行 → n8n の実行ログでワークフローが走ったかを見る → Google 側でリソースが更新されたかを見る、の順。

うまくいかない時の典型エラーはこのあたり。

  • 権限不足:Step 0 でリソースにサービスアカウントを共有していない
  • スコープ未指定:Step 1 で必要なスコープを Credential に入れていない
  • JSON 形式エラー:payload の構造と n8n 側 Expression がズレている

n8n の実行ログには各ノードの入出力が残るので、どこで止まったかはわりとすぐ追えます。

4. n8n だけが唯一解じゃない

ここまで n8n の話をしてきましたが、認証ゲートウェイはアーキテクチャ概念であってツール依存ではありません。同じ発想は他の手段でも組めます。

手段 特徴 向いている場面
n8n GUI で速く組める/Google 系ノードが既製/既に立てている人が多い まずは手早く試したい
AWS API Gateway + Lambda コードで管理/Secrets Manager で認証情報を保持/IaC に乗る コード資産にしたい・IaC に組み込みたい
GCP Cloud Functions + Secret Manager GCP 完結/Google API との親和性が高い 既に GCP 中心で運用している
Cloudflare Workers + Secret Bindings 低レイテンシ/軽量/グローバル分散 応答速度を重視したい

自分が n8n を選んだのは、GUI で速く組めることと、Google 系ノードが既製で揃っていることが大きかったです。「コードで管理したい」「IaC に乗せたい」なら Lambda 系のほうが向くし、応答速度を詰めたいなら Cloudflare Workers が候補に上がります。

要は「認証ゲートウェイ」という見方さえ持てれば、手段は運用環境に合わせて選び直せる、ということです。

5. 旨味と注意点

5-1. 旨味

  • 社内配布が劇的に楽:Webhook URL とトークンを共有するだけで使い始められる
  • 権限スコープをワークフロー単位で最小化できる:「このスプレッドシートだけ触れる」みたいな切り出しが現実的
  • 認証情報が Claude 側に一切残らない:スキル定義や設定ファイルに認証情報が出てこないので、AI への漏洩リスクが構造的に消える

5-2. 注意点

  • Header Auth は必須レベル:Webhook URL は社内でも流出し得るので、簡易トークンによる認可は必ず入れる。これがないと URL を知ってる人なら誰でも叩ける
  • レイテンシは増える:ホップが増えるぶん遅くなる。体感で数百ms〜数秒のオーダーなので、対話的にすぐ結果が欲しい用途では気になる
  • n8n 自体の運用責任は残る:本体の稼働・バックアップ・アップデートは別途必要。既に運用に乗せてる前提のほうがコスパが良い

旨味と注意点は表裏一体です。「Claude 側に認証情報を持たせない」分、ホップが増えて n8n 側の運用責任が乗る、という関係。

おわりに

「自分のアカウントを AI に触らせる」のは構造的に難しい問題で、スコープを絞ってもツールを変えても、認証情報が Claude の隣にある限り根本は変わりません。

n8n を認証ゲートウェイにする構成は、その構造をシンプルにずらすだけの解です。同じ発想は AWS や GCP、Cloudflare でも組めます。「認証ゲートウェイ」という視点を1つ持っておくだけで、AI-Native なワークフローを社内に配る計画が一気に現実的になります。

4
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?