Final POS Flows (direct)

Final MCP サーバー：AI でカスタム POS アプリを構築

Claude、ChatGPT、Gemini、Cursor、Codex、または任意の MCP クライアントをFinalに接続します。
Flowでカスタム POS アプリ（チェックアウトフロー、セルフチェックアウトキオスク、決済端末）を構築し、
ひとつのサーバーからHubでその裏側の店舗運営を行えます。

https://ai.finalpos.com/mcp

接続 · できること · ツールのリファレンス · FAQ · finalpos.com

---

Final MCP サーバーは、カスタム POS のためのコマースプラットフォームである Finalの公式 Model Context Protocol サーバーです。 ひとつのリモートエンドポイント https://ai.finalpos.com/mcp から、AI エージェントは 加盟店が許可したすべての Final 製品にアクセスできます。

• Flowはカスタム POS アプリビルダーです。チェックアウトの内容を説明すると、エージェントは審査済みの画面ブループリントを使い、バージョンが固定された Final の POS API に基づいてアプリを構築します。その後、検証を行い、ライブプレビューリンクを返して、決済端末、タブレット、キオスクにデプロイします。カウンター POS、セルフチェックアウト、レストランの注文、キッチンディスプレイ、対面決済アプリに対応します。
• Hubは、これらのアプリを支えるバックオフィスです。商品とカタログ、在庫と発注書、注文、顧客、売上レポート、チームとロール、店舗、税金、予約を管理します。

Final アカウント（OAuth 2.1）でサインインし、会社とエージェントに許可する操作を選びます。インストールやローカルでの実行は不要です。

エンドポイント	https://ai.finalpos.com/mcp
トランスポート	Streamable HTTP
認証	PKCE を使用した OAuth 2.1（Final でサインイン）、または Authorization: Bearer による fai_ 接続キー
レジストリ名	com.finalpos/final
動作するユーザー	接続したユーザーとして、許可されたパックの範囲内で、1 社に対して動作します
費用	接続は無料です。エージェントの操作は、Final で自分が行う場合と同様に、Final のプランに従います

接続

ほとんどのクライアントで必要なのは URL だけです。Final のサインインページが開くので、会社とパックを選択すると接続されます。

Claude（claude.ai、Claude Desktop）

Settings → Connectors → Add custom connectorを選び、URL に https://ai.finalpos.com/mcp を指定します。

ChatGPT

Settings → Apps & Connectors → Advanced settings → Developer modeを選び、URL https://ai.finalpos.com/mcp を指定してCreateを選択します。

Claude Code

claude mcp add --transport http final https://ai.finalpos.com/mcp

Claude Code で /mcp を実行し、Authenticateを選択します。または、Final のプレイブックスキルとサーバーを追加するプラグインをインストールします。 Claude Code 内で次を実行します。

/plugin marketplace add Final-Commerce/final-pos-mcp
/plugin install final@final

Gemini CLI

gemini extensions install https://github.com/Final-Commerce/final-pos-mcp

この拡張機能は、サーバー、Final のプレイブック、次のコマンドを追加します。 /final-pos:stock、/final-pos:sales、/final-pos:new、/final-pos:preview、 /final-pos:validate、/final-pos:deploy。Gemini CLI 内で /mcp auth final を実行して、一度サインインしてください。サーバーのみを追加する場合は、次を実行します。

gemini mcp add --transport http final https://ai.finalpos.com/mcp

Cursor

または、~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "final": { "url": "https://ai.finalpos.com/mcp" }
  }
}

VS Code（GitHub Copilot）

VS Code にインストール、または次のようにします。

code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'

Codex、スクリプト、OAuth を利用しないクライアント

ai.finalpos.com/connections で接続キーを作成します。 キーは一度だけ表示され、ページには各クライアント向けの正確な設定スニペットが表示されます。Codex の場合は、これを ~/.codex/config.toml に追加します。

[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }

その他のクライアントの場合は、Authorization: Bearer fai_YOUR_KEY を指定して POST https://ai.finalpos.com/mcp を送信します。

sk_（Flow）または fpm_（Hub）で始まるキーは、それぞれの製品専用サーバーで使用するもので、 ここでは受け付けられません。代わりに fai_ キーを作成するか、OAuth を使用してください。

動作確認

エージェントに次のように尋ねてください。「Final を使って、どの会社に接続しているか、どのパックを利用できるか教えてください。」 エージェントは get_connection と list_packs を呼び出します。

エージェントでできること

ツールはパックごとにグループ化されています。接続時にエージェントが利用できるパックを選択します。これらは OAuth スコープにもなります。モデルのコンテキストを小さく保つため、一度に表示されるパックは少数のみです。コアツールを使えば、残りにもアクセスできます。find_tools は許可されたすべてのパックを検索し、call_tool は名前を指定して許可された任意のツールを呼び出します。

パック	製品	内容	デフォルトで表示
catalog	Hub	商品、バリエーション、カテゴリ、オプション、修飾子、商品写真、メディアライブラリ	✓
inventory	Hub	在庫レベルと履歴、移動、サプライヤー、発注書、再発注ルール、在庫 CSV のインポート／エクスポート
orders	Hub	注文、返金、EC 注文の同期（読み取り専用：決済はレジで行います）
customers	Hub	顧客情報、メモ、注文履歴、顧客情報のインポート
reports	Hub	財務概要、売上と支払いの内訳、従業員別売上、セッション、取引、記録のエクスポート
team	Hub	チームメンバー、ロール、権限
store	Hub	店舗、ステーション、税、Hub 拡張機能
bookings	Hub	予約可能なサービス：ルール、リソース、空き状況、保留、確認
build	Flow	Final POS アプリのビルドとデプロイ：API の根拠情報、ブループリント、フローファイル、プレビュー用サンドボックス、検証、デプロイ	✓
build_data	Flow	カスタムテーブル（アプリのデータベース）、シークレット保管庫、Flow 拡張機能

ツール名には製品名が含まれます。例：hub_get_products、hub_find_low_stock、 flow_create_flow、flow_deploy_flow。TOOLS.md にはすべての ツールが記載されており、パック、データを変更するかどうか、引数を確認できます。

コアツール（常に表示）：get_connection、list_packs、find_tools、 call_tool、enable_packs、disable_packs、switch_company。

依頼できること

カスタム POS アプリの構築（Flow）

• 「商品グリッド、オプション、カート、カード決済を備えたコーヒーショップのキオスクを作成して、プレビューリンクを表示してください。」
• 「カウンターアプリにチップ入力画面を追加して、検証してください。」
• 「バーコードスキャンとレシート画面を備えた、小規模な食料品店向けのセルフチェックアウトのワークフローを作成してください。」
• 「セルフチェックアウトのワークフローの最新バージョンを公開してください。」

アプリの構築では通常、flow_get_scaffold → flow_create_flow → flow_lookup_command_frame（根拠の確認）→ flow_get_blueprint → flow_write_flow_files → flow_validate_flow → flow_start_preview の順に 実行され、ライブプレビュー URL が返されます。エージェントが構築したものはすべて Final builder にも表示され、ファイルを書き込むたびに復元可能なチェックポイントが 作成されます。

店舗の運営（Hub）

• 「Main Street 店舗で、発注点を下回っている商品はどれですか？いつもの仕入先への発注書の下書きを作成してください。」
• 「先週のカテゴリ別売上を、その前の週と比較してください。」
• 「添付のスプレッドシートにある 40 商品を、写真付きで追加してください。」
• 「今月の上位 10 人の顧客は誰で、何を購入しましたか？」
• 「45 分のマッサージを、セラピスト 2 人が対応できる予約可能なサービスとして設定してください。」

安全性と権限

• ユーザーの役割は引き続き適用されます。 Hub の各呼び出しは接続したユーザーとして実行され、Hub は呼び出しごとにそのユーザーの現在の役割を確認します。オーナー限定の操作は引き続きオーナーのみが実行できます。
• 権限はパックによって決まります。 エージェントは、許可したパックに含まれるツールのみを呼び出せます。パックの変更や切断は、いつでも ai.finalpos.com/connections で行えます。切断すると、すべてのトークンが一度に失効します。
• 書き込み操作にはラベルが付いています。 読み取りツールには readOnlyHint が、デプロイと削除には destructiveHint が付いているため、クライアントは操作前に確認を求めることができます。サーバーは、デプロイ、削除、一括変更を行う前にユーザーへ確認するようエージェントに指示します。
• 金銭の取り扱いはレジで行います。 MCP 経由での決済、返金、注文の取消はできません。
• シークレットがモデルに渡ることはありません。 flow_request_secret は、ビルダーで API キーを入力するよう求めます。
• すべての操作が記録されます。 Connections ページには、接続済みの各クライアントと、そのクライアントによるすべての呼び出しがリアルタイムで表示されます。
• Flow の制限： Flow では、プレビューの起動は 30 回、ビルドとデプロイは 12 回、ファイル書き込みは 1 時間あたり 300 回までです。

プライバシーとサポート

• Final が保持する情報。 接続情報（接続したユーザー、会社、パック）、Hub と Flow への接続に使用するトークン（暗号化済み）、各ツール呼び出しのログ（ツール、結果、所要時間、引数と結果の一部を伏せたプレビュー）。ログは Connections ページで確認できます。
• Final が確認できない情報。 会話の内容です。MCP クライアントが送信するのはツール呼び出しであり、その前後のチャットではありません。
• **切断すると、**保存されたトークンが削除され、その接続に発行されたすべてのトークンが失効します。
• プライバシーポリシー · 利用規約
• サポート： [email protected]。このガイドやプラグインに問題がある場合は、 issue を作成してください。

Flow の直接エンドポイント

ゲートウェイ導入前に設定した環境では、Flow の sk_ キーを使う https://flow.finalpos.com/api/mcp （レジストリ名 com.finalpos.build/final-flows）が引き続き使われている場合があります。このエンドポイントは引き続き動作しますが、新しい環境では Flow を含む https://ai.finalpos.com/mcp を使用してください。

FAQ

Final MCP サーバーとは何ですか？

Final POS の公式 MCP サーバーです。1 つのリモート URL https://ai.finalpos.com/mcp から、AI アシスタントが加盟店の Final バックオフィス（Hub）を読み取り、管理したり、POS アプリ（Flow）を構築したりできます。

ChatGPT や Claude で Final POS の在庫を管理できますか？

はい。接続時に inventory パックを許可してください。エージェントは在庫数の確認、在庫不足商品の検索、発注の提案、発注書の作成、入荷商品の記録を行えます。

AI エージェントは Final で POS アプリを構築できますか？

はい。build パックを使うと、エージェントはフローを作成し、バージョンが固定された Final の API と検証済みの画面ブループリントに基づいてアプリを作成し、検証して、ライブプレビュー URL を返します。Final のビルダーから起動できます。

API キーは必要ですか？

OAuth に対応したクライアント（Claude、ChatGPT、Claude Code、Cursor、Gemini CLI、VS Code）をお使いの場合は不要です。Final にサインインするだけです。Codex とスクリプトでは、ai.finalpos.com/connections から取得した fai_ キーを使用します。

どの会社に対して操作しますか？

接続時に選択した会社です。アカウントに複数の会社がある場合、エージェントは switch_company を呼び出せます。

エージェントは決済や返金を実行できますか？

いいえ。決済、返金、取消はレジで行います。MCP 経由の注文は読み取り専用です。

エージェントに表示されるツールが少ないのはなぜですか？

クライアントは一覧にあるすべてのツールをモデルのコンテキストに入れるため、一覧が長いと品質が低下します。エージェントは find_tools で残りのツールを検索し、call_tool で呼び出すか、enable_packs でパック全体を一覧表示します。

費用はかかりますか？

接続は無料です。エージェントが実行した作業には、Final のご利用プランに基づき、お客様が Final で同じ作業を行った場合と同じ料金が請求されます。

Final POS API のドキュメントはどこにありますか？

finalpos.com/docs にあります。アプリを構築するエージェントには、別途ドキュメントは必要ありません。build パックは、バージョンが固定された Final の API（flow_lookup_pos_api、flow_lookup_command_frame）に基づいてすべての呼び出しを行います。

このリポジトリについて

このリポジトリには、公開セットアップガイド、MCP レジストリのエントリー（server.json、legacy/）、Gemini CLI 拡張機能（gemini-extension.json、GEMINI.md、commands/）、Claude Code と Cursor のプラグインマーケットプレイス（.claude-plugin/、.cursor-plugin/、および両方で共有する plugins/final/）、そして機械可読な対応ファイル catalog.json を備えた生成済みのツールリファレンスが含まれています。サーバーカード（https://ai.finalpos.com/.well-known/mcp/server-card.json）もこれらを読み込みます。GEMINI.md と Claude スキルは同じプレイブックであり、CI で一致していることを確認しています。サーバー自体は Final がホストしているため、このリポジトリのコードがお客様のマシン上で実行されることはありません。

ライセンス

Apache-2.0 © Final Commerce