はじめに
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. ビフォー・アフター構成図
文章だけだと変わった点が見えにくいので、構成図で対比します。
ビフォーでは 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 スコープだけにする、というイメージです。
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 ノードからレスポンスを返したいので、ここで切り替えておきます。
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 }} のように参照できます。
最後に 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 なワークフローを社内に配る計画が一気に現実的になります。




