ドキュメント

MCP接続とagentの使い方

公開MCPへのOAuth接続、店舗・scopeの確認、作業別のtool入口を説明します。

ドキュメント

接続する

プラグイン導入または手動導入を開きます。この案内画面にはログインが必要です。表示された接続先をMCPクライアントに追加し、OAuthでログインして対象組織と権限に同意します。リポジトリのcloneや開発サーバーは不要です。

接続画面の名前はtablecast、URLは利用中の画面のoriginに/mcpを付けたものです。本番と検証環境は別のデータを持つため、画面とMCPのoriginを照合してください。公開pluginは本番へ接続します。同じ接続先を手動で重複登録する必要はありません。

権限と対象店舗を確認する

読取りにはtablecast:read、下書きの変更にはtablecast:writeが必要です。権限が不足するときは必要なscopeで再認可します。複数店舗では接続URLのstoreIdで対象を選び、省略時は許可された組織内の最初の店舗が対象です。IDを推測せず、get_configurationの店舗名・IDで確かめてください。

OAuth接続一覧では接続先・権限・期限を確認し、不要な接続を解除できます。ドキュメントが読めることは、業務操作の認可を意味しません。

同梱skillを選ぶ

skill依頼すること
tablecast資料からの初期設定、メニュー・店舗資料・特典の設定、ゲーム制作
tablecast-advisor現在設定と業務メモから具体的な接客・説明を提案
tablecast-analytics期間と母数を揃えた統計比較と改善案
tablecast-theme店舗ロゴ・背景・チラシ・会員カードなどの制作
tablecast-help目的に合う公開ドキュメントの説明

Pluginは5つのskillとヘルプの参照資料を同梱します。手動導入画面では4つの操作skillを個別に取得でき、ヘルプはこのドキュメントを使います。skillの追加だけではMCP接続や店舗の権限は付与されません。

作業に合う入口を選ぶ

目的最初に使うtool・次に読む章
現在のメニュー・接客を確認するget_configuration → 設定と公開
メニューを変更するcreate_draft・update_draft → 設定と公開
店舗全体の初期設定を確認するget_store_onboarding → はじめに
店舗資料を編集するlist_store_skills・read_store_skill_file → 店舗資料とSkill
特典の設定や対象者を確認するget_point_policy・list_coupon_rules・preview_coupon_audience → 会員と特典
統計を調べるget_statistics → 統計と改善
店舗デザインを制作するget_configuration・get_theme_spec → 店舗デザインと画像
卓上ゲームを制作するget_game_spec → 卓上ゲーム

agentが作業するとき

まず実際のtoolを探索し、接続先の最新schemaを読みます。未探索の段階で未接続と決めつけません。説明や提案の依頼は読取りに留め、設定してという依頼は下書きへの反映まで進めます。メニュー等の公開は人の明示承認で行います。ポイント・クーポンは下書きを使わず保存時に適用されるため、対象と採用条件を確認した依頼の範囲で操作します。価格や安全情報を資料から読めない場合は創作しません。

接続できないときは困ったときへ進めます。目次へ戻る。