エルグラムのMCP接続について

エルグラムは、AI（ChatGPT・Claude）と接続するための仕組みとして、MCPに対応しています。
本記事では、MCPを通じてエルグラムを操作・情報取得するためのツール仕様を説明します。

MCP接続の手順や活用例はこちらをご確認ください。

使用イメージ

エルグラムのMCP接続では、16カテゴリ・約40種類のデータを取得・操作が可能です。

接続したAIチャットから、自然言語で質問して使用します。

取得できる情報一覧

ツール名

各機能にはツール名と呼ばれる識別名（例：list_bots）が割り当てられています。
ツール名はAIがエルグラムの特定の機能を呼び出すための名前です。

「list_bots を使ってアカウント一覧を取得して」のようにAIへ指示する際に使用します。

通常はAIが自動的に適切なツールを判断するため、ツール名を覚えておく必要はありません。

入力パラメータ

各ツールには、入力パラメータと呼ばれる絞り込み条件を指定できます。

たとえば、下記のような条件の指定が可能です。

• 先月1ヶ月分のデータを取得する
• 特定のアカウントのデータだけを見る

ほぼすべてのツールは、最初に「アカウント一覧」でアカウントを特定してから使用します。
複数アカウントをエルグラムで管理している場合は、対象のアカウントをAIに伝えてください。

1. Instagramアカウント情報

接続中のInstagramアカウントの一覧と基本情報を取得できます。
すべてのツール利用の起点となる情報です。

ツール名	取得できる情報	内容
list_bots	アカウント一覧	アカウントID（bot_id）・表示名・Instagramユーザーネーム・フォロワー総数／アクティブ数／ブロック数・フォロー数・投稿数

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_bots	page	任意	ページ番号（デフォルト：1）
list_bots	limit	任意	1ページあたりの件数（デフォルト：100）

2. フォロワー統計・メッセージ統計

フォロワー数の推移とメッセージ送信数の日別統計を確認できます。

ツール名	取得できる情報	内容
get_friend_stats	フォロワー統計	日別フォロワー増減（フォロー数・フォロー解除数・純変動数・累計フォロワー数）直近1年分
get_message_send_summary	メッセージ送信統計	1:1チャット・一斉配信・自動応答・その他に分類した日別送信数（デフォルト直近30日）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
get_friend_stats	bot_id	必須	アカウントID
get_message_send_summary	bot_id	必須	アカウントID
get_message_send_summary	start_date	任意	開始日（yyyy-MM-dd）
get_message_send_summary	end_date	任意	終了日（yyyy-MM-dd）

3. ユーザー（フォロワー）管理

フォロワーの一覧取得と、タグ・パーソナル情報を含む詳細プロフィールを確認できます。

ツール名	取得できる情報	内容
list_friends	フォロワー一覧	ステータス別（アクティブ / DM未読 / ブロック / 非表示）の絞り込み表示
get_friend_detail	ユーザー詳細	タグ一覧・パーソナル情報・フォロー状態・InstagramプロフィールURL（最大100人一括取得）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_friends	bot_id	必須	アカウントID
list_friends	status	任意	all / active / dm_pending / blocked / hidden
get_friend_detail	bot_id	必須	アカウントID
get_friend_detail	user_ids	必須	ユーザーIDのカンマ区切り（最大100件）

4. 1:1チャット

フォロワーとのDM会話一覧・メッセージ履歴の確認と、メッセージの送信ができます。

ツール名	取得できる情報	内容
list_conversations	会話一覧	全チャット・最終メッセージ・確認ステータス・対応ステータス
get_conversation_detail	メッセージ履歴	過去1年分のDM履歴・送信元（テンプレート / シナリオ / 一斉配信 / フォーム）の確認（最大100人分）
send_message	メッセージ送信	特定ユーザーへのテキストDM送信

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_conversations	bot_id	必須	アカウントID
list_conversations	confirm_filter	任意	all / unconfirmed
get_conversation_detail	bot_id	必須	アカウントID
get_conversation_detail	user_ids	必須	ユーザーIDのカンマ区切り（最大100件）
get_conversation_detail	from_date	任意	開始日（デフォルト：1年前）
get_conversation_detail	to_date	任意	終了日（デフォルト：本日）
send_message	bot_id	必須	アカウントID
send_message	line_user_id	必須	送信先ユーザーの数値ID
send_message	content	必須	送信するテキスト内容

5. タグ管理

タグの一覧と、特定のタグが付いたユーザーを確認できます。

ツール名	取得できる情報	内容
list_tags	タグ一覧	タグ名・対象ユーザー数・人数上限・フォルダ情報
get_tag_friends	タグ別ユーザー一覧	特定タグが付いた全ユーザーの一覧

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_tags	bot_id	必須	アカウントID
get_tag_friends	bot_id	必須	アカウントID
get_tag_friends	tag_id	必須	タグID

6. パーソナル情報管理

電話番号・性別・ポイントなどのカスタムフィールドと、対象ユーザーを確認できます。

ツール名	取得できる情報	内容
list_friend_info_fields	フィールド一覧	データタイプ別（選択肢 / 記述 / 年月日 / 画像 / PDF / ポイント）のフィールド一覧
get_field_friends	フィールド別ユーザー	特定フィールドにデータが入力されているユーザーの一覧

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_friend_info_fields	bot_id	必須	アカウントID
get_field_friends	bot_id	必須	アカウントID
get_field_friends	field_id	必須	フィールドID

7. 一斉配信

配信一覧・ステータス・フィルタ条件・送信結果を確認できます。

ツール名	取得できる情報	内容
list_broadcasts	配信一覧	テンプレート・絞り込み条件・送信後アクション・配信ステータス（配信済み / 配信予約 / 下書き / 配信中 / 未配信）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_broadcasts	bot_id	必須	アカウントID
list_broadcasts	from_date	任意	開始日（yyyy-MM-dd）
list_broadcasts	to_date	任意	終了日（yyyy-MM-dd）

8. 自動応答

コメント・DM・メンション・ライブに対する自動応答ルールの設定内容とトリガー履歴を確認できます。対応しているトリガータイプは「投稿・リールへのコメント」「ストーリーズへのコメント」「ストーリーズメンション」「ライブ配信コメント」「DM受信」の5種類です。

ツール名	取得できる情報	内容
list_autoreply	ルール一覧	トリガータイプ・キーワード・スケジュール・稼働ステータス
get_autoreply_detail	ルール詳細	キーワードロジック・除外ワード・ユーザー絞り込み・アクション・遅延送信設定
get_autoreply_reply_history	トリガー履歴	自動応答が発動した履歴・ユーザー情報・コメント内容

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_autoreply	bot_id	必須	アカウントID
get_autoreply_detail	bot_id	必須	アカウントID
get_autoreply_detail	auto_reply_ids	必須	ルールIDのカンマ区切り（最大100件）
get_autoreply_reply_history	bot_id	必須	アカウントID
get_autoreply_reply_history	auto_reply_id	任意	特定ルールIDで絞り込み
get_autoreply_reply_history	from_date	任意	開始日
get_autoreply_reply_history	to_date	任意	終了日

9. ダイレクトアクション

QRコードやリンク経由のアクション設定とスキャン統計を確認できます。

ツール名	取得できる情報	内容
list_direct_actions	アクション一覧	読み取り数・フォロワー数・稼働状態・有効期限
get_direct_action_detail	アクション詳細	設定情報・日別スキャン数・ユニーク数・新規フォロワー数（期間指定可）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_direct_actions	bot_id	必須	アカウントID
get_direct_action_detail	bot_id	必須	アカウントID
get_direct_action_detail	direct_action_ids	必須	アクションIDのカンマ区切り（最大100件）
get_direct_action_detail	from_date	任意	統計開始日（デフォルト：1年前）
get_direct_action_detail	to_date	任意	統計終了日（デフォルト：本日）

10. フォーム

フォーム・アンケートの設定内容とユーザーの回答データを確認できます。

ツール名	取得できる情報	内容
list_forms	フォーム一覧	回答数・フォルダ・呼び出しコード
get_form_detail	フォーム詳細	フィールド設定・開封時/送信時アクション・回答頻度設定
get_form_responses	回答データ	ユーザーの回答内容・回答日時・ページ表示時間

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_forms	bot_id	必須	アカウントID
get_form_detail	bot_id	必須	アカウントID
get_form_detail	form_ids	必須	フォームIDのカンマ区切り（最大100件）
get_form_responses	bot_id	必須	アカウントID
get_form_responses	form_id	必須	フォームID

11. 固定メニュー

DM画面下部に表示される固定メニューの設定とタップ統計を確認できます。

ツール名	取得できる情報	内容
list_persistent_menus	メニュー一覧	ボタン数・表示/非表示ステータス
get_persistent_menu_detail	メニュー詳細	ボタンごとのアクション/URL設定・タップ数・ユニークユーザー数（期間指定可）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_persistent_menus	bot_id	必須	アカウントID
get_persistent_menu_detail	bot_id	必須	アカウントID
get_persistent_menu_detail	persistent_menu_ids	必須	メニューIDのカンマ区切り（最大100件）
get_persistent_menu_detail	from_date	任意	統計開始日（デフォルト：30日前）
get_persistent_menu_detail	to_date	任意	統計終了日（デフォルト：本日）

12. URL分析

トラッキングURL経由の送信数・クリック数を測定できます。

ツール名	取得できる情報	内容
list_urls	URL一覧	送信数・タップ数・タップ率
get_url_detail	URL詳細	送信/クリック統計・対象ユーザーリスト（送信先またはクリックしたユーザー）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_urls	bot_id	必須	アカウントID
get_url_detail	bot_id	必須	アカウントID
get_url_detail	url_ids	必須	URL IDのカンマ区切り（最大100件）
get_url_detail	type_filter	任意	sent（デフォルト）/ clicked

13. 商品販売

単品・サブスクリプション商品の管理、売上統計、注文履歴を確認できます。

ツール名	取得できる情報	内容
list_products	商品一覧	価格・決済タイプ（1回/毎週/毎月/3ヶ月/6ヶ月/毎年）・販売統計
get_product_detail	商品詳細	トライアル設定・在庫制限・購入制限・各イベント時の自動アクション・詳細統計
get_product_order_history	注文履歴	決済一覧・金額・ステータス・トライアル有無・継続回数（期間指定可）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_products	bot_id	必須	アカウントID
get_product_detail	bot_id	必須	アカウントID
get_product_detail	product_id	必須	商品ID
get_product_order_history	bot_id	必須	アカウントID
get_product_order_history	product_id	必須	商品ID
get_product_order_history	from_date	任意	開始日
get_product_order_history	to_date	任意	終了日
get_product_order_history	include_test	任意	テスト決済含む（デフォルト：false）

14. サロン・面談予約

サロン予約カレンダーのサービスメニュー・スタッフ・予約履歴を確認できます。

ツール名	取得できる情報	内容
list_salons	サロン一覧	タイプ・サービス数・スタッフ数・総予約数
get_salon_detail	サロン詳細	サービスメニュー・スタッフ・予約フォーム・承認設定・バッファタイム
get_salon_bookings	予約履歴	サービス名・スタッフ名・日時・ステータス・支払い情報・フォーム回答（期間指定可）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_salons	bot_id	必須	アカウントID
get_salon_detail	bot_id	必須	アカウントID
get_salon_detail	salon_id	必須	サロンID
get_salon_bookings	bot_id	必須	アカウントID
get_salon_bookings	salon_id	必須	サロンID
get_salon_bookings	from_date	任意	予約日フィルタ開始
get_salon_bookings	to_date	任意	予約日フィルタ終了

15. レッスン予約

レッスン・教室の予約カレンダー管理とコース設定・予約履歴を確認できます。

ツール名	取得できる情報	内容
list_lesson_calendars	カレンダー一覧	コース数・累計予約数・本日の予約数
get_lesson_calendar_detail	カレンダー詳細	コース一覧・予約フォーム・承認設定・受付/締切設定
get_lesson_calendar_bookings	予約履歴	コース名・日時・ステータス・決済情報・フォーム回答（期間指定可）

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_lesson_calendars	bot_id	必須	アカウントID
get_lesson_calendar_detail	bot_id	必須	アカウントID
get_lesson_calendar_detail	calendar_id	必須	カレンダーID
get_lesson_calendar_bookings	bot_id	必須	アカウントID
get_lesson_calendar_bookings	calendar_id	必須	カレンダーID
get_lesson_calendar_bookings	from_date	任意	予約日フィルタ開始
get_lesson_calendar_bookings	to_date	任意	予約日フィルタ終了

16. 投稿管理

Instagram投稿（フィード・リール）の一覧とインサイト分析、コメントを確認できます。

ツール名	取得できる情報	内容
list_posts	投稿一覧	ステータス別（公開済み/予約/下書き/エラー）・タイプ別（フィード/リール）のフィルタ・いいね/コメント/保存数
get_post_detail	投稿インサイト	いいね数・コメント数・保存数・リーチ数・シェア数・エンゲージメント数・プロフィール訪問数・フォロワー獲得数・リール再生回数・リール平均視聴時間
list_post_comments	コメント一覧	コメント内容・ユーザー名・投稿日時

入力パラメータ

対象ツール	パラメータ	必須/任意	説明
list_posts	bot_id	必須	アカウントID
list_posts	status	任意	posted / scheduled / draft / error / all
list_posts	type	任意	feed / reel / all
get_post_detail	bot_id	必須	アカウントID
get_post_detail	post_id	必須	投稿ID
list_post_comments	bot_id	必須	アカウントID
list_post_comments	post_id	必須	投稿ID

よくある質問