Final POS – Custom POS Builder

公式

AIでカスタムPOSを構築。チェックアウトフロー、セルフチェックアウトキオスク、決済端末アプリを設計し、ライブプレビューして、カード決済対応の実機にデプロイ。また、商品、在庫、注文、顧客、売上レポートなど店舗運営も実行。リモート対応、OAuth対応。

Final POS – Custom POS Builder MCPで何ができますか?

  • カスタムPOSアプリを説明から作成 — アシスタントにチェックアウトフロー(コーヒーショップのキオスクなど)の作成を依頼し、ライブプレビューリンクを取得します。
  • POSフローの検証とデプロイ — アプリのフローファイルの検証をリクエストし、最新バージョンを決済端末やキオスクに配信します。
  • 在庫の監視と管理 — 在庫レベルを確認し、低在庫アイテムを見つけ、通常の仕入先への発注書を作成します。
  • 売上パフォーマンスの分析 — カテゴリ別の売上を週間で比較したり、主要顧客とその購入内容を特定します。
  • カタログと顧客の管理 — 写真付きのスプレッドシートから商品を追加したり、担当スタッフを割り当てた予約可能なサービスを設定します。

ホスト型 MCP サーバー

npx add-mcp 'https://ai.finalpos.com/mcp'

Claude Code、Codex、Cursor などにインストールできます

ドキュメント

Final

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

Claude、ChatGPT、Gemini、Cursor、Codex、または任意のMCPクライアントをFinalに接続:
Flow(チェックアウトフロー、セルフチェックアウトキオスク、決済端末)でカスタムPOSアプリを構築し、
その背後にある店舗をHubから、1つのサーバーを通じて運営できます。

https://ai.finalpos.com/mcp

MCP Registry: com.finalpos/final Add to Cursor Install in VS Code License: Apache-2.0

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


Final MCPサーバーは、カスタムPOSのためのコマースプラットフォームである Finalの公式Model Context Protocolサーバーです。 1つのリモートエンドポイント、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)

設定 → コネクタ → カスタムコネクタを追加、URL https://ai.finalpos.com/mcp。

ChatGPT

設定 → アプリとコネクタ → 詳細設定 → 開発者モード、次にURL https://ai.finalpos.com/mcpで作成。

Claude Code

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

Claude Codeで/mcpを実行し、認証を選択します。または、プラグインをインストールします。 プラグインは、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

Add to 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は名前で許可された任意のツールを呼び出します。

パック製品対象デフォルトでリスト
catalogHub商品、バリエーション、カテゴリ、オプション、モディファイア、商品写真、メディアライブラリ✓
inventoryHub在庫レベルと履歴、転送、仕入先、発注書、再発注ルール、在庫CSVインポート/エクスポート
ordersHub注文、返金、eコマース注文同期(読み取り専用:会計はレジで行われます)
customersHub顧客記録、メモ、注文履歴、顧客インポート
reportsHub財務サマリー、売上と支払いの内訳、従業員売上、セッション、取引、レコードエクスポート
teamHubチームメンバー、ロール、権限
storeHub店舗、ステーション、税金、Hub拡張機能
bookingsHub予約可能なサービス:ルール、リソース、空き状況、保留、確認
buildFlowFinal POSアプリの構築とデプロイ:APIグラウンディング、ブループリント、フローファイル、プレビューサンドボックス、検証、デプロイ✓
build_dataFlowカスタムテーブル(アプリデータベース)、シークレットボールト、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ビルダーにも表示され、 すべてのファイル書き込みは復元可能なチェックポイントになります。

店舗の運営(Hub)

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

安全性と権限

  • あなたのロールは引き続き適用されます。 すべてのHub呼び出しは接続した本人として実行され、Hubは各呼び出しでそのライブロールをチェックします。オーナー専用のアクションはオーナー専用のままです。
  • パックが権限です。 エージェントは、許可したパック内のツールのみを呼び出すことができます。パックの変更や切断は、ai.finalpos.com/connectionsでいつでも行えます。切断すると、すべてのトークンが一度に失効します。
  • 書き込みはラベル付けされています。 読み取りツールにはreadOnlyHintが付いており、デプロイと削除にはdestructiveHintが付いているため、クライアントはアクションの前に確認できます。サーバーは、エージェントにデプロイ、削除、一括変更をあなたに確認するよう指示します。
  • お金はレジに残ります。 支払いの受け取り、返金、注文の無効化はMCPでは利用できません。
  • シークレットはモデルを通過しません。 flow_request_secretは、ビルダーでAPIキーを入力するよう求めます。
  • すべてがログに記録されます。 接続ページには、接続された各クライアントとそのすべての呼び出しがライブで表示されます。
  • Flowの制限: Flowでは、1時間あたり30回のプレビューブート、12回のビルドとデプロイ、300回のファイル書き込みが許可されています。

プライバシーとサポート

  • Finalが保持するもの。 接続(誰が作成したか、会社、パック)、HubとFlowに到達するために使用するトークン(暗号化)、および各ツール呼び出しのログ:ツール、結果、所要時間、引数と結果の編集済みプレビュー。このログは接続ページで確認できます。
  • Finalが閲覧しないもの。 あなたの会話。MCPクライアントはツール呼び出しを送信し、その周囲のチャットは送信しません。
  • 切断すると、保存されたトークンが削除され、その接続に発行されたすべてのトークンが失効します。
  • プライバシーポリシー · 利用規約
  • サポート: support@finalpos.com。このガイドまたはプラグインの問題については、 issueを開いてください。

Flowの直接エンドポイント

ゲートウェイより前に作成されたセットアップは、Flowのsk_キー(レジストリ名com.finalpos.build/final-flows)を持つhttps://flow.finalpos.com/api/mcpを引き続き使用できます。 これは機能し続けますが、新しいセットアップでは、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