Bankstatemently

bankstatemently/plugins

Bankstatemently 用のマーケットプレイスプラグインです。銀行取引明細を変換します。

Claude Code マーケットプレイスからインストールする

/plugin marketplace add bankstatemently/plugins
/plugin install bankstatemently@bankstatemently

インストール後、プラグインを有効にしてください。最初のツール呼び出し時にブラウザーが開いてサインインを求められます。プラグインの設定は不要です。

ヘッドレス環境（CI、スクリプト）では、プラグインを使わず、API キーを使ってサーバーを直接追加してください。詳しくは以下をご覧ください。キーは bankstatemently.com/developer で取得できます。

プラグイン

• bankstatemently — 銀行取引明細を変換する MCP サーバーです。 PDF の変換、明細の一覧表示、入金の確認、ベンチマーク評価の実行ができます。

Claude Code への直接インストール（プラグインなし）

ホストされた MCP サーバーを直接追加し、ブラウザーからサインインしてください。

claude mcp add --transport http bankstatemently https://api.bankstatemently.com/mcp

ヘッドレス環境では、代わりに X-API-Key ヘッダーで API キーを渡してください（サーバーは Authorization: Bearer を拒否します）。

claude mcp add --transport http bankstatemently https://api.bankstatemently.com/mcp \
  --header "X-API-Key: <your-bsk_live_key>"

Codex

Codex はネイティブの OAuth をサポートしています。このコマンドを実行すると、サーバーの検出メタデータが検出され、ブラウザーが開いてサインインできます。キーが保存されることはありません。

codex mcp add bankstatemently --url https://api.bankstatemently.com/mcp

ブラウザーでサインインできないヘッドレス環境や CI 環境では、代わりに mcp-remote ブリッジ経由で API キーを使用してください。Codex を起動するシェルで、起動前にキーをエクスポートします。

export BANKSTATEMENTLY_API_KEY=bsk_live_...

codex mcp add bankstatemently -- npx -y mcp-remote@latest https://api.bankstatemently.com/mcp --header "X-API-Key: ${BANKSTATEMENTLY_API_KEY}"

Codex では、プラグインが宣言した MCP サーバーをまだセッションに表示できません。そのため、上記のプラグインインストールと同梱のスキルは現在 Codex では利用できません。代わりに上記のコマンドを使用してください。

認証情報マネージャーとサンドボックス化されたクライアント： MCP サーバーのコマンド自体から Keychain、1Password、その他の認証情報マネージャーのシークレットを取得しないでください。ツールの検出時、Codex はそのコマンドをサンドボックス内で実行するため、認証情報マネージャーへの問い合わせはエラーが表面化しないまま失敗し、サーバーのツールが表示されなくなります。代わりに、Codex を起動するシェルでキーをエクスポートしてください。また、mcp-remote は解決済みのヘッダー値を stderr に記録するため、ラッパーで解決したキーがクライアントのログに残る可能性があることにも注意してください。

stdio 経由で実行する

stdio のみを使用するクライアント（Claude Desktop の設定ファイル、Cursor、ヘッドレス環境）や、サーバーをローカルで起動するディレクトリスキャナーでは、公開リポジトリをクローンし、自己完結型の mcp-stdio サーバーを直接実行してください。Docker もブリッジプロセスも不要です。

git clone https://github.com/bankstatemently/plugins.git
cd plugins/mcp-stdio
npm install --omit=dev
BANKSTATEMENTLY_API_KEY=bsk_live_... node dist/stdio.js

BANKSTATEMENTLY_API_KEY は起動時には省略可能です。initialize と tools/list はネットワーク呼び出しもキーも不要で応答するため、認証情報がなくてもディレクトリのプローブでツール一覧全体を確認できます。キーなしの tools/call は、ホストされたサーバーと同じ認証必須の結果を返します。プロセスを起動するシェルまたはランタイム環境でキーをエクスポートしてください。MCP コマンド内でキーを解決してはいけません（サンドボックス化されたクライアントのコマンド内で認証情報マネージャーを参照すると、エラーが表面化しないまま失敗します。上記の Codex のセクションと同じ注意点です）。