4가지 설정 단계.
호스팅된 엔드포인트를 사용하고, 하나의 토큰을 에이전트 클라이언트에 로컬로 저장하고, 작업을 확인할 수 있도록 유지하세요.
전용 토큰 생성
대시보드 API Tokens 페이지를 사용하여 개인 또는 프로덕션 앱 토큰과 별도로 이 에이전트에 대한 토큰을 생성하세요.
범위가 지정된 기능 활성화
MCP 도구에 필요한 계정 상태, 업로드, 상태 읽기 및 다운로드 기능만 부여합니다.
원격 끝점 추가
MCP 가능 클라이언트가 호스팅된 Bank Statement Conversion 엔드포인트를 가리키도록 하세요.
민감한 작업 확인
금융 문서를 업로드하거나 변환된 파일 다운로드를 준비하기 전에 상담원에게 물어보세요.
원격 MCP 서버를 추가합니다.
클라이언트가 전송을 요청하면 Streamable HTTP를 사용하세요. 일부 클라이언트는 전달자 토큰 환경 변수를 허용하는 반면 다른 클라이언트는 Authorization 헤더를 사용합니다.
[mcp_servers.bank_statement_conversion] url = "https://bank-statement-conversion.com/mcp/bank-statement-conversion" bearer_token_env_var = "BSC_API_TOKEN"
{
"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
Claude 및 Anthropic 설정.
Claude 커넥터 또는 Anthropic Messages API와 함께 동일한 호스팅된 MCP 엔드포인트를 사용합니다.
Claude 앱 및 Claude Desktop
- API Tokens에서 Bank Statement Conversion 대시보드 토큰을 만듭니다.
- Claude 설정을 연 다음 커넥터로 이동하여 사용자 지정 커넥터 추가를 선택합니다.
- 원격 MCP 서버 URL로 https://bank-statement-conversion.com/mcp/bank-statement-conversion를 입력합니다.
- Claude가 연결을 요청할 때 베어러 인증을 위해 대시보드 토큰을 사용합니다.
- 파일을 업로드하기 전에 채팅에서 커넥터를 활성화하고 계정 상태 확인을 실행하세요.
Messages API MCP 커넥터
유지하다 BSC_API_TOKEN 서버 측에서 이를 MCP 서버 인증 토큰으로 전달합니다. 요청에는 동일한 서버 이름을 참조하는 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를 사용하면 채팅 내에서 변환이 가능하므로 워크플로가 좁고 감사 가능하며 취소하기 쉬워야 합니다.