MCP セットアップ | Bank Statement Conversion - Bank-Statement-Conversion
リモート MCP サーバー

Bank Statement Conversion MCP を設定します。

スコープ指定されたダッシュボード トークンを使用して、Claude、Codex、Cursor、ChatGPT 互換クライアント、およびカスタム エージェントをライブ変換ツールに接続します。

リモートエンドポイントhttps://bank-statement-conversion.com/mcp/bank-statement-conversionトークン環境変数BSC_API_TOKEN

4 つのセットアップ手順。

ホストされたエンドポイントを使用し、エージェント クライアントに 1 つのトークンをローカルに保存し、アクションを確認できるようにします。

1

専用トークンを作成する

ダッシュボードの API Tokens ページを使用して、個人用または運用アプリのトークンとは別に、このエージェントのトークンを作成します。

2

範囲指定されたアビリティを有効にする

MCP ツールに必要なアカウント ステータス、アップロード、ステータス読み取り、およびダウンロードの機能のみを付与します。

3

リモートエンドポイントを追加する

MCP 対応クライアントをホストされた Bank Statement Conversion エンドポイントに向けます。

4

機密性の高いアクションを確認する

財務書類をアップロードしたり、変換されたファイルのダウンロードを準備したりする前に、エージェントに質問してもらいます。

エンドポイント

リモート MCP サーバーを追加します。

クライアントがトランスポートを要求する場合は、Streamable HTTP を使用します。ベアラー トークン環境変数を受け入れるクライアントもあれば、Authorization ヘッダーを使用するクライアントもあります。

Codex構成
[mcp_servers.bank_statement_conversion]
url = "https://bank-statement-conversion.com/mcp/bank-statement-conversion"
bearer_token_env_var = "BSC_API_TOKEN"
一般的な Streamable HTTP 構成
{
    "mcpServers": {
        "bank-statement-conversion": {
            "type": "streamable-http",
            "url": "https://bank-statement-conversion.com/mcp/bank-statement-conversion",
            "headers": {
                "Authorization": "Bearer ${BSC_API_TOKEN}"
            }
        }
    }
}
認証

トークンをプロンプトに表示しないでください。

ダッシュボード トークンを作成し、環境変数として保存します。そのトークンをチャット、ソース コード、ドキュメント、スクリーンショット、またはログに貼り付けないでください。

APIトークンを作成する
環境変数
BSC_API_TOKEN=your_dashboard_token
account:status conversion:read conversion:upload conversion:download

ClaudeとAnthropicのセットアップ。

Claude コネクタまたは Anthropic Messages API を備えた同じホスト型 MCP エンドポイントを使用します。

Claude

Claude アプリと Claude Desktop

  1. API Tokens から Bank Statement Conversion ダッシュボード トークンを作成します。
  2. Claude 設定を開き、[コネクタ] に移動して、[カスタム コネクタの追加] を選択します。
  3. リモート MCP サーバー URL として https://bank-statement-conversion.com/mcp/bank-statement-conversion を入力します。
  4. Claude が接続を要求する場合は、ベアラー認証にダッシュボード トークンを使用します。
  5. チャットでコネクタを有効にし、ファイルをアップロードする前にアカウント ステータス チェックを実行します。
Anthropic API

Messages API MCPコネクタ

キープする BSC_API_TOKEN サーバー側でそれを MCP サーバー認証トークンとして渡します。リクエストには、同じサーバー名を参照する MCP ツールセットも必要です。

Anthropic MCP ご要望形状
{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Check whether my Bank Statement Conversion account can run a conversion."
        }
    ],
    "mcp_servers": [
        {
            "type": "url",
            "url": "https://bank-statement-conversion.com/mcp/bank-statement-conversion",
            "name": "bank-statement-conversion",
            "authorization_token": "${BSC_API_TOKEN}"
        }
    ],
    "tools": [
        {
            "type": "mcp_toolset",
            "mcp_server_name": "bank-statement-conversion"
        }
    ],
    "betas": [
        "mcp-client-2025-11-20"
    ]
}

MCP ワークフローが利用可能。

これらのツールは、REST API で使用されるのと同じパブリック変換ワークフローにマップされます。

アカウントのステータス

クレジット、ページ許容量、プラン、変換が実行できるかどうかを確認します。

変換ファイルをアップロードする

確認済みの銀行取引明細書、請求書、領収書、または構造化された取引明細書ファイルを送信します。

変換ステータスの読み取り

完了した応答にダウンロード トークンが含まれるまで、ジョブの進行状況をポーリングします。

ダウンロード出力

返されたダウンロード トークンを使用して、完了した変換を取得します。

GET /api/user-statusPOST /api/uploadGET /api/conversion-status/{jobId}GET /api/download/{downloadToken}
安全範囲

財務文書には明示的な管理が必要です。

MCP では、チャット内で変換が可能になるため、ワークフローは狭く、監査可能で、簡単に取り消すことができます。

すべてのエージェント ワークスペースに専用の API トークンを使用します。
このページに示されている 4 つの変換機能のみを有効にします。
明細書、請求書、領収書、または会計ファイルをアップロードする前に確認してください。
変換された出力のダウンロード リンクを準備する前に確認してください。
返されたダウンロード トークンを使用します。ファイル URL を構築しないでください。
エージェントのアクセスを停止する必要がある場合は、ダッシュボード トークンを取り消します。

MCP クライアントに接続する準備はできましたか?

BSC_API_TOKEN を設定し、リモート エンドポイントを追加し、最初にエージェントにステータス チェックを実行させます。