MCP API
外部システムは、サブスクラインの MCP エンドポイントへ HTTP リクエストを送り、会員プロフィールの取得と部分更新、予約・契約・決済履歴の取得、予約のキャンセルと契約の休会・再開・解約ができます。このページでは、外部システムの担当者が実装するときに必要な情報をまとめます。
MCP の JSON-RPC API です
このページの 1〜7 で説明する会員プロフィール・予約・契約・決済履歴のツールは、拡張版の /api/v2/mcp でのみ利用できます。 通常の REST API ではありません。すべて同じ MCP エンドポイントへ POST し、JSON 本文の method と params.name で操作を指定します。
接続情報
| 項目 | 値 |
|---|---|
| HTTP メソッド | POST |
| エンドポイント | https://api.subscline.jp/api/v2/mcp |
| 認証 | Authorization: Bearer subscline_... |
| Content-Type | application/json |
| 形式 | JSON-RPC 2.0(MCP Streamable HTTP) |
1. 接続トークンを発行する
サブスクライン管理画面の「設定」>「AI/MCP 連携」>「接続を作成」で、外部ツール専用の接続を作成します。
- 会員情報を取得する場合:
read - 会員情報を更新する場合:
member_profile_write - 取得と更新の両方を行う場合:
readとmember_profile_write - 予約のキャンセル・契約の休会/再開/解約を行う場合:
member_operations_write(対象の予約・契約を探すために、通常はreadも付けます)
write は配信などの下書き作成用です。write だけでは updateMemberProfile や予約・契約の更新ツールはツール一覧に表示されず、直接呼び出してもscope不足になります。予約・契約の更新はお客様への通知や請求日・解約日・請求額の変更を伴うため、member_profile_write とも別の member_operations_write を必要な接続にだけ付けてください。会員の個人情報を更新する必要がある接続にだけ member_profile_write を明示的に付けてください。
postback は自動応答の外部発火専用です。会員情報の取得・更新には使用せず、read / write / member_profile_write / member_operations_write / admin_member_read と同じトークンにも設定できません。
external_member_sync は外部の会員システムから配信対象のラベルと会員ランクを送る専用のスコープです(会員連携 API)。MCP のツールには使えず、他のスコープと同じトークンにも設定できません。
このページの getMemberProfile / updateMemberProfile を使うだけなら admin_member_read は不要です。admin_member_read は、管理画面の会員一覧・契約・注文をAIから参照するための許可です(MCPコネクター)。
トークンは作成直後に一度だけ表示されます。外部ツールのサーバー側で秘密情報として保管し、HTML や JavaScript、URL のクエリには入れないでください。
2. 利用可能なツールを確認する
発行したトークンで tools/list を呼ぶと、許可されたスコープのツールだけが返ります。
curl --request POST 'https://api.subscline.jp/api/v2/mcp' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'会員情報の連携で使うツールは次の 11 です。
| ツール | 必要なスコープ | 内容 |
|---|---|---|
getMemberProfile | read | 会員プロフィールを取得する |
updateMemberProfile | member_profile_write | 指定したプロフィール項目だけを更新する |
listReservations | read | 予約日の期間・会員・予約状態で絞り込んだ予約の一覧を取得する |
listMemberSubscriptions | read | 会員1人の契約(プラン・状態・請求期間・解約予定)を取得する |
listMemberPayments | read | 会員1人のカード決済・請求の履歴を取得する |
cancelReservation | member_operations_write | 予約1件をキャンセルする |
pauseSubscriptionBilling | member_operations_write | 契約の請求を再開日まで一時停止(休会)する |
resumeSubscriptionBilling | member_operations_write | 契約の請求の一時停止を取り消して元の請求日に戻す |
cancelSubscriptionAtPeriodEnd | member_operations_write | 契約を現在の請求期間の終了日で解約する |
previewSubscriptionCancellation | member_operations_write | 契約を指定日で解約したときの最終請求額を確認する |
confirmSubscriptionCancellation | member_operations_write | 確認した日付指定の解約を確定する |
3. 対象会員を指定する
対象会員は、次のどちらかで指定します。2 方式を同じリクエストで併用することはできません。
サブスクラインの会員 ID で指定する
すでにサブスクラインの memberId を外部ツール側で保持している場合に使います。
{
"memberId": "member_example_123"
}LINE ユーザー ID で指定する
lineConfigId と lineUserId を組み合わせて指定します。
{
"lineConfigId": "line_config_example_123",
"lineUserId": "U0123456789abcdef0123456789abcdef"
}LINE Provider を確認してください
LINE ユーザー ID は LINE Provider ごとに異なります。外部ツールが取得した lineUserId と、サブスクラインに接続している LINE 公式アカウントが同じ LINE Provider に属している必要があります。異なる Provider のユーザー ID では同じ利用者を特定できません。
サブスクラインにまだ会員として登録されていない LINE ユーザー ID でも、getMemberProfile は指定した LINE 公式アカウントでその利用者のプロフィールを取得できるかを LINE に確認します。取得できれば(友だち、または LINE 公式アカウントにメッセージを送ったことがある利用者)、その場で友だちとして会員を作成し、プロフィールを返します。作成直後は氏名・メールアドレスなどのプロフィール項目は空(null)です。2 回目以降は同じ memberId が返ります。LINE 公式アカウントとサブスクラインを連携する前から友だちだったお客様も、この方法で memberId を取得できます。
- 会員の作成で、あいさつメッセージ・自動応答・リッチメニューの切り替えなど、友だち追加のときの処理は行いません。
- LINE ユーザー ID の形式(
Uに続く、0〜9 と小文字の a〜f からなる 32 文字)に合わない場合、LINE でプロフィールを取得できない場合(友だちでない・存在しない ID など)、管理画面で削除した会員の場合は、会員を作成せず「指定された会員が見つかりません」を返します。 - LINE からの応答が約 1 秒以内に無い場合や、LINE 側でエラーが起きた場合も、会員を作成せず「指定された会員が見つかりません」を返します。時間をおいて再度呼び出してください。
updateMemberProfileは会員を作成しません。未登録の LINE ユーザー ID を更新したい場合は、先にgetMemberProfileを呼び出してください。- 会員を作成することがあるため、
getMemberProfileはツール一覧で「参照のみ」の扱い(readOnlyHint)になっていません。利用に必要な権限はreadのままです。
lineConfigId は、管理画面サイドバー「LINE」>「LINE公式アカウント」で対象アカウントの「編集」を開き、「アカウントID(lcid / lineConfigId)」の横のコピーボタンでコピーした値を使用します。トークンを発行したテナントと異なる memberId / lineConfigId を指定しても取得・更新できません。
4. 会員プロフィールを取得する(read)
curl --request POST 'https://api.subscline.jp/api/v2/mcp' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "getMemberProfile",
"arguments": {
"lineConfigId": "line_config_example_123",
"lineUserId": "U0123456789abcdef0123456789abcdef"
}
}
}'成功時は result.isError が false になり、result.content[0].text に JSON 文字列でプロフィールが入ります。
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "{\"memberId\":\"member_example_123\",\"email\":\"user@example.com\",\"tel\":\"09012345678\"}"
}
],
"isError": false
}
}5. 会員プロフィールを更新する(member_profile_write)
profile に指定した項目だけを更新します。たとえばメールアドレスと電話番号だけを送った場合、氏名や住所などの既存値は変更しません。
curl --request POST 'https://api.subscline.jp/api/v2/mcp' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "updateMemberProfile",
"arguments": {
"lineConfigId": "line_config_example_123",
"lineUserId": "U0123456789abcdef0123456789abcdef",
"profile": {
"email": "user@example.com",
"tel": "09012345678",
"prefCode": 13,
"zipCode": "1000001",
"address": "東京都千代田区"
}
}
}
}'成功時の result.content[0].text には、更新結果と更新対象の項目名だけが入ります。member_profile_write だけを許可した接続へ既存の会員情報は返りません。更新後の値を取得する必要がある場合は、read も許可した接続で別途 getMemberProfile を呼び出してください。
{
"updated": true,
"updatedFields": ["email", "tel", "prefCode", "zipCode", "address"]
}更新できる項目は次のとおりです。
| 項目 | 内容・形式 |
|---|---|
displayName | 表示名 |
firstName / lastName | 名 / 姓 |
furigana | 氏名のフリガナ(カタカナ) |
firstNameKana / lastNameKana | 名 / 姓のカナ |
gender | MALE / FEMALE / NO_ANSWER |
email | メールアドレス |
birthday | 生年月日。例: 1990-01-31 |
tel | 電話番号。例: 09012345678 |
prefCode | 都道府県 ID。例: 東京都は 13 |
zipCode | 郵便番号。例: 1000001 |
address / address2 | 住所 / 建物名など |
zipCode または address を更新する場合は、住所とセグメント判定に使う都道府県が食い違わないよう、同じ profile に prefCode も指定してください。空文字での削除や、表にない項目の更新はできません。同じ内容を再送しても予約・契約・配信・通知などの追加処理は発生しませんが、プロフィールの更新日時は再送のたびに更新されます。
6. 予約・契約・決済履歴を取得する(read)
いずれも read のトークンで呼び出せます。管理画面の予約一覧・会員の契約・会員詳細の「決済・取引履歴」と同じ内容を、接続したテナントの範囲だけで返します。
予約の一覧(listReservations)
from と to に予約日(日本時間・両端の日を含む)を YYYY-MM-DD で指定します。期間は 93 日以内です。memberId で会員を、statuses で予約状態(provisional 仮予約 / confirmation 予約確定 / waiting_for_cancel キャンセル待ち / cancel キャンセル / completion 完了)を絞り込めます。
curl --request POST 'https://api.subscline.jp/api/v2/mcp' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "listReservations",
"arguments": {
"from": "2026-11-01",
"to": "2026-11-30",
"statuses": ["confirmation"],
"limit": 50,
"offset": 0
}
}
}'予約は予約日時の古い順に並びます。1 回に返る件数は limit(1〜100、既定 50)までです。result.content[0].text の pagination.hasMore が true のときは、offset に limit を足して続きを取得してください(offset の上限は 5000)。各予約には予約 ID・状態・開始/終了日時・店舗・メニュー名・会員・人数・合計金額・支払方法・決済日・作成日時が入ります。
会員の契約(listMemberSubscriptions)
対象会員は3. 対象会員を指定すると同じ方法で指定します。会員の契約を新しい順に最大 50 件返し、それぞれにプラン・状態(active / trialing / cancellation_scheduled / pause_scheduled / paused / past_due / unpaid / canceled など)・現在の請求期間・次回請求日・解約予定日・解約日・請求の一時停止(開始日・再開日・反映済みか)・未払いの件数と金額が入ります。
会員の決済・請求履歴(listMemberPayments)
対象会員の指定方法は契約と同じです。カード決済・請求とカード登録の履歴を新しい順に返します。決済とカード登録はそれぞれ新しい順に最大 100 件までを取得し、どちらかにそれより古い履歴が残っているときは truncated が true になります。お客様が決済画面を開いただけで確定していないカード登録は含みません。各履歴には決済 ID・種別(サブスク請求 / 都度の決済 / カード登録)・状態・金額・通貨・返金済み金額・失敗理由・日時が入ります。状態は succeeded(成功)/ failed(失敗)/ processing(処理中)/ incomplete(未完了)/ canceled(取消)/ refunded(返金)のいずれかで、incomplete は本人認証(3Dセキュア)などの途中で止まり、カードが登録されなかったカード登録です。カード番号やカードの種類は返しません。決済サービスに顧客情報が作られていない会員は hasPaymentAccount が false になり、履歴は空です。
必要なスタッフ権限
接続したアカウントに、管理画面の該当画面と同じ権限が必要です。管理画面で発行した接続トークンは、ログイン時のメール承認を有効にしている環境では会社の ROOT アカウントの権限で判定されます。OAuth で認可した接続は、認可したアカウントの権限で判定されます。
| ツール | 必要な権限 |
|---|---|
listReservations | 予約のメニュー権限 |
listMemberSubscriptions | 契約のメニュー権限 |
listMemberPayments | ユーザーのメニュー権限と、売上明細タブの表示権限 |
ご契約プランで予約・契約の機能を使っていない場合は、対応するツールはエラーになります。
7. 予約をキャンセルする・契約を休会/再開/解約する(member_operations_write)
管理画面で同じ操作をしたときと同じ処理(予約枠の解放、お客様への通知、決済サービス上の請求日や解約日の変更)を行います。予約のキャンセルでは決済済みの代金は返金されません。返金が必要な場合は管理画面の売上明細から行ってください。テスト用の会員・契約で動作を確認してから本番の連携を有効にしてください。
| 操作 | ツール | 主な引数 | 同じ要求を再送したとき |
|---|---|---|---|
| 予約をキャンセル | cancelReservation | reservationId、notifyMember(お客様へ通知するか。既定は true) | すでにキャンセル済みなら何もせず already_cancelled |
| 請求を一時停止(休会) | pauseSubscriptionBilling | subscriptionId、resumeDate(再開日=次の請求日)、pauseStartDate(省略すると、まだ始まっていない停止の予約があればその開始日を保ち、無ければ即時) | 同じ日付で設定済みなら何もせず already_scheduled |
| 一時停止を取り消して再開 | resumeSubscriptionBilling | subscriptionId | 停止していなければ何もせず not_paused |
| 請求期間の終了日で解約 | cancelSubscriptionAtPeriodEnd | subscriptionId | 同じ日で解約予定なら already_scheduled、解約済みなら already_canceled |
| 日付を指定して解約 | previewSubscriptionCancellation → confirmSubscriptionCancellation | subscriptionId・cancelDate → batchId | 同じ batchId の確定を再送しても二重に解約せず、前回の結果を返す |
同じ予約・契約への操作がまだ処理中のときに届いた要求は、待たずに result.isError: true(「同じ予約・契約への操作を実行中です」)で断ります。この場合は失敗として扱わず、少し待ってから同じ要求を再送してください。処理が済んでいれば、最新の状態から already_cancelled などが返ります。
reservationId は listReservations、subscriptionId は listMemberSubscriptions の結果に含まれる ID です。日付は日本時間の YYYY-MM-DD で指定します。
日付を指定した解約は、管理画面と同じく 2 段階です。previewSubscriptionCancellation で解約日の終わり(日本時間 23:59:59)に解約したときの最終請求額(amountDue)と実際の解約日時(effectiveCancelAt)を確認し、問題なければ返された batchId を confirmSubscriptionCancellation に渡して確定します。確定できるのは、接続のアカウントが作った単件の確認結果の batchId だけです。管理画面で発行した接続トークンはメール承認が有効な環境では会社の ROOT アカウントとして動くため、同じ会社の別の接続トークンや、ROOT が管理画面で確認だけして確定していない単件の日付指定解約も確定できます。一括の解約の確認結果は確定できません。確認の段階では解約されません。確認結果の items[].status が preview_failed のときは error に理由が入り、確定しても解約されません。
curl --request POST 'https://api.subscline.jp/api/v2/mcp' \
--header 'Authorization: Bearer subscline_xxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "pauseSubscriptionBilling",
"arguments": {
"subscriptionId": "subscription_example_123",
"resumeDate": "2027-01-01"
}
}
}'接続したアカウントには、予約のキャンセルに予約メニューと予約の管理権限、契約の操作にユーザーメニューと会員の契約の管理権限が必要です。SUPER アカウントでも、接続先の会社に有効な所属が無ければ実行できません。管理画面で発行した接続トークンは、ログイン時のメール承認を有効にしている環境では会社の ROOT アカウントの権限で判定されます。定期便の次回分をスキップしている契約やプラン変更を予約している契約など、管理画面で操作できない状態の契約は、管理画面と同じ理由のエラーになります。
エラーの確認
- HTTP
401: Bearer トークンがない、無効化済み、または値が誤っている result.isError: trueで権限エラー: トークンに必要なread/member_profile_write/member_operations_writeがないresult.isError: trueでスタッフ権限エラー: 接続を作成・認可したアカウントにユーザー閲覧権限、またはユーザー情報編集権限がないresult.isError: trueで「指定された会員が見つかりません」: ID が誤っている、LINE Provider が異なる、トークンと対象会員のテナントが異なる、lineUserIdの利用者が LINE 公式アカウントの友だちではない、または LINE への確認が時間内に終わらなかったresult.isError: trueで「指定された予約が見つかりません」「指定された契約が見つかりません」: ID が誤っている、またはトークンと対象のテナントが異なるresult.isError: trueで期間エラー:listReservationsのfrom/toがYYYY-MM-DDの実在する日付か、93 日以内か確認するresult.isError: trueで形式エラー: メールアドレス、電話番号、生年月日などの値を確認するresult.isError: trueで都道府県エラー:prefCodeが有効か、zipCode/addressと一緒に指定しているか確認する- HTTP
429: 1 分あたりのリクエスト上限を超えているため、間隔を空けて再試行する
実装前の接続確認では、最初に tools/list、次にテスト用会員への getMemberProfile、最後にテスト用会員だけを対象とした updateMemberProfile の順で確認してください。実在のお客様を接続試験に使用しないでください。
ツール一覧
v2で呼び出せるツールは、次の41です。各ツールは接続に付与した read、write、member_profile_write、member_operations_write のいずれかに応じて表示されます。admin_member_read はツールを増やすものではなく、callAdminReadOperation などで会員の個人情報を含む操作を使えるようにする許可です。
OpenAI審査中のv1は、次の14ツールだけを公開します。
listUserGroups / getAudienceOverview / getBillingContext / listSegmentDrafts / getSegmentDraft / getSegmentReports / createSegmentDraft / createSegmentSeriesDraft / createUserGroup / createConditionalUserGroup / createAutomaticReply / createCoupon / createPlanDraft / createRichMenuDraft
| ツール名 | 種別 | できること |
|---|---|---|
getMemberProfile | 参照 | 指定した会員の氏名・メールアドレス・電話番号などのプロフィールを取得します。LINE ユーザー ID で指定した利用者が未登録なら、LINE でプロフィールを確かめて会員として登録してから返します(詳しくは 対象会員を指定する) |
updateMemberProfile | 会員情報更新 | 指定した会員のプロフィールを部分更新します。専用scope member_profile_write が必要で、未指定項目は変更しません |
listReservations | 参照 | 予約日の期間(93日以内)・会員・予約状態で絞り込んだ予約の一覧を取得します(詳しくは 予約・契約・決済履歴を取得する) |
listMemberSubscriptions | 参照 | 指定した会員の契約(プラン・状態・請求期間・解約予定日・請求の一時停止・未払い)を取得します |
listMemberPayments | 参照 | 指定した会員のカード決済・請求・カード登録の履歴(成功・失敗・返金・金額・日時)を取得します |
cancelReservation | 予約・契約の操作 | 予約1件をキャンセルします。専用scope member_operations_write が必要です(詳しくは 予約をキャンセルする・契約を休会/再開/解約する) |
pauseSubscriptionBilling | 予約・契約の操作 | 契約の請求を再開日まで一時停止(休会)します |
resumeSubscriptionBilling | 予約・契約の操作 | 契約の請求の一時停止を取り消して元の請求日に戻します |
cancelSubscriptionAtPeriodEnd | 予約・契約の操作 | 契約を現在の請求期間の終了日で解約します |
previewSubscriptionCancellation | 予約・契約の操作 | 契約を指定日で解約したときの最終請求額を確認します(解約はしません) |
confirmSubscriptionCancellation | 予約・契約の操作 | 確認した日付指定の解約を確定します |
listUserGroups | 参照 | 配信対象のユーザーグループ(セグメント)の一覧を取得します |
getAudienceOverview | 参照 | LINE友だち数・ブロック数・契約の継続/解約・直近の予約や来店など、顧客基盤の概況を取得します |
getBillingContext | 参照 | 販売中プランの一覧・トライアル設定・支払い方法など、課金まわりの情報を取得します |
listSegmentDrafts | 参照 | 下書き状態の配信の一覧を取得します |
getSegmentDraft | 参照 | 指定した配信の下書きの詳細(本文・配信予定日時・対象グループ)を取得します |
getSegmentReports | 参照 | 送信済みの配信レポート(送信対象数・開封数や率・タップ数や率など)を取得します |
getFriendReport | 参照 | LINE友だち数・ブロック数や率・当月の友だち追加/ブロック/純増減と、新規友だち数の月次トレンドを取得します |
getPlanRetentionReport | 参照 | 販売プランの継続レポート(解約率・平均継続月数・LTV・ARPU・MRR・プラン別内訳・コホート残存率)を取得します |
getPlanBreakevenDiagnosis | 参照 | 先月実績にもとづき、どのサブスクライン契約プランが最安になるかの分岐点診断を取得します |
getReservationContext | 参照 | 現在設定されている予約メニューと対象店舗を取得します。メニュー名や店舗名で絞り込めます |
getLiffContext | 参照 | お客様画面(LIFF)のベースURLを取得します。会員証・プラン・クーポン・予約などへのリンクを組み立てるときに使います |
listClientLanguages | 参照 | 設定されている表示言語の一覧(言語コード・既定言語)を取得します |
searchSubsclineDocs | 参照 | サブスクライン公式の操作マニュアルと仕様ナレッジを検索し、該当ページの要点とURLを返します |
listAutomaticReplies | 参照 | キーワード自動応答・友だち追加あいさつ等の一覧(対象グループ・優先順位を含む)を取得します |
listCoupons | 参照 | 既存クーポンの一覧(コード・割引内容・有効期間・状態)を取得します |
listLabels | 参照 | 会員の分類に使うラベル(タグ)の一覧を取得します |
listRichMenuDrafts | 参照 | リッチメニュー下書き(無効状態)の一覧を取得します。公開中のメニューは含みません |
getPublicSite | 参照 | ホームページ(公開ページ)の現在の設定(公開状態・カスタムURL・店舗紹介・自由セクション・デザイン・友だち追加CTAなど)を取得します |
reviewSegmentDraft | 参照 | 配信下書きの配信前チェック(本文リンクの疎通・配信予定日時と本文中の日付の整合・配信対象の規模)を参照のみで行います |
searchAdminOperations | 参照 | 管理画面の操作(プラン・ラベル・予約設定・AIホームページの記事・友だち数や配信の集計など)を領域やキーワードで探し、必要なスタッフ権限と実行できるかを返します(v2のみ) |
describeAdminOperation | 参照 | 管理画面の操作1件について、指定できる項目と必要なスタッフ権限を返します(v2のみ) |
callAdminReadOperation | 参照 | 管理画面の参照系の操作を、接続したスタッフと同じ権限で実行して結果を取得します。データは変更しません(v2のみ) |
createSegmentDraft | 書き込み | 配信の 下書き を作成します。即時配信はせず、実際の配信は管理画面での確認・有効化が必要です |
createSegmentSeriesDraft | 書き込み | 配信日時をずらした複数本の ステップ配信の下書き をまとめて作成します。各配信の有効化は管理画面で行います |
createUserGroup | 書き込み | 条件を設定しない全員対象のユーザーグループ(配信セグメント)を作成します |
createConditionalUserGroup | 書き込み | ラベル・経過日数・性別・年齢などの絞り込み条件付きのユーザーグループ(配信セグメント)を作成します |
createAutomaticReply | 書き込み | キーワード自動応答を作成します。即時には有効化されず無効(停止)状態で作成し、有効化は管理画面で行います |
createCoupon | 書き込み | クーポンを作成します。即時には有効化されず停止状態で作成し、配布開始は管理画面で行います |
createPlanDraft | 書き込み | サブスクリプションプランの編集可能な 下書き を保存します。Stripeには登録されず、実際のプランとStripeの商品・価格は管理画面で下書きを確定したときに作成します |
createRichMenuDraft | 書き込み | リッチメニューの下書きを作成します。即時には有効化されず無効状態で作成し、LINEへの公開・有効化は管理画面で行います |
updateMemberProfile だけは専用の member_profile_write scopeで既存の会員プロフィールを更新します。更新できる項目は氏名・メールアドレス・電話番号・生年月日・住所などに限定され、未指定項目は保持されます。汎用の write scopeだけでは実行もツール一覧への表示もされません。予約のキャンセルと契約の休会・再開・解約の6ツールは専用の member_operations_write scopeで、管理画面と同じ処理(お客様への通知・請求日や解約日の変更)を行います。それ以外の書き込み系ツールは 下書き・無効・停止・非公開のいずれかの安全な状態で新規作成するだけ です。お客様への配信・公開は行いません。
searchAdminOperations / describeAdminOperation / callAdminReadOperation で使える管理画面の操作は、サブスクラインがあらかじめ選んだ参照系の操作だけです。プラン・予約設定・AIホームページの記事などの設定と、友だち数・契約数・配信の開封率などの集計を参照できます。接続したスタッフに管理画面で権限が無い操作は実行できません。お客様の個人情報を含む操作は、下記の会員・契約・注文の参照だけを、専用の許可を付けた接続で使えます。アンケート回答・問い合わせ・チャットなど、それ以外の個人情報を含む操作と、CSVなどのエクスポートは現在使えません。
会員の一覧・件数・詳細、契約の一覧・詳細、注文の一覧は、お客様の個人情報を含むため、接続に admin_member_read を付けた場合だけ使えます。あわせて、接続したスタッフに管理画面で該当する画面(会員・契約・モバイルオーダーの注文)を開く権限が必要です。一覧は1回に最大100件までで、件数を指定しなければ50件ずつ取得します。admin_member_read が無い接続では、これらの操作は検索結果に「実行できない」理由つきで表示され、実行はできません。
店舗・商品・メニュー・ユーザーグループ・自動応答・予約の一覧と詳細など、応答に店舗やスタッフの連絡先・会議URLなどが含まれる画面の操作も、admin_member_read の有無にかかわらず現在は使えません。
関連ページ
- Claude / ChatGPT / Gemini と連携する(MCPコネクター): AI クライアントからつなぐ手順(非エンジニア向け)
- 開発者向けドキュメント: 開発者向けドキュメントのトップ
- 会員連携 API: 外部の会員システムからラベルと会員ランクを送る API