四个设置步骤。
使用托管端点，在代理客户端本地存储一个令牌，并保持操作可确认。
1
创建专用令牌
使用仪表板 API Tokens 页面为此代理创建令牌，与个人或生产应用程序令牌分开。
2
启用范围能力
仅授予 MCP 工具所需的帐户状态、上传、状态读取和下载能力。
3
添加远程端点
将支持 MCP 的客户端指向托管的 Bank Statement Conversion 端点。
4
确认敏感动作
在上传财务文件或准备下载转换后的文件之前，请代理询问。
端点
添加远程MCP服务器。
当您的客户要求运输时，请使用 Streamable HTTP。一些客户端接受不记名令牌环境变量，而其他客户端则使用授权标头。
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 设置。
将同一托管 MCP 端点与 Claude 连接器或 Anthropic Messages API 结合使用。
Claude
Claude 应用程序和 Claude Desktop
- 从 API Tokens 创建 Bank Statement Conversion 仪表板令牌。
- 打开 Claude 设置，然后转到连接器并选择添加自定义连接器。
- 输入 https://bank-statement-conversion.com/mcp/bank-statement-conversion 作为远程 MCP 服务器 URL。
- 当 Claude 请求连接时，使用仪表板令牌进行承载身份验证。
- 在聊天中启用连接器并在上传文件之前运行帐户状态检查。
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 令牌。
仅启用此页面上显示的四种转换功能。
在上传报表、发票、收据或会计文件之前进行确认。
在准备转换输出的下载链接之前确认。
使用返回的下载令牌。不要构造文件 URL。
当代理访问应停止时撤销仪表板令牌。