mcpField
O
openfin-setup

openfin-setup

github.com/openfinance-techその他466 回インストール8 週間前に更新
リポジトリ

openfin-setup について

openfin-setupは、OpenFinanceバックエンドを使うエージェント向けのセットアップガイドです。APIキーの確認と安全な扱い、ウォレットの検証、認証エラーへの対処方法を説明します。

主な機能

  1. 01APIキーの確認
  2. 02ウォレットアドレスの検証
  3. 03リクエスト認証の説明
  4. 04一般的なエラーの診断

活用シーン

  1. 01エージェントのバックエンドアクセス設定
  2. 02ユーザーのウォレット設定の確認
  3. 03無効なキーや認可エラーへの対応

MCP 対応

ウォレットアドレスを確認するMCPツール `get_wallet_addresses` を説明します。MCPホストに `apiKey` が設定済みの場合、引数は不要です。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openfinance-tech/skills --skill openfin-setup

インストール後、Claude Code で/openfin-setupを入力して読み込まれたか確認します。

詳細

OpenFinance のセットアップ

公開元。 OpenFinance のスキルバンドル（openfin-setup、openfin-troubleshooting、openfin-hyperliquid、openfin-relay、openfin-onramp、openfin-polymarket、openfin-onchain）の一部です。すべて OpenFinance（https://openfinance.tech）がメンテナンスしています。個別ではなく、まとめてインストールしてください。

OpenFinance バックエンドを使うために、エージェントに必要なのは有効な API キーだけです。 アカウントとウォレットのセットアップは openfinance.tech で別途行います。 エージェントが関与する時点で、ユーザーはすでにキーを持っているか、 キーが必要な状態です。

ステップ 1 — API キーを確認する

次の順に確認します。

  1. 環境変数 OPENFINANCE_API_KEY（推奨）。
  2. エージェントがすでに読み込んでいるプロジェクトレベルの設定（.env、シークレット マネージャー、MCP 設定など）。
  3. 現在の会話 — ユーザーが貼り付けている場合があります。

有効なキーは、open_ に続いて不透明なトークンが並ぶ形式です。

ステップ 2 — キーがない場合は尋ねる

上記のいずれにもキーが見つからない場合は、ユーザーに一度だけ尋ねてください。

バックエンドを呼び出すには OpenFinance API キー（open_…）が必要です。すでに お持ちの場合は、ここに貼り付けてください。まだお持ちでない場合は、 openfinance.tech で生成して、こちらに貼り付けてください。

キーを捏造したり、推測したり、キーなしで処理を進めたりしないでください。受け取ったキーをチャットで 再表示しないでください。セッション中は保存し、ヘッダーで使用してください。

ステップ 3 — 検証する

1 回の呼び出しで、キーが機能し、ウォレットがプロビジョニングされていることを確認できます。

GET /agent/wallets
x-api-key: open_…

期待される結果：

{ "ethereum": "0x…", "solana": "…" }
  • ユーザーの openfinance.tech 上でそのチェーンがプロビジョニングされていない場合、どちらのフィールドも null になることがあります。 読み取り専用の操作と同一チェーンの EVM フローは引き続き機能します。Solana ウォレットが必要なのは、 Solana 起点の Relay 実行のみです。
  • 401 Invalid API key → キーが間違っているか、形式が不正です。再度尋ねるか、 ユーザーに openfinance.tech に戻ってもらってください。
  • 412 Server is not authorized for this user → ユーザーは登録済みですが、 openfinance.tech でのセットアップを完了していません。ユーザーにアクセスしてもらってください。

すべての呼び出しに付ける認証ヘッダー

公開 Polymarket 読み取りを除くすべての /agent/* ルートで、次の形式を使います。

x-api-key: open_…

フレームワークで Bearer 形式が優先される場合は、Authorization: Bearer open_… も使用できます。

MCP での同等の方法

MCP ツール get_wallet_addresses を使って、同じウォレット確認を行えます（MCP ホストのサーバーレベルで apiKey が設定されている場合、引数は不要です）。 { ethereum, solana } を返します。

よくあるエラー

症状原因対処方法
401 Invalid API keyキーが送信されていない、形式が不正、または取り消されているopen_ プレフィックスを確認し、openfinance.tech で再発行する
412 Server is not authorized for this userユーザーは登録済みですが、セットアップを完了していないセットアップを完了するため、ユーザーに openfinance.tech にアクセスしてもらう
400 User has no Solana wallet provisionedユーザーの Solana ウォレットが有効になっていないユーザーに openfinance.tech で Solana ウォレットを有効にしてもらう

してはいけないこと

  • 生の API キーを LLM のコンテキストやログに含めないでください。 ヘッダー経由でのみ渡してください。
  • 呼び出しごとにキーを再生成しないでください。 キーは長期間有効です。セッション中はキャッシュしてください。
  • ユーザーのオンボーディングを自分で試みないでください。 アカウントとウォレットの セットアップはエージェント経由ではなく、openfinance.tech で行います。

コメント

Markdown 対応