Linsta AI 操作マニュアル

ChatGPT・Claudeと連携する（MCP・API・SDK）

ふだん使っているAI（Claude CodeやChatGPTなど、MCPに対応したAI）から、あなたのお店のLINEを操作できます。「先週の配信の反応を集計して」「金曜の昼に配るクーポンの下書きを作って」と話しかけるだけで、AIがLinsta AIのツールを呼び出して作業します。プロプラン向けの機能です。

できること

MCPサーバーには約30種類のツールが入っています。会話のなかでAIが必要なものを選んで使います。

大事な注意 — AIは「送信」までできます

ツールのなかには、その場で配信を実行できるものが含まれます。AIに任せきりにせず、次の2つを守ってください。

  1. 配信は「下書きで作って」と頼む。 下書きなら1通も送られません。内容を一斉配信や配信カレンダーで確認してから、自分の手で予約・送信してください。
  2. AI用のスタッフを分ける。 後述のAPIキーはスタッフごとに発行されます。AI用に権限「スタッフ」のメンバーを1人追加してそのキーを渡してください。アカウント設定やスタッフ管理には触れなくなり、あとで止めたいときもそのスタッフを削除するだけで済みます（配信の作成は権限に関係なくできるので、1の「下書きで作らせる」運用が本体です）。

準備1: APIキーを発行する

  1. スタッフ管理を開き、AI用のスタッフを追加します（権限は「スタッフ」がおすすめ）
  2. 追加した直後に表示されるキーをコピーします。この画面でしか表示されません
  3. 紛失したら「キー再生成」で作り直せます（古いキーは使えなくなります）

このキーがあれば配信の作成までできてしまうので、パスワードと同じ扱いで保管してください。チャットやメールに貼らないこと。

準備2: 接続先のURLを確認する

接続用のURL・コマンドは、管理画面のAI連携（MCP・API）にあなたの環境の実際の値で表示されます。そこからコピーするのが確実です。

手で組み立てる場合: 接続先のURLに、あなたの環境のID（英数字）が入ります。ホームの「友だち追加リンク」のURLで確認できます。


https://linsta.ai/w/ここがあなたのID/auth/line?...

/w/ から次の / までがIDです。以下では あなたのID と書きます。

Claude Codeにつなぐ（インストール不要）

ターミナルで次の1行を実行します（あなたのID と 発行したAPIキー を置き換えてください）。何もインストールされず、URLと鍵だけで繋がります。


claude mcp add --transport http linsta https://linsta.ai/w/あなたのID/api/mcp --header "Authorization: Bearer 発行したAPIキー"

npx で手元にサーバーを立てる従来の方法も引き続き使えます。


claude mcp add linsta -e LINE_HARNESS_API_URL=https://linsta.ai/w/あなたのID -e LINE_HARNESS_API_KEY=発行したAPIキー -- npx -y @line-harness/mcp-server

つながったか確かめるには、Claude Codeでこう聞いてみてください。

いまの友だち数と、直近の配信を教えて

数字が返ってくれば接続できています。

そのほかのMCP対応AIにつなぐ

リモートMCP（HTTP）に対応したアプリには、URLと認証ヘッダーだけで登録できます。


{
  "mcpServers": {
    "linsta": {
      "type": "http",
      "url": "https://linsta.ai/w/あなたのID/api/mcp",
      "headers": { "Authorization": "Bearer 発行したAPIキー" }
    }
  }
}

リモート接続に対応していないアプリでは、npx で手元にサーバーを立てる設定を登録してください（Claude Desktopの claude_desktop_config.json など）。


{
  "mcpServers": {
    "linsta": {
      "command": "npx",
      "args": ["-y", "@line-harness/mcp-server"],
      "env": {
        "LINE_HARNESS_API_URL": "https://linsta.ai/w/あなたのID",
        "LINE_HARNESS_API_KEY": "発行したAPIキー"
      }
    }
  }
}

プログラムから使う（API・SDK）

エンジニアの方向けです。同じAPIキーで、AIを介さず直接呼び出せます。

HTTP API — ベースURLは https://linsta.ai/w/あなたのID、認証は Authorization: Bearer APIキー ヘッダーです。


curl -H "Authorization: Bearer 発行したAPIキー" \
  "https://linsta.ai/w/あなたのID/api/friends/count"

TypeScript SDK — npm install @line-harness/sdk


import { LineHarness } from '@line-harness/sdk'

const client = new LineHarness({
  apiUrl: 'https://linsta.ai/w/あなたのID',
  apiKey: process.env.LINSTA_API_KEY!,
})

const { count } = await client.friends.count()

APIキーをコードに直接書かず、環境変数から読み込んでください。

よくあるつまずき