AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

오픈 뱅킹: MongoDB를 이용한 안전한 데이터 공유

MongoDB Atlas 와 Agentic AI 활용하여 동의 여정과 데이터 공유를 지원하는 미래형 오픈 뱅킹 친환경 시스템을 구축하세요.

사용 사례: 인공 지능, 싱글 뷰, 개인화

산업: 금융 서비스

제품 및 도구: MongoDB Vector Search, MongoDB MCP 서버, MongoDB Queryable Encryption

파트너: LangChain

이 솔루션은 오픈 뱅킹 에코시스템을 제시하고 MongoDB Atlas와 에이전틱 AI를 활용하여 기관 간 금융 데이터를 안전하게 공유하는 방법을 보여줍니다.

LangGraph를 사용하여 에이전트 AI 프레임워크를 구현하고, 동의 승인을 간소화하며, 고객에게 다수의 은행 금융 정보를 통합해 제공하는 방법을 알아보세요. MongoDB Atlas는 이러한 오픈 뱅킹 아키텍처를 뒷받침하는 BIAN 정렬 데이터 계층 역할을 합니다.

그림 1: 오픈 뱅킹 참조 아키텍처

그림 1. 오픈 뱅킹 참조 아키텍처.

클릭하여 확대

다이어그램에 표시된 대로 프로세스 고객이 Leafy 은행(가상의 금융 기관)에 로그인할 때 시작됩니다. 고객이 외부 데이터, 즉 타사 제공자(TPP) 데이터 또는 기타 금융 기관 데이터(이 데모에서는 MongoDB 은행, 네오파이낸스, 그린 뱅크)에 액세스 액세스를 허용하거나 거부합니다.

멀티 에이전트 워크플로는 고객 요청 수신하고 다음 작업을 수행합니다.

  • 슈퍼바이저 에이전트: 대화를 읽고 각 요청 올바른 전문가에게 라우팅합니다.

  • 동의 에이전트: 외부 은행과의 안전한 데이터 공유 동의를 안내합니다. 기관 선택, 동의 생성, 은행 로그인, 명시적 고객 승인 및 철회를 처리합니다.

  • 재무 조언 에이전트: MCP 서버를 통해 MongoDB에 직접 쿼리하여 고객의 계좌, 프트랜잭션, 제품, 내부 및 외부 은행 전반의 로그 지출에 대한 임의의 질문에 답변합니다.

이 데모에서는 MongoDB Atlas와 에이전틱 AI가 안전하고 지능적인 오픈 뱅킹 워크플로를 지원하는 다음과 같은 역량을 살펴봅니다.

동의 기록을 일반 텍스트로 저장하면 데이터베이스 관리자, 백업 프로세스 및 잠재적인 침해 사고에 민감한 필드가 노출됩니다. 오픈 뱅킹 규정은 이러한 위험을 방지하기 위해 기관이 생성, 권한 부여, 데이터 검색 및 취소와 같은 모든 동의 수명 주기 이벤트 전반에서 소비자 신원을 보호하도록 요구합니다. 미사용 데이터 암호화는 시스템 프롬프트 및 도구 정의와 같은 AI 에이전트 구성도 보호하여 독점 로직의 노출을 제한합니다.

MongoDB Queryable Encryption 드라이버 수준에서 민감한 필드를 암호화하여 서버 일반 텍스트를 볼 수 없도록 하여 이 문제를 해결합니다. 필터링이 필요한 필드는 동일성 쿼리에 대해 구성할 수 있습니다. 드라이버 쿼리 값을 전송하기 전에 암호화하므로 서버 일반 텍스트를 보지 않고 암호 텍스트와 일치시킵니다. 암호 해독 후 읽기만 필요한 필드는 쿼리 지원 없이 암호화됨 유지됩니다.

데모에서는 Queryable Encryption 두 곳에 적용합니다.

  1. 동의 컬렉션(leafy_bank_bian 데이터베이스의 openbankingConsents, 오픈 뱅킹 백엔드에서 관리), 4개의 암호화됨 필드 포함:

    • Consumer.UserName

    • Consumer.UserId

    • Permissions

    • SourceInstitution.InstitutionName

    Consumer.UserName 필드 동일성 쿼리를 지원하므로 데이터베이스 가 사용자 이름 일반 텍스트로 표시하지 않고도 서비스에서 고객의 동의를 나열할 수 있습니다.

  2. 에이전트 프로필 컬렉션 챗봇 백엔드의 openbankingAgentProfiles), 3개의 암호화된 필드 포함:

    • agent_name (동등성 쿼리 가능)

    • system_prompt

    • tool_config

에이전트 프롬프트는 런타임 시 암호화된 MongoDB에서 로드됩니다. Queryable Encryption이 각 필드에 대해 별도의 데이터 암호화 키를 생성합니다. AWS Key Management Service(KMS), Azure Key Vault, Google Cloud KMS를 키 관리 공급자로 지원합니다.

다음 예시는 오픈 뱅킹 백엔드를 위한 암호화된 연결 설정을 보여줍니다.

from pymongo import MongoClient
from pymongo.encryption_options import AutoEncryptionOpts
class EncryptedMongoDBConnection(MongoDBConnection):
"""Subclasses the standard connection — services that type-hint
MongoDBConnection accept it without modification."""
def __init__(self, uri: str, auto_encryption_opts: AutoEncryptionOpts):
self.uri = uri
self.client = MongoClient(self.uri, auto_encryption_opts=auto_encryption_opts)

동의 쿼리는 일반 텍스트와 동일하게 작동하며, 드라이버 암호화 및 복호화를 투명하게 처리합니다.

# Standard query on a plaintext field — works as usual
consent = consents_collection.find_one({"ConsentId": consent_id})
# Equality query on an encrypted field — same syntax, driver encrypts the filter value
consents = list(consents_collection.find({"Consumer.UserName": user_name}))

암호화됨 연결은 표준 MongoDBConnection을 확장하므로 기본 클래스를 유형 힌트하는 모든 서비스가 수정 없이 이를 허용합니다.

재무 자문가와 소비자는 계정 데이터에 대한 "내 총 잔액은 얼마인가요?"라는 즉석 답변이 필요한 경우가 많습니다. "마지막 10 트랜잭션 보기" 또는 "내가 사용할 수 있는 제품은 무엇인가요?" 가능한 모든 쿼리 에 대해 사용자 지정 API 엔드포인트를 구축하는 것은 비실용적입니다.

MongoDB MCP 서버는 LLM 에이전트가 직접 호출할 수 있는 도구로 MongoDB 컬렉션을 노출합니다. 이 데모는 애플리케이션 스타트업 시 MCP 서버 하위 프로세스로 실행하고, 읽기 전용 모드 로 leafy_bank_bian 데이터베이스 에 연결하고, 결과 도구를 영구 세션을 통해 LangGraph 에이전트 에 전달합니다.

다음 예시 MCP 서버 통합을 보여줍니다.

from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain_mcp_adapters.tools import load_mcp_tools
mcp_client = MultiServerMCPClient({
"mongodb": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server@latest"],
"transport": "stdio",
"env": {
**os.environ,
"MDB_MCP_CONNECTION_STRING": LEAFY_BANK_MONGODB_URI,
"MDB_MCP_READ_ONLY": "true",
"MDB_MCP_DISABLED_TOOLS": disabled_tools,
},
}
})
# Persistent session keeps MongoDB connection state across tool calls
async with mcp_client.session("mongodb") as session:
all_mcp_tools = await load_mcp_tools(session)
# Pre-connect so the agent never handles connection strings
connect_tool = next((t for t in all_mcp_tools if t.name == "connect"), None)
if connect_tool:
await connect_tool.ainvoke({"connectionString": LEAFY_BANK_MONGODB_URI})
# Only expose read/query tools to the agent
allowed_tools = {"find", "aggregate", "count", "list-collections", "collection-schema"}
mcp_tools = [t for t in all_mcp_tools if t.name in allowed_tools]

leafy 은행 에이전트 이러한 필터링된 도구와 LangGraph 구성에서 인증된 고객의 식별자를 읽는 get_current_user_id 도구를 수신합니다. MongoDB 쿼리를 자동으로 생성하여 언어 질문에 답변하며, 에이전트 다음 조치를 수행할 수 있습니다.

  • find: 조회에 사용합니다.

  • aggregate: 계산에 사용합니다.

  • Collection-schema: 검색에 사용합니다.

컬렉션 당 사용자 지정 도구 코드는 필요하지 않습니다.

오픈 뱅킹 워크플로는 동의 관리, 재무 분석, 내부 은행 데이터 쿼리 등 다양한 영역에 걸쳐 있습니다. 이 세 가지를 모두 처리하는 단일 모놀리식 에이전트에는 큰 도구 세트와 상충하는 문제를 다루는 시스템 프롬프트가 필요합니다. 전문 에이전트로 분할하면 각 도구 세트는 작게 유지되고 각 프롬프트는 집중화됩니다.

감독 에이전트는 다음 전문가를 오케스트레이션합니다.

  • 동의 에이전트: 데이터 공유 흐름을 관리합니다.

  • 재무 조언 에이전트: MCP 서버를 통해 Leafy Bank의 데이터 쿼리 및 지출을 분석합니다.

LangGraph는 의도에 따라 각 고객 메시지를 적절한 전문가에게 라우팅하고 MongoDB Atlas 체크포인트 컬렉션을 통해 대화 상태 유지합니다.

다음 예시 구조화된 출력이 있는 감독자 라우팅을 보여줍니다.

from langgraph.graph import StateGraph, START, END
from langgraph.checkpoint.mongodb import MongoDBSaver
# Each specialist is built from a factory that loads its system prompt
# from a Queryable-Encryption-backed MongoDB collection at startup.
consent_agent = create_consent_agent(prompts["consent_agent"])
financial_advice_agent = create_financial_advice_agent(
prompts["financial_advice_agent"], mcp_tools
)
supervisor = create_supervisor_node(prompts["supervisor"])
def route_from_supervisor(state: AgentState) -> str:
# The supervisor writes its routing decision to state["next"]
return state.get("next", "FINISH")
workflow = StateGraph(AgentState)
workflow.add_node("supervisor", supervisor)
workflow.add_node("consent_agent", consent_agent)
workflow.add_node("financial_advice_agent", financial_advice_agent)
workflow.add_edge(START, "supervisor")
workflow.add_conditional_edges("supervisor", route_from_supervisor, {
"consent_agent": "consent_agent",
"financial_advice_agent": "financial_advice_agent",
"FINISH": END,
})
workflow.add_edge("consent_agent", "supervisor")
workflow.add_edge("financial_advice_agent", "supervisor")
checkpointer = MongoDBSaver(
client=db.client,
db_name=DATABASE_NAME,
checkpoint_collection_name=CHECKPOINTS_AIO_COLLECTION,
writes_collection_name=CHECKPOINTS_WRITES_AIO_COLLECTION,
)
graph = workflow.compile(checkpointer=checkpointer)

동의 승인, KYC 검토, 결제 권한 부여 등 규제된 워크플로에서는 에이전트 계속 진행하기 전에 일시 중지하고 결정을 기다려야 하는 사람의 체크포인트가 필요합니다. LangGraph의 interrupt() 메커니즘은 전체 그래프 상태 MongoDB 로 직렬화하고 호출자에게 페이로드를 반환하여 이러한 요구 사항을 처리합니다. 외부 프로세스 완료되면 워크플로가 다시 시작됩니다.

from langgraph.types import interrupt, Command
# Agent pauses, returns review payload to the calling application
review = interrupt({
"type": "APPROVAL_REQUIRED",
"details": approval_details,
})
# Application resumes the workflow after the human decision
await agent.ainvoke(Command(resume=decision), config)

MongoDB Atlas 체크포인트 컬렉션은 전체 대화 상태 유지합니다.

  • 메시지 기록

  • 활성 동의

  • 라우팅 결정

워크플로는 몇 초(버튼 클릭) 또는 몇 시간(야간 컴플라이언스 검토) 지속되는 중단을 견뎌냅니다. 각 하위 에이전트는 최종 응답을 생성할 때까지 ReAct 루프(이유 → 행동 → 관찰)를 실행한 후 다음 라우팅 결정을 위해 슈퍼바이저 에이전트 에게 제어권을 반환합니다.

데모에서는 두 개의 MongoDB Atlas 데이터베이스를 사용합니다.

  • leafy_bank_bian: 이 데이터베이스는 고객(PartyReferenceDataDirectory), 계정(CurrentAccount), 트랜잭션, 제품 등 데모가 실행되는 공유된 BIAN 정렬 운영 모델을 포함합니다. 이 데이터베이스는 또한 Queryable-Encrypted openbankingConsents 컬렉션의 동의 기록과 승인된 동의에 따라 가져온 외부 데이터를 저장하는 cachedExternalData 컬렉션을 보유합니다.

  • open_finance: 이 데이터베이스에는 외부 기관의 원천 데이터(external_accounts 및 제휴 기관에서 제공한 external_products)와 기관 레지스트리가 포함되어 있습니다.

Leafy Bank는 leafy_bank_bian 데이터를 소유하고 씁니다. 외부 데이터는 동의를 통해 차용되며, 소유되지 않습니다. 데이터는 승인된 동의에 따라 open_finance에서 읽고, 부여된 ConsentId로 태그를 지정한 cachedExternalData 에 캐시되며, 동의가 취소되거나 만료되면 제거됩니다. 기관 자체의 계좌 및 트랜잭션 기록에는 병합되지 않습니다.

다음은 컬렉션에 있는 문서의 예입니다.

  • accounts (leafy_bank_bian에서):

    {
    "accountId": "ACC-e0583b3b",
    "accountBank": "Leafy Bank",
    "accountNumber": "212100310",
    "currency": "USD",
    "balance": { "current": 315, "available": 315, "ledger": 315, "hold": 0, "overdraftLimit": 0 },
    "customerSnapshot": { "customerId": "CUST-00528224" },
    "gl": { "accountCode": "2121", "costCenter": "CC-RETAIL-DEFAULT" },
    "productId": "PROD-STD-SA-USD",
    "openedAt": "2024-12-07"
    }
  • openbankingConsents (leafy_bank_bian에서), 민감한 필드에 Queryable Encryption이 설정된 동의 기록:

    {
    "ConsentId": "urn:greenbank:Cf5b9ff59e06f77",
    "Status": "AUTHORISED",
    "Consumer": { "UserName": "< encrypted >", "UserId": "< encrypted >" },
    "Permissions": "< encrypted >",
    "Purpose": "FINANCIAL_ADVICE",
    "SourceInstitution": { "InstitutionName": "< encrypted >", "InstitutionId": "679a1001a9711d00a3bb01a1" },
    "CreationDateTime": "2026-02-05T10:55:30Z",
    "ExpirationDateTime": "2026-08-04T10:55:30Z",
    "StatusHistory": [
    { "Status": "AWAITING_AUTHORISATION", "DateTime": "2026-02-05T10:55:30Z" },
    { "Status": "AUTHORISED", "DateTime": "2026-02-05T10:56:06Z" }
    ]
    }

외부 트랜잭션은 Leafy Bank 자체 트랜잭션과 동일한 BIAN 정렬 스키마를 사용합니다(계좌 소유자는 발신 트랜잭션에서는 지급인으로, 수신 트랜잭션에서는 수취인으로 표시). 따라서 다양한 기관의 데이터가 일관적인 형태로 도달합니다.

다음 섹션의 GitHub 리포지토리를 방문하여 솔루션의 모든 컬렉션에서 샘플 데이터를 살펴보세요.

이 솔루션을 구축하려면 오픈 뱅킹 백엔드, 에이전트 챗봇 백엔드, 통합 UI 등의 통합 서비스를 구현합니다.

전체 구현 위해서는 해당 GitHub 리포지토리의 지침을 따르세요.

파트 1: 오픈 뱅킹 백엔드(GitHub 리포지토리)

1
  • MongoDB Atlas 프로젝트 및 클러스터 생성합니다.

  • 이 데모에서 사용할 내부 데이터용 leafy_bank_bian, 외부 데이터 및 동의용 open_finance 데이터베이스를 생성합니다.

2
  • 계획 문서 와 README에 설명된 컬렉션을 채웁니다.

  • 샘플 데이터를 로드하여 참조 흐름을 엔드-투-엔드로 실행합니다.

3
  • 로컬 마스터 키를 생성하거나 클라우드 KMS(예: AWS KMS)를 구성하여 프로덕션 환경에 맞게 설정합니다.

  • 설정 스크립트를 실행하여 Queryable-Encrypted encrypted_consents 컬렉션과 키 볼트를 생성합니다.

4
  • open-finance-next-gen FastAPI 앱 로컬로 또는 원하는 런타임에 배포합니다.

  • 리포지토리에 문서화된 MongoDB 연결, KMS 제공자 및 API 설정에 대한 환경 변수를 구성합니다.

5

다음 작업에 대한 보안 엔드포인트를 구현하고 확인합니다.

  • 동의 관리: 고객에 대한 동의를 생성, 승인, 취소 및 나열합니다.

  • 외부 고객 데이터 가져오기: 동의 범위별로 필터링된 계정, 대출, 상환 기록, 신원 정보 및 트랜잭션을 조회합니다.

  • 외부 데이터 캐시: 승인된 동의 하에 가져온 데이터를 저장하여 조언 에이전트가 실시간으로 다시 가져오지 않고도 데이터를 읽을 수 있도록 합니다.

  • 데이터 계산: 집계 파이프라인을 사용하여 잔액, 부채 합계 및 대출 이동성 제안을 결정합니다.

README에 설명된 대로 인덱스 및 동의 만료 처리(백그라운드 스위퍼)를 구성합니다.

2부: Agentic 챗봇 백엔드 (GitHub 리포지토리)

1
  • 챗봇 리포지토리 에서 LangGraph 기반 멀티 에이전트 백엔드 배포합니다.

  • LLM 제공자(예: Amazon Bedrock을 통한 Claude), 오픈 뱅킹 백엔드에 대한 HTTP 클라이언트, 대화 상태 체크포인트를 위한 MongoDB 연결을 구성합니다.

2
  • Queryable-Encrypted encrypted_agent_profiles 컬렉션을 만들려면 설정 스크립트를 실행합니다.

  • 에이전트 시스템 프롬프트 및 도구 구성을 시드합니다. 시작 시 그래프가 이를 로드합니다.

3

고객 메시지를 올바른 에이전트로 라우팅하도록 감독자 패턴을 구현합니다. 다음 작업을 수행하는 두 에이전트를 구성합니다.

  • 동의 에이전트: 기관을 나열하고, 동의를 생성하며, 외부 은행 로그인을 트리거하고, 데이터 공유를 승인하거나 취소합니다. 은행 로그인 및 명시적 동의 승인을 위해 LangGraph interrupt()를 사용하여 일시 중지합니다.

  • 금융 조언 에이전트: 고객의 계좌, 트랜잭션 및 상품에 대한 임시 질문에 답변하고 내부 및 외부 은행 전반의 지출을 분석합니다. 읽기 전용 MCP 서버를 통해 MongoDB에 직접 쿼리합니다.

4
  • 시작 시 MongoDB MCP 서버를 하위 프로세스로 실행하여 읽기 전용 모드로 leafy_bank_bian 데이터베이스에 연결하세요.

  • 재무 조언 에이전트에 읽기 및 쿼리 도구(find, aggregate, count, list-collections, collection-schema)만 노출합니다.

5
  • 웹 또는 모바일 프론트엔드 호출할 수 있는 채팅 엔드포인트( 예시 : 서버 전송 이벤트가 포함된 FastAPI)를 제공합니다.

  • 엔드포인트가 중간 메시지를 스트리밍하고 은행 로그인 및 동의 승인을 위한 LangGraph 중단을 처리하는지 확인합니다.

파트 3: 통합 UI(GitHub 리포지토리)

1
  • open-finance-next-gen-ui Next.js 앱을 배포하고 챗봇 및 오픈 뱅킹 백엔드 URL을 가리키도록 설정합니다.
2

README 파일에서 참조 시나리오를 실행합니다.

  • AI 어시스턴트를 통해 외부 은행을 연결하고 동의를 부여하세요.

  • 내부 및 외부 계좌를 포함한 여러 은행의 통합 포지션을 확인합니다.

  • 금융 조언 에이전트에게 은행 전반의 지출 인사이트를 요청합니다.

3
  • 운영 및 동의 데이터를 유지합니다.

  • 집계 워크로드와 대화 체크포인트를 지원합니다.

  • 완전한 에이전트 기반 동의 및 조언 과정을 지원합니다.

단계별 설정 명령, 환경 변수 및 API 세부 정보는 위에 언급된 각 리포지토리의 README 파일을 참조하세요.

  • MongoDB Atlas에서 오픈 뱅킹 데이터 통합: MongoDB Atlas에서 내부 및 외부 데이터 세트를 운영 데이터 레이어로 통합하여 통합 복잡성과 중복을 줄입니다.

  • 집계 파이프라인으로 분석 간소화: MongoDB 집계 파이프라인을 사용하여 단일 쿼리 경로에서 내부 및 외부 계정 전반의 잔액, 총부채 및 지출 점수를 계산합니다.

  • MongoDB Queryable Encryption으로 민감한 동의 데이터 보호: 동의 속성에 Queryable Encryption을 적용하여 규제 대상 오픈 뱅킹 워크로드에 대한 강력한 개인정보 보호 제어를 유지하면서 민감한 필드를 쿼리할 수 있습니다.

  • 에이전트형 AI 로 동의 과정 간소화: LangGraph 기반 다중 에이전트 챗봇을 통합하여 동의 범위, 기간, 목적을 언어 로 설명하여 다중 은행 흐름 전반에서 포기를 줄이고 고객 경험 개선합니다.

  • BIAN 정렬 모델로 데이터 표준화: BIAN 서비스 도메인 표준에 따라 내부 및 외부 계정, 트랜잭션 및 동의를 모델링하여 모든 기관의 데이터가 일관적인 형태로 도달하도록 합니다.

  • Saul Calderon

  • Kiran Tulsulkar

  • Ainhoa Múgica

  • Andrea Alaman Calderon