L Harness・Claude Code
公式LINE連携設定

つなぐと、どんなことができるか

Claude Codeに、ふだんの言葉で頼むだけで、LINE公式アカウントの作業を進められるようになります。
たとえば次のような頼み方ができます。

• 「先月友だち追加した人のうち、まだタグが付いていない人を一覧にして」
• 「どのQRコードやリンクから、友だち追加が多いか教えて」
• 「初回の来店後7日間に届けるステップ配信の、文章の下書きを作って」
• 「この3人に、初回来店のタグを付けて」

送信や作成など、LINEの中身を変える操作は、STEP 10-3の設定で止めておき、使うときだけ許可する形にします。

この仕組みを使って、ステップ配信や、AIが自動で答えるLINEのチャットボットなども開発できます。
この説明書は、その土台づくりです。

業種ごとの活用例

名前は一例です。お店に合った名前を自由に付けられます。

テスト用のLINEで先に試すのがおすすめな理由

いまお客さん（治療院なら患者さん）とやり取りしているLINE公式アカウントに、いきなりつなぐと、お客さんへの返信やあいさつが変わったり、止まったりすることがあります。
お客さんがいないテスト用のLINEで一度動かしておくと、手順と動きが分かり、本番を安心して進められます。
この説明書は、そのまま本番のLINEに入れても進められる書き方にしています。本番で気をつける所には、本番のLINEで行うときの囲みを付けています。

本番のLINEにつないだときに起こりうること

用意するもの

• パソコン（MacまたはWindows）とGoogle Chromeページ上部のボタンで、お使いのパソコンに表示を切り替えられます。
• Claude Codeインストールの方法はSTEP 4にあります。
• LINE公式アカウントと、その管理者のLINE（スマホ）本番で使うアカウント。テストで試す場合は、新しく作るアカウント。
• クレジットカードCloudflareの保存機能（R2）を有効にするときに登録します。無料の範囲なら請求はありません。
• パソコンの空き容量 約1GBプログラムの部品を置きます。本体はCloudflare上で動きます。

エラーの直し方は、よくあるエラーと直し方にもまとめています。

L Harnessエル ハーネス

LINE公式アカウントを自動化する無料のプログラム。ステップ配信、友だち管理などができます。開発者は野田修一さん。以前は LINE Harness という名前でした。

Cloudflareクラウドフレア

プログラムを24時間動かしておける場所を貸してくれる会社。L Harnessはここで動きます。

Workerワーカー

Cloudflareの上で動くプログラムのこと。L Harnessの本体です。

D1・R2ディーワン・アールツー

CloudflareのデータベースがD1、画像などの保存場所がR2です。

Messaging APIメッセージング エーピーアイ

LINE公式アカウントを、外のプログラムから動かすための仕組み。

プロバイダー

LINE Developersの中で、チャネルをまとめるフォルダのようなもの。あとから別のプロバイダーへは移せません。

チャネル

LINEの機能ごとの設定の入れ物。Messaging API用とLINEログイン用の2つを使います。

LINEログイン・LIFFリフ

LINEのアカウントで本人確認する仕組みと、LINEの中で開くWebページの仕組み。友だちを正しく記録するために使います。

Webhookウェブフック

LINEにメッセージが届いたとき、知らせを送る先のURL。1つのLINEに1か所だけ登録できます。

チャネルシークレット・アクセストークン

LINEを操作するための合鍵。人に見せたり、チャットに貼ったりしてはいけません。

APIキー

L Harnessの管理画面や、Claude Codeから操作するための合鍵。これも人に見せません。

MCPエムシーピー

Claude Codeと外のツールをつなぐ部品。これを登録すると、L Harnessを言葉で操作できます。

チャットボット

LINEに届いた質問に、AIが自動で返事をするしくみ。名前は自由です（例 治療院ならAI院長、サロンならAIコンシェルジュ、カフェならAI店長）。

ステップ配信

友だち追加などをきっかけに、決めた順番と日数で、メッセージを自動で届けるしくみ。

ターミナル

PowerShellパワーシェル

Macに入っている、文字で命令を打ち込むアプリ。⌘＋spaceで「ターミナル」と入力して開きます。

Windowsに入っている、文字で命令を打ち込むアプリ。Windowsキーを押して「PowerShell」と入力して開きます。

コマンド

文字で打ち込む命令文。この説明書では、コピーして貼り付けるだけで使えます。

クリップボード

コピーした内容が、一時的に置かれる場所。次に何かをコピーすると、前の内容は消えます。

デプロイ

プログラムをインターネット上（今回はCloudflare）に置いて、使える状態にすること。

L Harnessの本体はCloudflare上で24時間動きます。
パソコンは、設定と更新のときだけ使います。

作業の順番

1. 1Cloudflareの登録とログイン5〜10分保存機能（R2）を有効にする
2. 2LINE公式アカウントの準備3〜5分Messaging APIを有効にする
3. 3LINEログインとLIFF5分Messaging APIと同じプロバイダーに作る
4. 4パソコンの準備3〜5分必要なソフトの確認と、プログラムの取得
5. 5設定ツールでL Harnessを入れる5〜10分質問に答えると、設置まで自動
6. 6LINEにURLを設定する5分Webhook、Callback URL、LIFF
7. 7LINE側の自動返信を止める3分あいさつメッセージなど
8. 8友だち追加で動作確認3分LINEログインのチャネルを公開する
9. 9管理画面にログイン2分APIキーで入る
10. 10Claude Codeとつなぐ5分MCPの登録と、安全のための設定
11. 11接続確認と使い方3分Claude Codeから読み取れたら完成

あなたの値を入れると、コマンドが自動で書き換わります

STEP 4からSTEP 11のコマンドは、ここに入れた値に合わせて書き換わります。
WorkerのURLは、STEP 5の最後に分かります。分かったら、ここに戻って入れてください。

1-1 アカウントを作る

1. Chromeで Cloudflareの登録ページ を開きます。
2. メールアドレスとパスワードを入れて登録します。パスワードは、Chromeのパスワードマネージャーに保存しておくと安心です。
3. 届いた確認メールのリンクを押して、メールアドレスを確認します。
4. ダッシュボード（管理画面のトップ）が開けば、登録は完了です。

1-2 次からのログイン

Cloudflareのログインページ で、登録したメールアドレスとパスワードを入れます。
Googleアカウントで登録した場合は、同じGoogleアカウントでログインします。

1-3 2段階認証をオンにする（おすすめ）

お客さんの情報を置く場所になるので、パスワードのほかに、スマホでも確認する設定にしておきます。
右上の人のマーク、プロフィール、認証（Authentication）の順に開いて設定します。

1-4 保存機能（R2）を有効にする

1. 左のメニューの「ストレージとデータベース」を開き、「R2 オブジェクト ストレージ」を押します。
2. 有効にするボタンを押し、クレジットカードかPayPalを登録します。
3. R2の画面が開けば完了です。保存場所（バケット）は、設定ツールが自動で作るので、自分で作らなくて大丈夫です。

1. パソコンで LINE公式アカウントの管理画面 を開き、使うアカウントを選びます。
2. 右上の「設定」、左の「Messaging API」を開きます。
3. まだ有効でなければ「Messaging APIを利用する」を押し、プロバイダーを選びます（初めてなら新しく作ります）。
   すでに有効なら、表示されているプロバイダー名を控えておきます。

3-1 LINEログインのチャネルを作る

1. LINE Developers を開き、STEP 2のプロバイダーを選びます。
2. 「新しいチャネルを作成する」、「LINEログイン」の順に選びます。
3. チャネル名は「L Harness」など、ほかと区別できる名前にします。アプリタイプは「ウェブアプリ」にチェックします。
4. 規約に同意して作成します。

3-2 ウェブアプリでのログインをオンにする

作ったチャネルの「LINEログイン設定」タブで、「ウェブアプリでLINEログインを利用する」をオンにします。
Callback URLは、今は空欄のままで大丈夫です（STEP 6で入れます）。

3-3 リンクする公式アカウントを選ぶ

「チャネル基本設定」タブのいちばん下にある「リンク先のLINE公式アカウント」で「編集」を押し、STEP 2のアカウントを選んで「アップデート」を押します。

3-4 LIFFアプリを追加する

「LIFF」タブで「追加」を押し、次のとおりに入れて、いちばん下の「追加」を押します。

• LIFFアプリ名「Lハーネス」など。「LINE」という言葉は使えません（使うとエラーになります）。
• サイズFull
• エンドポイントURL今は仮で https://example.com と入れます。STEP 6で本物に変えます。
• スコープopenid と profile にチェック
• 友だち追加オプションOn (Aggressive)

3-5 次のSTEPで使う値の場所

次の値をSTEP 5でコピーして使います。
LINE Developersの画面を開いたままにしておくと楽です。値はメモ帳やチャットに貼らないでください。

名前の似たチャネルが複数あるときは、取り違えに注意してください。
チャネルIDは、そのチャネルを開いたときのアドレスの末尾の数字と同じです。

4-1 ターミナルPowerShellを開く

⌘＋space を押して「ターミナル」と入力し、returnで開きます。
このあとのコマンドは、コピーボタンで写し、ターミナルに貼り付けて（⌘＋V）、returnで実行します。

Windowsキーを押して「PowerShell」と入力し、Enterで開きます（管理者として実行する必要はありません）。
このあとのコマンドは、コピーボタンで写し、PowerShellに貼り付けて（Ctrl＋V、または右クリック）、Enterで実行します。
複数行のコマンドも、そのまま全部貼り付けられます。

4-2 必要なソフトが入っているか確かめる

node -v; git --version; claude --version

node -v; git --version; claude --version

3つとも番号が出ればOKです。出ないものは、次の方法で入れます。

curl -fsSL https://claude.ai/install.sh | bash

winget install -e --id OpenJS.NodeJS.LTS
winget install -e --id Git.Git

irm https://claude.ai/install.ps1 | iex

入れたあとは、PowerShellを一度閉じて開き直してから、4-2の確認をもう一度行います。

4-3 L Harnessのプログラムを取得する

公式のプログラムを、パソコンのフォルダに取得します。
最新版の番号は 公式のリリースページ で確認できます（この説明書は v0.26.1 で確認しています）。

git clone --depth 1 --branch v0.26.1 https://github.com/Shudesu/line-harness-oss.git ~/line-harness

git clone --depth 1 --branch v0.26.1 https://github.com/Shudesu/line-harness-oss.git $HOME\line-harness

容量は、取得とSTEP 5のあとで約1GBになります（ほとんどが部品）。
あとで更新や設定変更に使うので、消さずに残してください。

5-1 チャネルアクセストークン（長期）を用意する

LINE Developersで、Messaging APIのチャネルを開き、「Messaging API設定」タブのいちばん下を見ます。
まだ発行していなければ、チャネルアクセストークン（長期）の「発行」を押します。

5-2 設定ツールを動かす

cd ~/line-harness && npx --yes create-line-harness@latest

cd $HOME\line-harness
npx.cmd --yes create-line-harness@latest

Windowsでは npx の代わりに npx.cmd と書いています。PowerShellの設定によって、npxがエラーで止まるのを避けるためです。

5-3 Cloudflareへのログインを許可する

ブラウザが開き、「Wranglerがあなたのアカウントにアクセスしようとしています」と出ます。
Wrangler（ラングラー）は、Cloudflareが公式に出している道具です。
アドレスが dash.cloudflare.com で、右側が自分のアカウントであることを確かめて、「承認する」を押します。

5-4 質問に答える

質問は、次の順番で出てきます。
シークレットやトークンを貼る欄は、貼り付けても画面に何も表示されません。それで正常です。

質問の順番や言葉は、ツールの版によって少し変わることがあります。画面の案内を優先してください。

5-5 完了画面で、URLとAPIキーを確認する

• WorkerのURLは、https://〇〇〇.〇〇〇.workers.dev の形です（Callback URLの /auth/callback より前の部分）。入力欄に入れておくと、このあとのコマンドが書き換わります。
• APIキーは、この画面でしか表示されません。すぐにChromeのパスワードマネージャーなど、安全な場所に保存します。
  管理画面へのログイン（STEP 9）と、Claude Codeとの連携（STEP 10）で使います。

完了画面に出たURLを、LINE Developersの3か所に入れます。
（Worker名） の部分は、あなたのWorkerのURLに置き換えてください。

6-1 Webhookを設定して、検証する

1. Webhook URLの「編集」を押してURLを入れ、「更新」を押します。
2. 「検証」を押し、「成功」と出ればつながっています。
3. 「Webhookの利用」をオンにします。

6-2 Callback URLとLIFFのURLを入れる

LINEログインのチャネルで、Callback URLの「編集」から入れて「更新」します。
「LIFF」タブでアプリを開き、エンドポイントURLの「編集」から、仮の https://example.com を本物のURLに書き換えて「更新」します。

Callback URLが空のままだと、パソコンからQRコードで友だち追加した人が、エラーで止まってしまいます。

LINE公式アカウントの管理画面 でアカウントを開き、右上の「設定」、左の「応答設定」を開きます。

• あいさつメッセージ オフにします。
• Webhook オンになっていることを確認します。
• 応答方法 「手動チャット」にします（自動の応答メッセージが動かない状態）。

8-1 LINEログインのチャネルを公開する

LINEログインのチャネルは、作った直後は「開発中」です。
開発中のままだと、開発者として登録されていないLINEアカウントでは使えず、エラーになります（お客さんも使えません）。
チャネル名の横にある「開発中（Developing）」を押し、確認画面で「公開」を押します。

8-2 スマホで友だち追加して、メッセージを送る

1. 次のURLを、スマホのLINEで開きます（自分宛てのLINEのトークや、メモに貼って押すと開きやすいです）。
   https://（Worker名）.workers.dev/auth/line?ref=setup
2. LINEログインの確認画面で「許可」を押します。
3. アカウントのトークで、「こんにちは」などを送ります。
   まだ返信の仕組みを作っていないので、返事は来ません。それで正常です。

これから友だち追加してもらうときも、QRコードを直接読んでもらうより、このURL（友だち追加URL）を通してもらうと、流入経路などが正しく記録されます。

1. 完了画面に出た「管理画面」のURLを開きます。
2. 緑のログイン画面に、STEP 5-5で保存したAPIキーを入れて「ログイン」を押します。
3. 左の「友だち管理」に、あなたが表示されていれば、ここまでの設定は成功です。

ダッシュボードの友だち数（LINEの集計）は、前日時点の数字です。
L Harnessを入れる前から友だちの人は、メッセージを送るまでL Harnessには記録されないため、数がずれることがあります。

APIキーを使って、Claude CodeにL Harnessをつなぐ部品（MCP）を登録します。
どちらか1つの方法で行います。入力欄にWorkerのURLを入れてから、コピーしてください。

10-1 方法A　保存したAPIキーで登録する（ふつうはこちら）

コマンドを実行すると「APIキーを貼り付けてEnter」と出て止まります。
パスワードマネージャーからAPIキーをコピーし、貼り付けてreturnEnterを押します。
貼り付けても画面には何も表示されません。それで正常です。

cd ~/line-harness && read -s "LHKEY?APIキーを貼り付けてEnter: " && echo && { claude mcp remove --scope local line-harness >/dev/null 2>&1; true; } && claude mcp add --scope local line-harness -e LINE_HARNESS_API_URL=https://（あなたのWorker名）.workers.dev -e LINE_HARNESS_API_KEY="$LHKEY" -- npx -y @line-harness/mcp-server@latest && unset LHKEY && echo "登録しました" || echo "失敗しました。上に出た文章を確認してください"

& {
  cd $HOME\line-harness
  $s = Read-Host "APIキーを貼り付けてEnter" -AsSecureString
  $k = [Runtime.InteropServices.Marshal]::PtrToStringBSTR([Runtime.InteropServices.Marshal]::SecureStringToBSTR($s))
  claude mcp remove --scope local line-harness 2>$null
  claude mcp add --scope local line-harness -e LINE_HARNESS_API_URL=https://（あなたのWorker名）.workers.dev -e "LINE_HARNESS_API_KEY=$k" -- cmd /c npx -y @line-harness/mcp-server@latest
  if ($LASTEXITCODE -eq 0) { Write-Host "登録しました" } else { Write-Host "失敗しました。上に出た文章を確認してください" }
}

10-2 方法B　APIキーを作り直して登録する（キーをなくした、見られたとき）

新しいAPIキーを作り、Cloudflareのキーを差し替え、Claude Codeに登録するところまでを1回で行います。
新しいキーは画面に表示せず、最後にクリップボードへコピーします。
古いキーは使えなくなります。

cd ~/line-harness && NEWKEY=$(openssl rand -hex 32) && printf '%s' "$NEWKEY" | npx wrangler secret put API_KEY --config apps/worker/wrangler.toml && { claude mcp remove --scope local line-harness >/dev/null 2>&1; true; } && claude mcp add --scope local line-harness -e LINE_HARNESS_API_URL=https://（あなたのWorker名）.workers.dev -e LINE_HARNESS_API_KEY="$NEWKEY" -- npx -y @line-harness/mcp-server@latest && printf '%s' "$NEWKEY" | pbcopy && unset NEWKEY && echo "完了。新しいAPIキーをクリップボードにコピーしました" || echo "失敗しました。上に出た文章を確認してください"

& {
  cd $HOME\line-harness
  $b = New-Object byte[] 32
  [Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($b)
  $NEWKEY = -join ($b | ForEach-Object { $_.ToString("x2") })
  $NEWKEY | npx.cmd wrangler secret put API_KEY --config apps/worker/wrangler.toml
  if ($LASTEXITCODE -ne 0) { Write-Host "失敗しました。上に出た文章を確認してください"; return }
  claude mcp remove --scope local line-harness 2>$null
  claude mcp add --scope local line-harness -e LINE_HARNESS_API_URL=https://（あなたのWorker名）.workers.dev -e "LINE_HARNESS_API_KEY=$NEWKEY" -- cmd /c npx -y @line-harness/mcp-server@latest
  if ($LASTEXITCODE -ne 0) { Write-Host "失敗しました。上に出た文章を確認してください"; return }
  Set-Clipboard -Value $NEWKEY
  Write-Host "完了。新しいAPIキーをクリップボードにコピーしました"
}

「完了」と出たら、ほかの文字をコピーする前に、管理画面のログイン欄に貼り付けてログインし、パスワードマネージャーに保存（更新）します。
ブラウザが古いキーを自動で入れている場合は、欄を空にしてから貼り付けます。

10-3 送信などの操作を止める設定を置く

L HarnessのMCPには、読み取り専用のモードがありません。
そこで、Claude Codeの許可設定で、メッセージ送信や一斉配信などを禁止し、管理系の操作は毎回確認にします。
ステップ配信を作るときなどは、必要なものだけ、あとで禁止を外します。

mkdir -p ~/line-harness/.claude && cat > ~/line-harness/.claude/settings.local.json <<'EOF'
{
  "permissions": {
    "deny": [
      "mcp__line-harness__send_message",
      "mcp__line-harness__broadcast",
      "mcp__line-harness__create_scenario",
      "mcp__line-harness__enroll_in_scenario",
      "mcp__line-harness__create_form",
      "mcp__line-harness__create_rich_menu",
      "mcp__line-harness__create_tracked_link",
      "mcp__line-harness__upload_image"
    ],
    "ask": [
      "mcp__line-harness__manage_friends",
      "mcp__line-harness__manage_tags",
      "mcp__line-harness__manage_scenarios",
      "mcp__line-harness__manage_broadcasts",
      "mcp__line-harness__manage_rich_menus",
      "mcp__line-harness__manage_forms",
      "mcp__line-harness__manage_tracked_links",
      "mcp__line-harness__manage_staff",
      "mcp__line-harness__manage_ad_platforms"
    ]
  }
}
EOF
echo "許可設定を作りました"

$d = "$HOME\line-harness\.claude"
New-Item -ItemType Directory -Force -Path $d | Out-Null
[IO.File]::WriteAllText("$d\settings.local.json", @'
{
  "permissions": {
    "deny": [
      "mcp__line-harness__send_message",
      "mcp__line-harness__broadcast",
      "mcp__line-harness__create_scenario",
      "mcp__line-harness__enroll_in_scenario",
      "mcp__line-harness__create_form",
      "mcp__line-harness__create_rich_menu",
      "mcp__line-harness__create_tracked_link",
      "mcp__line-harness__upload_image"
    ],
    "ask": [
      "mcp__line-harness__manage_friends",
      "mcp__line-harness__manage_tags",
      "mcp__line-harness__manage_scenarios",
      "mcp__line-harness__manage_broadcasts",
      "mcp__line-harness__manage_rich_menus",
      "mcp__line-harness__manage_forms",
      "mcp__line-harness__manage_tracked_links",
      "mcp__line-harness__manage_staff",
      "mcp__line-harness__manage_ad_platforms"
    ]
  }
}
'@)
Write-Host "許可設定を作りました"

MCPは、新しく始めたClaude Codeのセッションで読み込まれます。
L Harnessのフォルダで、Claude Codeを始めます。

• ターミナルPowerShellで使う場合 下のコマンドを実行します。
• デスクトップアプリで使う場合 新しいセッションを作り、作業フォルダにL Harnessのフォルダを選びます。

cd ~/line-harness && claude

cd $HOME\line-harness
claude

Claude Codeが開いたら、次の文を貼り付けて送ります。

このフォルダに登録したMCPのline-harnessを使って、接続を確認してください。

・使ってよいのは、読み取りだけのツールです（account_summary、list_friends など）。
・メッセージ送信、一斉配信、シナリオ作成など、LINEの中身を変えるツールは使わないでください。
・APIキーやトークンなどの秘密の値は、画面にもファイルにも書かないでください。
・ファイルは変更しないでください。

確認できたら、使えたツール、友だちの人数、管理画面の人数と合っているかを、日本語で短く教えてください。

つながったら、こんな頼み方ができます

読み取りで答えられる頼み方の例です。そのまま貼り付けて使えます。

line-harnessで、この1か月に友だち追加した人を、追加された経路（QRコードやリンク）ごとに人数で表にしてください。読み取りだけで行ってください。

line-harnessで、タグが1つも付いていない友だちを一覧にして、どんなタグを付けると整理しやすいか、案を3つ出してください。タグを付ける操作はまだしないでください。

初回のご来店（来院）後7日間に届けるステップ配信の文章を、1日目、3日目、7日目の3通で下書きしてください。お店は〇〇（業種）です。まだL Harnessには登録しないでください。

友だちにタグを付ける、ステップ配信を登録するなど、LINEの中身を変える頼み方は、10-3の設定で確認や禁止になっています。
使うときは、内容を確かめてから許可してください。

テストでの確認が終わったら、本番のLINE公式アカウントで、STEP 2からSTEP 11までを、同じように行います。
そのとき、次の点に気をつけます。

• 変える前に、いまの状態を記録する本番のプロバイダー名、Messaging APIのチャネル名とチャネルID、いまのWebhook URL、あいさつメッセージなど応答設定の内容。戻すときに使います。
• LINEログインとLIFFは、本番と同じプロバイダーに新しく作るプロバイダーが違うと、同じお客さんでもLINEのIDが別になります。テストで集めた友だちの情報は、本番には引き継がれません。
• L Harnessは、同じものに追加するか、本番用にもう1つ入れるL Harnessは、1つの管理画面で複数のLINE公式アカウントを扱えます。テストと本番のデータを完全に分けたいときは、別のフォルダとプロジェクト名でSTEP 4〜5をもう一度行います。
• チャネルアクセストークンを発行し直さないほかのシステムが使っていれば、そのシステムの送信が止まります（STEP 5-1）。
• あいさつを先に用意してから、LINE側の自動返信を止めるSTEP 7の注意のとおりです。
• 切り替えたあとに確かめるスタッフのスマホで友だち追加してあいさつが届くか、メッセージが管理画面に届くか、予約・問診などほかのシステムがこれまでどおり動くか。

うまくいかないときの戻し方

記録しておいた内容に戻します。
Webhook URLを元のURLに戻し、応答設定を元に戻せば、L Harnessを入れる前の動きに戻ります。

Windows向けの手順は、公式の資料をもとに作っています。実際の画面の文言は、お使いの環境で少し違うことがあります。

参考にした公式の情報

• L Harness 公式リポジトリ（初期セットアップ、MCPサーバー）
• LINE Developers Messaging APIを始めよう、役割の管理
• Claude Code のインストール、MCP
• Cloudflare R2 の料金

画面の写真は、個人情報やアカウントの情報を塗りつぶしています。
画面の表示や言葉は、LINEやCloudflareの更新で変わることがあります。