LINE Harness
導入ガイド

開くと、下の画像の画面が出ます。

LINE公式アカウントの開設ページ

上の画像で赤枠を付けた「LINE公式アカウントをはじめる」ボタンを押します。

画像なし（例外）

※ 押す場所は、手順1の画像に赤枠で示しています。

LINEヤフーBusiness ID（ビジネスアイディー）の新規登録画面に移ります。画面にも書いてあるとおり「この先に進むにはビジネスIDが必要です」——LINE公式アカウントを管理するための無料のIDです。

登録方法は人によって異なります。緑の「LINEアカウントで登録」でも作れますが、このガイドは「メールアドレスで登録」の前提で進めます。

「メールアドレスを入力してください。登録用のリンクをお送りします。」と表示されるので、メールアドレスの欄に自分のメールアドレスを入力します。

画像のメールアドレスは記入例です。ご自身のものを入力してください

「登録用のリンクを送信」ボタンを押すと、入力したメールアドレス宛に登録用のメールが届きます。メールの案内に沿って、次の順で進めます。

メールに書かれた登録用リンクを開く
名前とパスワードを登録
「LINE公式アカウントを作成」のフォームで、アカウント名・業種などを入力
アカウント名は、お店やサービスの名前でOKです（あとから友だちに表示される名前です）

画像なし（例外）

※ この先はメール画面・登録後の画面のため、画像はありません。画面の案内どおりに進めば大丈夫です。

登録が終わると、LINE公式アカウントの管理画面（LINE Official Account Manager）に入れるようになります。

この「アカウントリスト」に自分のアカウントが表示されていれば、Part 1 は完了です。

管理画面のアカウントリスト。画像ではアカウント名などをぼかしています

画像なし（例外）

※ この手順は上のアドレスを開くだけのため、画像はありません。開いた画面は、次の手順8の画像で確認できます。

この画面は英語ですが、入力するのは2つだけです。

Email: メールアドレス
Password: 新しく決めるパスワード（画面の案内どおり、8文字以上・数字1つ以上・記号1つ以上）

「Continue with Google」でGoogleアカウントから作ることもできます（人によって異なります）。このガイドはメールアドレスで登録する前提で進めます。

画面の「私はロボットではありません」にチェックを入れてから、「Sign up」を押します。

登録したメールアドレスに、Cloudflareから確認メールが届きます。メール内の確認ボタン（Verify email）を押せば、アカウント作成は完了です。

画像なし（例外）

※ メール画面のため画像はありません。もし、メールが見当たらないときは、迷惑メールフォルダも確認してください。

画像なし（例外）

※ この手順は上のアドレスを開くだけのため、画像はありません。開いた画面は、次の手順12の画像で確認できます。

緑色の「Node.js®を入手」ボタンを押して、ダウンロードページからインストーラをダウンロードします。「LTS版」と書かれているものが安定版です。

ダウンロードしたファイルを開き、画面の案内どおり「続ける」（Windowsは「Next」）を押していけばインストール完了です。設定を変える必要はありません。

画像なし（例外）

※ パソコンのインストール画面のため画像はありません。

ここから「ターミナル」という黒い画面を使います。コマンド（命令文）をコピーして貼り付けるだけなので、難しい操作はありません。

Mac: 画面右上の虫めがね（Spotlight）を押して「ターミナル」と入力し、Enter
Windows: スタートボタンを押して「PowerShell」と入力し、Enter

画像なし（例外）

※ パソコンの画面のため、画像はありません。

ターミナルに次をコピーして貼り付け、Enterを押します。

node -v

v22.18.0 のように「v」から始まる数字が出ればOKです（20以上であれば大丈夫です）。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次をコピーして貼り付け、Enterを押します（画面の見た目はMacとWindowsで少し異なりますが、コマンドはどちらも同じです）。

npx create-line-harness

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次が表示され、ブラウザが自動で開きます。

ブラウザが開きます。Cloudflare にログインしてください。

Part 2 で作ったアカウント（メールアドレスとパスワード、またはGoogle）でログインします。

自動で開くCloudflareのログイン画面

ログインすると、「Wrangler wants to access your account」（Wranglerがあなたのアカウントへのアクセスを求めています）という英語の確認画面が出ます。

Wrangler（ラングラー）とは、いまターミナルで動いている、このセットアップを代行してくれるCloudflare公式のツールの名前です。あなた自身がログインしてCloudflareに許可を出す操作なので、安全に進めて大丈夫です。青い「Authorize」（許可）ボタンを押してください。

ターミナルに「Cloudflare ログイン完了」と出れば成功です。ブラウザのタブは閉じてOKです。

人によっては、ここで次の質問が出ます（出なければそのまま次へ進んでください）。

「使用する Cloudflare アカウントを選択してください」→ 自分のアカウントを矢印キーで選んでEnter
「workers.dev サブドメイン名」→ あなたのシステムのURLの一部になる名前です。特に決まっていない方は、自分の屋号やサービス名を英小文字で入力してOKです。もし、「workers.dev サブドメインは全世界で早い者勝ちです。別の名前を入力してください。」と出たら、別の名前に変えて再入力します

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに、次の案内が表示されます。

═══ Step 1. Cloudflare 設定 ═══

R2 Object Storage の有効化（10GB まで無料）

https://www.cloudflare.com/ja-jp/ にアクセス
→ ログイン
→ サイドメニュー「Storage & Databases」
→ R2 Object Storage
→ Overview
→ クレジット＆個人情報を登録

完了したら Enter を押してください

R2（アールツー）は、リッチメニューなどの画像を保存する場所です。画面にも書いてあるとおり「10GB まで無料」ですが、有効化にはクレジットカードなど支払い方法の登録が必要です。

Cloudflareのダッシュボードは日本語で表示されるので、道順は「サイドメニューのストレージとデータベース → R2 オブジェクトストレージ → 概要」と読み替えてください（ターミナルの案内は英語メニュー名ですが、同じ場所です）。

案内の道順どおりに登録を済ませたら、ターミナルに戻ってEnterを押します。

画像ではアカウント情報などをぼかしています

プロジェクト名（Worker と D1 の名前に使われます）

特に決まっていない方は、そのままEnterでOKです（自動で line-harness という名前になります）。自分で決める場合は、英小文字・数字・ハイフンだけが使えます（例: my-line-bot）。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次の道順が表示されます。

═══ Step 2. Messaging API チャネル設定 ═══

■ Step 2-1. Channel ID 取得

https://manager.line.biz/ にアクセス
→ アカウント選択
→ 右上の歯車アイコンの設定
→ サイドメニュー「Messaging API」
→ プロバイダーを作成
→ Channel ID

ブラウザでLINE公式アカウントの管理画面（https://manager.line.biz/）を開いて自分のアカウントを選び、右上の「設定」を押します。左のサイドメニューに「Messaging API」があるので、それを押します。

画像ではアカウント名などをぼかしています

Messaging APIのページで、画面の案内に沿ってプロバイダーを作成します。もし、「プロバイダー名」を聞かれたら、会社名・屋号・自分の名前などを入力してOKです。

作成が終わるとステータスが「利用中」になり、「Channel情報」にChannel ID（数字の列）とChannel secretが表示されます。Channel IDを「コピー」ボタンで控えます。

※ プロバイダー作成の途中画面は、すでに設定済みの環境で撮影したため画像がありません。画面とターミナルの案内どおりに進めば大丈夫です。

設定完了後の画面です。画像では値をぼかしていますが、ご自身の画面には実際の値が表示されます

Channel ID（数字）

控えた数字を貼り付けてEnterを押します。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

■ Step 2-2. Channel Secret 取得
※ Step 2-1 で Channel ID を取得した際、Channel Secret も同じページに表示されています

チャネルシークレット（英数字）

画面にも書いてあるとおり、さっきChannel IDを見たのと同じページに「Channel Secret」（英数字の列）が表示されています。コピーして貼り付け、Enterを押します。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

■ Step 2-3. チャネルアクセストークン取得

https://developers.line.biz/console/ にアクセス
→ Step 2 で設定したプロバイダーを選択
→ Messaging API チャネル
→ 「Messaging API設定」タブ
→ チャネルアクセストークンを発行

チャネルアクセストークン（長期）

今度はLINE Developers Console（開発者向けの管理画面）を開きます。ログインは、Part 1 で作ったのと同じLINEヤフーBusiness IDでできます。

道順どおりに「Messaging API設定」タブの一番下へ進むと、「チャネルアクセストークン」の欄に「チャネルアクセストークン（長期）」と「発行」ボタンがあります。「発行」を押し、表示された長い文字列をコピーして、ターミナルに貼り付けてEnterを押します。

「Messaging API設定」タブの一番下にあります。画像ではチャネル名などをぼかしています

═══ Step 3. LINE Login チャネル設定 ═══

■ Step 3-1. チャネル ID 取得

https://developers.line.biz/console/ にアクセス
→ Step 2 で設定したプロバイダーを選択
→ 新規チャネル作成
→ LINE ログイン
→ 基本情報設定
→ チャネル ID

LINE Developers Consoleで、さっきのプロバイダーのページにある「新規チャネル作成」を押します。「チャネルの種類を選択してください」と出るので、「LINEログイン」を選びます。

作成フォームのチャネル名は、わかりやすい名前（例: 自分のサービス名＋login）でOKです。

画像ではプロバイダー名をぼかしています

作成すると「基本情報」の「チャネルID」に数字が表示されるので、控えます。

チャネル ID（数字）

控えた数字を貼り付けてEnterを押します。Part 5 で入力したMessaging APIのChannel IDとは別の数字なので、間違えないよう注意してください（ターミナルにも「Messaging API とは別」と表示されます）。

画像では値をぼかしています。ご自身の画面には実際の数字が表示されます

■ Step 3-2. LIFF ID 取得

https://developers.line.biz/console/ にアクセス
→ Step 2 で設定したプロバイダーを選択
→ LINE ログインチャネル
→ 「LIFF」タブ
→ 追加
→ LIFF アプリ名: 任意記入
→ サイズ: Full
→ エンドポイント URL: https://example.com（後で変更します）
→ Scope: openid, profile, chat_message.write
→ 友だち追加オプション: On (Aggressive)
→ LIFF ID をコピー

注意: LIFF アプリを「公開済み」にしてください（開発中だと動きません）

いま作ったLINE Loginチャネルの「LIFF」タブを開き、「追加」ボタンを押します。

画面に「新規にLIFFアプリを作成する場合はLINEミニアプリでの作成を推奨しています」という案内が表示されますが、LINE Harnessでは、ターミナルの道順どおりこの「追加」からLIFFアプリを作ればOKです。

「LIFFアプリを追加」のフォームが開きます（「すべての項目が必須です。」と表示されます）。道順のとおりに入力します。

LIFFアプリ名: 好きな名前でOK
サイズ: Full を選ぶ
エンドポイントURL: いったん https://example.com と入力します（あとの手順で本物のURLに変更します）
Scope: openid・profile・chat_message.write の3つにチェック
友だち追加オプション: On (Aggressive) を選ぶ

chat_message.writeにチェックを入れると「「chat_message.write」スコープを有効にしますか？」という確認が出るので、「有効化」を押します。

入力できたら、フォーム下部の「追加」ボタンを押して作成します。作成後、画面にも書いてあるとおり、LIFFアプリを「開発中」から「公開済み」に切り替えるのを忘れずに。

入力例の状態です

LIFF ID

作成したLIFFアプリに表示されている「LIFF ID」（「チャネルID-ランダム文字列」の形。例: 2009554425-4IMBmLQ9）をコピーして、ターミナルに貼り付けEnterを押します。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

ターミナルに次のような進行表示が流れます。数分かかることがあります（目安です）。

D1 データベース作成完了
R2 バケット作成完了
Worker デプロイ完了: https://＜あなたのURL＞.workers.dev
Admin UI デプロイ完了: https://＜あなたの管理画面＞.pages.dev

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

MCP 設定を .mcp.json に追加しますか？（Claude Code / Cursor 用）

Claude CodeやCursorといったAIツールからLINE Harnessを操作したい方は「Yes」、使っていない方・わからない方は「No」でOKです（あとから追加できます）。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

完了すると、ターミナルに「セットアップ完了！」と、仕上げにやること①〜⑥の案内が表示されます。

① LINE 応答設定を変更してください:
   → LINE Official Account Manager → 設定 → 応答設定
   チャット:             オフ
   あいさつメッセージ:   オフ
   Webhook:              オン
   応答メッセージ:       オフ

② Webhook URL を設定してください:
   https://＜あなたのWorker URL＞/webhook
   → LINE Official Account Manager → 設定 → Messaging API
   → Webhook URL に貼り付け → 「Webhookの利用」を ON にする

③ LINE Login チャネルの設定:
   → LINE Developers Console → LINE Login チャネル
   a. 「リンクされたLINE公式アカウント」で公式アカウントを選択
   b. 「友だち追加オプション」を On (aggressive) に設定
   c. Callback URL を登録（必須・PC 経由の友だち追加に必要）:
      → 「LINEログイン設定」タブを開く
      → 「ウェブアプリでLINEログインを利用する」を ON
      → 「Callback URL」に以下を貼り付け:
        https://＜あなたのWorker URL＞/auth/callback
      ※ スマホからの友だち追加は LIFF 経由なのでこの設定が無くても動きます。
         PC から QR を踏むと "Invalid redirect_uri" で silent fail します。

④ LIFF エンドポイント URL を更新してください:
   https://＜あなたのWorker URL＞?liffId=＜あなたのLIFF ID＞
   → LINE Developers Console → LINE Login チャネル → LIFF
   → エンドポイント URL を上記 URL に変更（?liffId= 必須）

⑤ 友だち追加 URL（この URL を共有してください）:
   https://＜あなたのWorker URL＞/auth/line?ref=setup
   → QR で直追加ではなくこの URL 経由で追加してもらう

⑥ 管理画面:
   https://＜あなたの管理画面 URL＞

API Key:
   ＜自動生成された64文字＞
   → この値は再表示できません。安全な場所に保存してください

この画面は消さずに残しておいてください。次のPartで、この①〜④を順番に実行します。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

完了画面の一番下に「API Key」という64文字の英数字が表示されています。管理画面へのログインに使う、あなた専用の鍵です。

画面にも書いてあるとおり「この値は再表示できません」。メモアプリやパスワード管理ツールに、今すぐコピーして保存してください。

画像なし（例外）

※ ターミナルの画面のため、画像はありません。

① LINE 応答設定を変更してください:
   → LINE Official Account Manager → 設定 → 応答設定
   チャット:             オフ
   あいさつメッセージ:   オフ
   Webhook:              オン
   応答メッセージ:       オフ

LINE公式アカウントの管理画面（https://manager.line.biz/）で「設定」→「応答設定」を開き、「応答機能」にある4つのスイッチを案内どおりに切り替えます。

切り替え後の完成形です。この状態になっていればOKです

② Webhook URL を設定してください:
   https://＜あなたのWorker URL＞/webhook
   → LINE Official Account Manager → 設定 → Messaging API
   → Webhook URL に貼り付け → 「Webhookの利用」を ON にする

ターミナルに表示されている、あなた専用のWebhook URL（/webhook で終わるURL）をコピーして、管理画面の「設定」→「Messaging API」の「Webhook URL」に貼り付けて「保存」し、「Webhookの利用」をONにします。

手順22で開いたのと同じMessaging APIのページです。画像では設定値をぼかしています

③ LINE Login チャネルの設定:
   → LINE Developers Console → LINE Login チャネル
   a. 「リンクされたLINE公式アカウント」で公式アカウントを選択
   b. 「友だち追加オプション」を On (aggressive) に設定
   c. Callback URL を登録（必須・PC 経由の友だち追加に必要）:
      → 「LINEログイン設定」タブを開く
      → 「ウェブアプリでLINEログインを利用する」を ON
      → 「Callback URL」に以下を貼り付け:
        https://＜あなたのWorker URL＞/auth/callback
      ※ スマホからの友だち追加は LIFF 経由なのでこの設定が無くても動きます。
         PC から QR を踏むと "Invalid redirect_uri" で silent fail します。

LINE Developers ConsoleのLINE Loginチャネルで、次の3つを設定します。

a. 「リンクされたLINE公式アカウント」で、自分の公式アカウントを選ぶ
b. 「友だち追加オプション」を On (aggressive) にする
c. 「LINEログイン設定」タブで「ウェブアプリでLINEログインを利用する」をONにし、「コールバックURL」にターミナル表示のURL（/auth/callback で終わるURL）を貼り付ける

「LINEログイン設定」タブの画面です

④ LIFF エンドポイント URL を更新してください:
   https://＜あなたのWorker URL＞?liffId=＜あなたのLIFF ID＞
   → LINE Developers Console → LINE Login チャネル → LIFF
   → エンドポイント URL を上記 URL に変更（?liffId= 必須）

手順30で https://example.com と仮置きしたエンドポイントURLを、ターミナルに表示されている本物のURLに差し替えます。LIFFタブで自分のLIFFアプリを開き、「エンドポイントURL」の行の「編集」を押して、URLの後ろの ?liffId=... の部分まで含めて、そのままコピーして貼り付けてください。

画像では値をぼかしています。この画面例は別の設定のLIFFアプリなので、サイズやScopeの表示がご自身と違っていても問題ありません

ターミナルの完了案内⑤に表示されている友だち追加URL（/auth/line?ref=setup で終わるURL）を、スマホのLINEで開き、自分の公式アカウントを友だち追加します。

ターミナルにも書いてあるとおり、QRコードで直接追加するのではなく、このURL経由で追加するのがLINE Harnessの流儀です（誰がどこから来たかを計測できるのがこのURLの役目です）。

自分のスマホにURLを送る方法は何でもOKです（自分宛てのメール、メモの同期など）。

画像なし（例外）

※ スマホの画面のため、画像はありません。

パソコンのブラウザで、完了案内⑥の管理画面URL（.pages.dev で終わるURL）を開きます。

ログイン画面が出たら、手順35で保存したAPI Keyを貼り付けてログインします。

画像なし（例外）

※ ログイン後の画面のため画像はありません。

管理画面の「友だち」ページを開き、さっき友だち追加した自分のLINEアカウントが表示されていれば——セットアップは全て完了です。おつかれさまでした 🎉

これで、ステップ配信・タグ付け・フォームなどの全機能が使える状態になっています。

画像なし（例外）

※ ログイン後の画面のため画像はありません。