btcpay-server-automation

btcpay-server-automation skill の概要

btcpay-server-automation の用途

btcpay-server-automation は、Composio の Rube MCP toolkit を通じて BTCPay Server の運用を自動化するための Claude skill です。現在の BTCPay Server tool schema をエージェントに検出させ、アクティブな接続を確認したうえで、汎用プロンプトよりも推測を減らして運用タスクを実行したいユーザー向けに設計されています。

重要なのは、これは固定的な BTCPay Server 用スクリプト集ではないという点です。この skill のワークフローは、特に RUBE_SEARCH_TOOLS を使った Rube MCP の tool discovery に依存します。そのため、エージェントは利用可能な最新の tool 名、入力項目、実行パターンを確認してから作業できます。

向いているユーザーとワークフロー

この btcpay-server-automation skill は、すでに Claude と MCP を使っており、BTCPay Server まわりのワークフローを AI 支援で自動化したい場合に適しています。代表的な用途には、ストア管理、請求書関連の操作、決済ワークフローの確認、Composio の btcpay_server toolkit から公開されているその他の BTCPay Server タスクがあります。

特に、達成したい業務上の結果は分かっているものの、毎回 Composio の最新 tool schema を手作業で確認したくない運用担当者にとって便利です。

主な差別化ポイント

最大の特徴は、「まず tools を検索する」というパターンです。固定の API パラメータを前提にするのではなく、この skill は実行前に RUBE_SEARCH_TOOLS を呼び出すようエージェントに指示します。MCP tool schema や対応操作は変わる可能性があり、決済インフラ関連のタスクでは、エージェントが存在しないフィールドを作り出したり古い前提で操作したりするとリスクが高いため、この点は重要です。

導入前に確認すべきこと

インストール前に、利用しているクライアントが MCP に対応していること、また Composio/Rube 経由で BTCPay Server を接続する運用に問題がないことを確認してください。リポジトリの該当パスには SKILL.md のみがあり、補助スクリプトや詳細な参照資料は含まれていません。そのため、この skill の価値は大規模な実装パッケージではなく、ワークフロー指示にあります。

btcpay-server-automation skill の使い方

btcpay-server-automation のインストール前提

Composio skills repository から skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill btcpay-server-automation

次に、AI クライアントに MCP endpoint を追加して Rube MCP を設定します。

https://rube.app/mcp

この skill には Rube MCP が必要で、RUBE_SEARCH_TOOLS が利用できることを前提としています。また、toolkit 名 btcpay_server を使って RUBE_MANAGE_CONNECTIONS から BTCPay Server へのアクティブな接続が必要です。

接続確認と tool discovery の進め方

btcpay-server-automation の実用的な利用フローは次のとおりです。

1. エージェントに RUBE_SEARCH_TOOLS が利用可能か確認させる。
2. toolkit btcpay_server に対して RUBE_MANAGE_CONNECTIONS を呼び出すよう依頼する。
3. 接続がアクティブでない場合は、返された認証リンクで認証を完了する。
4. 接続ステータスが ACTIVE であることを確認する。
5. 実行したい BTCPay Server タスクに合わせて RUBE_SEARCH_TOOLS を呼び出すよう依頼する。
6. 書き込み操作を許可する前に、検出された tool plan を確認する。

元の skill では、discovery は初期設定時だけでなく、各ワークフローの前に行うべきだと強調されています。

粗い目的を実用的なプロンプトに変える

弱いプロンプト:

“Manage my BTCPay invoices.”

より良いプロンプト:

“Use the btcpay-server-automation skill. First verify the btcpay_server connection is active through Rube MCP. Then call RUBE_SEARCH_TOOLS for the use case: ‘find recent unpaid BTCPay Server invoices for store X and summarize which ones need follow-up.’ Do not perform write actions unless you show me the discovered tool schema and ask for confirmation.”

このように書くと、対象システム、タスク範囲、安全上の境界、必須の discovery 手順をエージェントに明示できるため、出力品質が上がります。

書き込み操作では、さらに明確に指定してください。

“Use btcpay-server-automation for Workflow Automation. Discover the current BTCPay Server tools first. I want to create or update payment workflow data only after you show the exact tool, required fields, and proposed payload. Treat missing store ID, invoice ID, or currency as a blocker.”

最初に読むべきリポジトリファイル

まず composio-skills/btcpay-server-automation/SKILL.md を確認してください。ファイルツリーのプレビュー上、別個の README.md、scripts/、resources/、rules/ フォルダは存在しないため、SKILL.md が信頼すべき一次情報です。

特に次のセクションに注目してください。

• Prerequisites
• Setup
• Tool Discovery
• Core Workflow Pattern

また、skill からリンクされている Composio toolkit documentation も開いてください: https://composio.dev/toolkits/btcpay_server。BTCPay Server で扱える範囲を把握するために役立ちますが、実際の最新 schema については引き続き RUBE_SEARCH_TOOLS に依存してください。

btcpay-server-automation skill FAQ

btcpay-server-automation は初心者向けですか？

MCP ユーザーにとっては扱いやすい skill ですが、AI クライアントに外部ツールを接続した経験がまったくない人向けではありません。接続がアクティブになると、エージェントが BTCPay Server の運用データへアクセスできる可能性があることを理解しておく必要があります。初心者は、作成・更新・削除を許可する前に、読み取り専用の discovery や要約から始めるべきです。

通常のプロンプトより何が優れていますか？

汎用プロンプトでも Claude に “use BTCPay Server” と依頼することはできますが、ライブの tool discovery は強制されません。btcpay-server-automation skill は、まず利用可能な Rube tools を検索し、現在の schemas を確認し、アクティブな btcpay_server 接続を使うようエージェントに指示します。これにより、存在しないパラメータの生成を減らし、変化する tool 定義にも対応しやすいワークフローになります。

この skill を使うべきでないケースは？

オフラインスクリプト、BTCPay Server API を直接扱うコード、または Composio/Rube を完全に避けるワークフローが必要な場合は使うべきではありません。また、組織として決済インフラへの MCP ベース接続を承認できない場合や、単一の SKILL.md ファイルには含まれていない詳細なポリシー制御が必要な場合にも適していません。

BTCPay Server の管理作業を置き換えますか？

いいえ。利用可能な tools を通じたワークフロー自動化を支援するものですが、決済運用、ストア設定、請求書処理、セキュリティ上重要な変更における人間のレビューを置き換えるものではありません。影響の大きい操作では、実行前に、検出された tool、入力項目、実行計画案をエージェントに提示させるようにしてください。

btcpay-server-automation skill を改善する方法

制約を入れて btcpay-server-automation のプロンプトを改善する

最も良い結果を得るには、ストア、オブジェクト種別、操作、期間、安全ルールをプロンプトに含めます。例:

“Use btcpay-server-automation. Discover tools for ‘list invoices from the last 7 days for store X and identify unpaid invoices.’ Use read-only actions only. If a required field is unknown, ask before calling execution tools.”

これにより、あいまいな目的が危険または不完全な操作に変換されるのを防げます。

注意すべきよくある失敗パターン

最大の失敗パターンは、RUBE_SEARCH_TOOLS を省略して tool schema を推測してしまうことです。次に多いのは、btcpay_server 接続が ACTIVE になる前に操作しようとすることです。さらに、store ID、invoice ID、customer reference、date range などの識別情報がないまま、業務指示だけをエージェントに渡すことも失敗につながります。

不足している識別情報は、モデルが推測すべき細部ではなく、処理を止めるべきブロッカーとして扱ってください。

最初の出力後に反復する

最初の tool discovery 結果が出たら、エージェントに次の内容を要約させてください。

• 利用可能な tool slug または slugs
• 必須フィールド
• 利用するとよい任意フィールド
• 想定される副作用
• 提案 payload
• 実行前に必要な確認

これにより、btcpay-server-automation を一度きりの指示ではなく、より安全なワークフロー確認ループとして使えるようになります。

skill をさらに強くするには

このリポジトリは、一般的な BTCPay Server タスクの例、読み取り専用操作と書き込み操作の使い分けガイド、確認プロンプトのサンプル、非アクティブな Rube 接続に関するトラブルシューティングメモがあると、より有用になります。それまでは、ユーザー側で schema discovery、接続確認、運用上の変更前の明示的な承認を必須にするプロンプトを書くことで補うべきです。