LOB(기간 업무) MCP 앱은 Microsoft 365 Copilot을 CRM, IT 서비스 관리, ERP, HR과 같은 핵심 비즈니스 기능을 지원하는 엔터프라이즈 시스템에 연결합니다. 이 문서에서는 개발자와 설계자에게 이러한 시스템의 데이터, 관계, 권한 및 워크플로를 통합하기 위한 핵심 디자인 패턴과 일반적인 문제를 제공합니다.
LOB MCP 앱에 추가 디자인이 필요한 이유
선언적 에이전트에서 MCP 앱은 MCP 도구 응답에 대화형 앱 위젯을 추가합니다. Microsoft 365 Copilot은 대화형 진입점을 제공하고, MCP 서버는 외부 시스템에 연결하며, 앱 위젯을 통해 사용자는 대화를 종료하지 않고도 데이터를 검토, 탐색 또는 사용할 수 있습니다.
Microsoft 365 Copilot에서 작업하는 사용자는 종종 Salesforce, ServiceNow, HubSpot, Microsoft Dynamics 365, SAP 비즈니스 애플리케이션, Workday, Jira 및 Coupa와 같은 LOB(기간 업무) 시스템에서 정보를 검색하거나 작업을 수행해야 합니다. 이러한 패키지된 엔터프라이즈 응용 프로그램에는 사전 구축된 광범위한 데이터 구조, 관계 및 비즈니스 논리가 포함되어 있으며, 조직은 종종 추가로 사용자 지정합니다. 따라서 동일한 LOB 제품의 두 배포라도 서로 다른 필드, 값, 관계, 사용 권한 및 워크플로를 노출할 수 있습니다. 사용자 요청도 다양하며 고정된 구조를 따르지 않고도 비즈니스 이름, 필터, 관련 레코드 및 작업을 결합할 수 있습니다.
예를 들어 사용자는 Copilot에 "Global Fizz를 찾아서 관련 열린 레코드를 표시해줘"라고 요청할 수 있습니다. 이와 같은 요청을 지원하려면 데이터를 검색하거나 업데이트하는 도구를 노출하는 것 이상의 것이 필요합니다. MCP 앱은 비즈니스 용어를 해석하고, 대상 환경에 대해 유효성을 검사하고, 관련 레코드를 resolve하고, 액세스 제어를 유지하고, 다단계 워크플로를 조정해야 합니다. 이러한 요구 사항에는 도구 설계, 데이터 처리 및 대화형 환경 전반에 걸쳐 의도적인 패턴이 필요합니다.
기본 지침은 MCP 플러그 인 빌드, MCP 앱으로 UI 추가 및 MCP 앱에 대한 UX 지침을 참조하세요.
Salesforce, ServiceNow 및 HubSpot 참조 샘플을 기반으로 하는 다음 설계 원칙은 도구 설계 및 대화형 워크플로를 통해 데이터 모델에서 이러한 문제를 해결합니다.
도구를 정의하기 전에 LOB 데이터 모델 매핑
Copilot이 호출할 수 있는 MCP 도구를 정의하기 전에 지원되는 대화 시나리오와 LOB 애플리케이션의 데이터 모델을 검토합니다. 각 LOB 애플리케이션에는 기본 제공 데이터 모델이 있지만 조직에서 광범위하게 사용자 지정할 수 있습니다. 따라서 제품의 기본 스키마 또는 참조 샘플이 대상 환경과 일치하지 않을 수 있습니다. API 이름, 레이블, 데이터 형식, 필수 또는 읽기 전용 상태, 허용되는 값, 관계를 포함하여 각 엔터티 및 필드를 확인합니다.
LOB 애플리케이션 사용자 지정 팀과 협력하여 환경별 변경 내용을 식별합니다. MCP 서버, 도구 스키마 및 앱 위젯이 현재 데이터 모델에 맞게 유지하여 LOB 시스템에서 벗어나지 않도록 합니다.
MCP 앱 구성 요소에서 별도의 책임
LOB MCP 앱은 사용자 지정된 비즈니스 규칙을 적용하고, 원본 시스템 권한을 보존하고, 관련 레코드를 resolve하고, 에이전트 지침, MCP 도구, LOB 통합 및 앱 위젯에서 결과적 업데이트를 처리해야 합니다. 규칙이 일관되게 적용되고 각 계층을 독립적으로 보호, 테스트 및 변경할 수 있도록 이러한 책임을 별도로 유지합니다.
- 에이전트 지침과 도구 설명을 사용하여 도구 선택 및 인수 준비를 안내합니다. 서버의 모든 도구 호출의 유효성을 검사합니다. 지침에 의존하여 권한, 허용되는 값, 관계 또는 쿼리 안전을 적용하지 마세요.
- MCP 서버 진입점(들어오는 MCP 요청을 수신하는 코드)을 사용하여 도구 호출을 라우팅합니다. 비즈니스 규칙, 값 변환, 관계 해결 및 결과 준비를 해당 처리기에서 사용하는 도구 처리기 또는 도우미 코드에 보관합니다.
- 다운스트림 인증 및 API 통신에 LOB 클라이언트 또는 어댑터를 사용합니다. 페이지 매김, 재시도, 제한 및 소스 시스템 오류 처리를 이 경계 뒤에 유지합니다.
- 소스 파일에서 앱 위젯을 빌드하고 유지 관리합니다. 앱 위젯은 결과를 표시하고 입력을 수집하며 호스트 브리지를 사용하여 MCP 도구를 호출합니다. 자격 증명을 저장하거나, 권한 부여를 결정하거나, LOB API를 직접 호출해서는 안 됩니다. 이 원본에서 배포 가능한 앱 위젯 HTML을 생성합니다. 생성된 파일을 직접 편집하지 마세요.
LOB 시스템과 인증 일치
MCP 엔드포인트에 대한 인증과 MCP 서버에서 LOB 시스템으로의 인증은 별도의 경계입니다. 다음 옵션은 다운스트림 LOB 인증에 대해 설명합니다. 접근 방식을 선택하기 전에 대상 시스템이 지원하는 항목을 확인합니다.
- 위임된 ID 는 각 사용자의 로그인 토큰을 사용합니다. 사용자별 권한 및 감사 기록을 유지하지만 LOB 지원, 추가 인증 설정 및 토큰 관리가 필요합니다.
- 애플리케이션 ID 는 암호 또는 인증서가 있는 클라이언트 ID를 사용합니다. 서비스 간 액세스가 단순화되지만 LOB 시스템은 사용자 대신 애플리케이션에 작업을 특성화합니다.
- 공유 자격 증명은 모든 사용자에 대해 하나의 개인 토큰, API 키 또는 서비스 계정 암호를 사용합니다. 구성은 간단하지만 LOB 시스템은 사용자별 권한 또는 특성을 적용할 수 없습니다.
MCP 엔드포인트 옵션은 MCP 인증을 참조하세요.
다른 애플리케이션이 아닌 상황에 맞는 환경 빌드
LOB 시스템은 이미 광범위한 워크플로, 탐색 및 관리를 위한 전체 애플리케이션을 제공합니다. 해당 응용 프로그램을 다시 만들거나 MCP 앱 내에서 해당 화면을 복제하지 마세요. 전체 화면을 복제하면 로드 시간이 길어지고 대화가 줄어듭니다. 현재 대화에 필요한 포커스 UI에 LOB MCP 앱을 사용하고 LOB 시스템으로 광범위한 작업을 보냅니다.
대화를 통해 작업을 설정하도록 하고, 작업이 구조화된 검토 또는 상호 작용의 이점을 활용할 때 앱 위젯을 사용하게 합니다.
예를 들어 사용자는 다음과 같이 질문할 수 있습니다.
사용자: "이번 달에 마감되는 열린 기회를 보여 줘."
앱 위젯은 전체 CRM 환경을 재현하지 않고도 검토 및 편집을 위해 필터링된 레코드를 제공할 수 있습니다.
사용자가 앱 위젯에서 관련 비즈니스 엔터티를 탐색할 수 있도록 허용
LOB 정보는 관련 엔터티 간에 분산되는 경우가 많습니다. 계정, 케이스, 직원 또는 공급업체를 이해하려면 기본 레코드를 컨텍스트에 유지하면서 관련 레코드를 확인해야 할 수 있습니다. 확장 가능한 섹션 또는 세부 정보 보기와 같은 앱 위젯 상태 및 UX 기능을 사용하여 사용자가 각 엔터티에 대해 별도의 대화형 요청을 하지 않고도 이러한 관계를 탐색할 수 있습니다.
예를 들어 사용자가 Copilot에 계정을 요청하면 반환된 계정은 앱 위젯이 컨텍스트에서 유지하는 기본 레코드가 됩니다.
사용자: "글로벌 계정 표시."
기회, 사례 및 연락처와 같은 관련 엔터티에 대한 컨트롤이 있는 계정의 키 필드를 표시합니다. 앱 위젯 상태에서 계정 컨텍스트를 유지합니다. 선택한 보기에 관련 데이터가 필요한 경우 현재 계정 ID를 사용하여 호스트 브리지를 통해 적절한 MCP 도구를 호출합니다. 사용자가 해당 보기를 열 때만 관련 레코드를 로드하고 기본 레코드는 그대로 표시합니다.
목록을 사용하여 검토할 주요 필드를 표시하고 선택한 레코드에 대한 세부 양식을 여는 편집 단추를 추가합니다.
대화는 비즈니스 컨텍스트를 한 번 설정하면 UI를 통해 사용자가 직접 상호 작용을 통해 해당 컨텍스트를 계속 탐색할 수 있도록 합니다.
초기 요청은 대신 사용자가 원하는 관련 보기의 이름을 지정할 수 있습니다.
사용자: "글로벌 계정에 기회를 보여주세요."
사용자가 레코드를 탐색해야 하는 경우에만 관련 엔터티 통과 환경을 사용합니다. 순회 화면은 컨텍스트를 유지하고 여러 관련 보기를 로드하기 때문에 더 무겁습니다. 인라인 앱 위젯에 초점을 유지하세요. 통과에 더 많은 공간이 필요한 경우 대화를 보존하는 확장된 표면을 사용합니다. 독립적인 작업의 경우 해당 작업을 위해 설계된 포커스가 있는 앱 위젯을 사용합니다.
대화 컨텍스트로 앱 위젯 미리 채우기
사용자가 LOB 레코드를 만들 때 양식에는 많은 필수, 제어값 및 관계 필드가 포함될 수 있습니다. 사용자는 종종 요청에 이러한 정보 중 일부를 제공합니다. 사용자가 정보를 반복하지 않고 검토하고 나머지 필드를 완료할 수 있도록 만들기 양식에서 해당 값을 미리 채웁니다. 이 패턴은 대화를 사용하여 컨텍스트를 제공하고 앱 위젯을 사용하여 구조화된 검토 및 상호 작용을 제공합니다.
예를 들어 사용자의 요청은 여러 폼 필드에 대한 값을 제공할 수 있습니다.
사용자: "이메일
maya@contoso.com로 Contoso의 Maya Chen에 대한 연락처를 만드세요."
show_create_form(
entity="contact",
prefill={"first_name": "Maya", "last_name": "Chen",
"email": "maya@contoso.com", "company_name": "Contoso"}
)
앱 위젯이 열리고 해당 값이 채워지므로 사용자가 이를 검토하고 누락된 필드를 작성할 수 있습니다. 미리 채워진 값을 사용자 입력으로 처리: 레코드를 만들기 전에 MCP 서버에서 유효성을 검사합니다.
Microsoft 365 작업 컨텍스트가 작업을 개선할 수 있는 경우 Work IQ 를 사용합니다. "나의"와 관련된 요청을 처리하고 레코드를 만들거나 업데이트하는 데 관련 컨텍스트를 제공하는 데 도움이 될 수 있습니다.
LOB 데이터를 위한 디자인 도구 및 상호 작용
비즈니스 운영에 대한 설계 도구
LOB 시스템은 일반적으로 많은 엔터티와 작업이 포함된 크고 복잡한 API를 노출합니다. 전체 API를 MCP 도구로 미러링하지 마세요. 사용자에게 필요한 집중적인 비즈니스 작업 세트를 정의하고 각 도구에 고유한 이름, 설명 및 입력 스키마를 지정합니다. MCP 서버 내에서 API 필터 빌드 및 관련 레코드 이름 확인과 같은 지원 작업을 계속 수행하세요.
디자인 도구와 앱 위젯을 함께 사용하세요. 모든 도구 또는 엔터티에 대해 별도의 위젯을 만드는 대신 목록, 양식 및 세부 정보 보기와 같은 일반적인 상호 작용 유형에 최적화된 앱 위젯의 작은 집합을 다시 사용합니다. 이 접근 방식은 사용자 환경을 일관되게 유지하고 위젯 코드, 로드 오버헤드 및 유지 관리를 줄입니다.
가져오기, 만들기 및 업데이트와 같은 일반적인 작업에 대한 별도의 도구를 만듭니다.
get_records(...)
create_record(...)
update_record(...)
또한 모든 엔터티와 작업을 허용하는 하나의 제한되지 않은 도구를 피합니다. 광범위한 스키마로 인해 유효성 검사, 권한 부여, 라우팅 및 결과 처리를 덜 예측할 수 있습니다.
보거나 편집하기 전에 레코드 일치 처리
사용자는 일반적으로 안정적인 레코드 ID보다는 계정, 회사 또는 연락처 이름과 같은 비즈니스 이름을 기준으로 LOB 레코드를 검색합니다. 레코드 ID는 종종 많은 숫자를 포함하며 기억하거나 대화에 입력하기가 비현실적입니다. 예를 들어 Salesforce 레코드에는 사용자가 알거나 입력할 가능성이 거의 없는 ( 과 같은 0015g00000ABCDeAAH18자리 ID가 있을 수 있습니다.) 업체 이름은 종종 고유 명사이며 사용자가 부분 값을 입력하거나 철자 오류를 범할 수 있습니다. 따라서 검색은 0, 1 또는 여러 레코드와 일치할 수 있습니다. 이름-ID 확인 패턴을 사용하여 보거나 편집하기 전에 사용자의 텍스트를 검증된 안정적인 레코드 ID로 변환합니다. 이 방법을 사용하면 잘못된 레코드에 작업이 적용되지 않습니다. 첫 번째 일치 항목이 의도한 레코드라고 가정하지 마세요. 도구 스키마에서 지원되는 검색 필드 및 record-ID 매개 변수를 선언합니다.
예를 들어 사용자는 이름으로 편집할 계정을 식별할 수 있습니다.
사용자: "전역 계정을 편집해 줘."
먼저 사용자의 텍스트로 도구를 호출합니다.
get_accounts(name="Global")
MCP 서버는 텍스트를 지원되는 Contains 항목이나 LIKE 결과 제한이 있는 검색에 매핑합니다. LOB 쿼리 연산자에 필터를 매핑하는 방법에 대한 자세한 내용은 MCP 서버에서 필터링된 목록 빌드를 참조하세요. 이 접근 방식은 사용자가 정확한 저장된 이름을 제공하지 않을 때 후보 레코드를 검색합니다. 각 안정적인 ID와 레코드를 구분하는 데 필요한 인식 가능한 필드가 포함된 간단한 후보 결과를 반환합니다.
{
"structuredContent": {
"type": "accounts",
"items": [
{
"id": "0015g00000ABCDeAAH",
"name": "Global Media"
},
{
"id": "0015g00000FGHIjAAH",
"name": "Global Manufacturing"
}
]
}
}
후보 결과가 반환되면 일치 횟수에 따라 계속합니다. 하나의 명확한 일치의 경우 해당 ID와 요청된 작업을 사용하여 도구를 다시 호출합니다. 일치하는 항목이 여러 개인 경우 보기 또는 편집 컨트롤이 있는 목록을 표시합니다. 선택한 컨트롤은 해당 레코드의 ID로 도구를 호출합니다. 두 경우 모두 두 번째 호출은 확인된 ID와 요청된 작업을 사용합니다.
get_accounts(account_id="0015g00000ABCDeAAH", action="edit")
일치하는 레코드가 없으면 사용자에게 검색을 구체화하라는 메시지를 표시합니다.
에이전트 명령에서 이 두 호출 패턴을 Capture하고 도구 정의에서 이름 필터와 레코드 ID 입력을 모두 선언합니다.
{
"name": "get_accounts",
"description": "Get accounts. Pass account_id to retrieve one record; add action='edit' to open the edit form. Filters: name, industry, account_number, and type.",
"handler": get_accounts,
}
제어되고 선택 목록 값과 종속성 매핑
LOB 시스템에서는 선택 목록, 선택 필드 또는 열거형이라고도 하는 제어된 값 필드를 사용하는 경우가 많습니다. 사용자에게는 와 같은 Closed Won레이블이 표시되지만 API에는 와 같이 저장된 코드가 필요할 수 있습니다.closedwon 익숙한 레이블이 모든 구현에서 동일한 저장 값을 갖는다고 가정하지 마세요.
제어된 값 필드는 대상 LOB 환경에 구성된 값만 허용합니다. 저장된 값은 텍스트 코드, 숫자 또는 기타 시스템 식별자일 수 있습니다. 쿼리 또는 기타 CRUD 요청에 표시 레이블, 임의의 텍스트 또는 부실하게 저장된 값을 사용하면 유효성 검사 오류, 쓰기 실패 또는 결과 누락이 발생할 수 있습니다.
LOB 메타데이터 API에서 레이블과 코드를 검색하고 참조용으로 캐시합니다. LOB 시스템이 메타데이터 API를 제공하지 않는 경우 관리 구성을 통해 매핑을 유지 관리하고 확인합니다. 원본 구성이 변경되면 도구와 앱 위젯이 드리프트되지 않도록 캐시하거나 구성한 매핑을 새로 고칩니다.
예를 들어 다음과 같은 대소문자 구분 안 함 조회는 사용자 연결 레이블을 저장된 코드로 변환합니다.
label_to_code = {item["label"].casefold(): item["value"] for item in allowed_values}
normalized_value = user_value.casefold()
if normalized_value not in label_to_code:
raise ValueError("The value is not supported by the LOB system.")
status_code = label_to_code[normalized_value]
제어값 필드에 종속성이 있는 경우(한 선택 항목이 다른 선택 항목을 제어함) MCP 서버와 앱 위젯에서 사용하는 메타데이터에서 해당 관계를 캡처합니다. 예를 들어 범주가하위 범주를 제어하는 경우 하드웨어를 선택하면 허용된 하위 범주만 표시되어야 합니다. LOB 시스템에 쓰기 전에 MCP 서버에서 선택한 조합의 유효성을 검사합니다.
valid_codes = dependencies[category_code]
if subcategory_code not in valid_codes:
raise ValueError("The subcategory is not valid for the selected category.")
MCP 서버에서 필터링된 목록 빌드
LOB 쿼리는 여러 필드 형식 및 관련 레코드의 조건을 결합하는 경우가 많습니다. 사용자는 비즈니스 레이블 및 이름을 통해 이러한 조건을 표현하지만 LOB API에는 정확한 필드 이름, 저장된 값, 데이터 형식 및 쿼리 연산자가 필요합니다. MCP 서버에서 전체 쿼리의 유효성을 검사, 변환 및 실행할 수 있도록 지원되는 각 비즈니스 엔터티에 대해 하나의 포커스 목록 도구를 정의합니다.
예를 들어 사용자는 비즈니스 용어로 최소 금액을 표현할 수 있습니다.
사용자: "최소 20,000달러 상당의 거래를 보여주세요."
에이전트 지침은 Copilot이 요청을 적절한 도구에 일치시키고 설명에 선언된 필터만 사용하도록 안내합니다. 도구 스키마 및 처리기는 지원되지 않는 필터를 거부합니다.
목록 도구를 호출하기 전에 도구 설명에 선언된 필터에 사용자 요청의 각 조건을 일치시킵니다. 지원되지 않는 조건을 생략하거나 다른 필터로 바꾸면 안 됩니다. 도구가 요청된 필터를 지원하지 않는 경우 사용자에게 요청을 수정하도록 요청합니다.
Copilot은 "최소 20,000개"를 최소 금액 조건으로 해석합니다. 도구 설명에서 해당 amount_min 필터를 선언하기 때문에 선택됩니다get_deals.
{
"name": "get_deals",
"description": "Get deals. Filters: amount_min (inclusive minimum amount), stage.",
"handler": get_deals,
}
그런 다음 Copilot은 조건을 선언된 도구 매개 변수에 매핑합니다.
get_deals(amount_min="20000")
MCP 서버는 값의 유효성을 검사하고 도구 매개 변수를 LOB API에 필요한 필드 및 연산자에 매핑합니다.
FILTERS = {"amount_min": ("amount", ">=")}
def build_filter(parameter: str, value: str) -> str:
field, operator = FILTERS[parameter]
return f"{field} {operator} {float(value)}"
lob_filter = build_filter("amount_min", "20000")
LOB 레코드에는 많은 데이터 형식이 포함되어 있으며 각각 다른 매개 변수 셰이프 및 쿼리 연산자가 필요할 수 있습니다. 모든 필드에 하나의 필터링 패턴을 적용하면 잘못된 쿼리 또는 잘못된 결과가 발생할 수 있습니다. 지원되는 각 데이터 형식을 적절한 매개 변수 및 연산자에 매핑합니다.
| 데이터 형식 | 연산자 | 매개 변수 패턴 | 예제 |
|---|---|---|---|
| 자유 형식 텍스트 | 포함 또는 LIKE |
매개 변수 1개 | name |
| 제어된 값 | 평등 | 매개 변수 1개 | stage |
| 관련 레코드 | 평등 | 매개 변수 1개 | account_id |
| number | 하한 및 상한 |
*_min, *_max |
amount_min, amount_max |
| 날짜 | 시작 및 끝 경계 |
*_from, *_to |
close_date_from, close_date_to |
하나의 레코드를 찾는 데 사용되는 텍스트 필터의 경우 또는 ContainsLIKE 결과가 확인된 ID가 아닌 후보입니다. 보기 또는 편집 작업 전에 의도된 후보를 안정적인 레코드 ID로 확인합니다.
LOB 쿼리에 추가하기 전에 모든 값의 유효성을 검사하고 서식을 지정합니다. 필터가 손실되거나 일관되지 않은 결과를 생성할 수 있는 여러 도구 호출의 결과를 결합하도록 Copilot에게 요청하는 대신 모든 조건을 하나의 서버 쪽 쿼리로 실행합니다. 신뢰할 수 있는 구조적 목록을 하나 반환합니다.
사용자가 이후 차례에 요청을 구체화할 때 해당 필터를 유지하고 변경된 조건만 추가하거나 바꿉니다.
사용자: "최소 20,000달러 상당의 거래를 보여주세요."
사용자: "이제 성사된 거래만 표시하세요."
get_deals(amount_min="20000", stage="Closed Won")
각 구체화 후 동일한 구조화된 목록 형식을 반환하여 호스트가 결과를 일관되게 렌더링하도록 합니다.
목록 결과 제한 및 캐시
LOB 엔터티에는 수천 개의 레코드가 포함될 수 있으며 해당 API가 느리거나 제한될 수 있습니다. 큰 목록을 반환하면 응답 시간과 페이로드 크기가 증가하는 반면 표시하면 앱 위젯이 과부하되고 Microsoft 365 Copilot에서 너무 많은 공간을 차지합니다.
MCP 서버에 기본 및 최대 결과 제한을 적용하고, 예측 가능한 정렬을 사용하고, 더 많은 레코드를 사용할 수 있는 경우를 나타냅니다. 사용자가 필터를 세부적으로 조정하거나 명시적 Load more 작업을 서버 쪽 페이지 매김으로 뒷받침하도록 허용합니다.
적절한 목록, 메타데이터 및 관련 레코드 결과를 캐시하여 반복되는 LOB API 호출을 줄입니다.
cache = TTLCache(maxsize=200, ttl=120)
items = None if refresh else cache.get(cache_key)
데이터가 변경되는 빈도에 따라 만료 시기를 선택합니다. 캐시 키에 쿼리 및 보안 컨텍스트를 포함하고, 사용자 간에 사용자별 결과를 공유하지 않고, 쓰기 후 영향을 받는 항목을 무효화합니다. 사용자가 새로 고친 데이터 또는 최신 데이터를 요청하면 캐시를 우회하고 LOB API를 호출합니다.
N+1 조회 없이 목록에서 관련 이름 확인
LOB 데이터는 고도로 관련성이 높습니다. 레코드는 종종 계정, 연락처, 소유자 또는 기타 엔터티에 대한 링크를 시스템 ID로 저장하며 상위 계정 또는 관리자 계층 구조와 같은 자체 참조 관계를 포함할 수 있습니다. 그러나 사용자에게 인식 가능한 비즈니스 이름이 필요합니다. 각 ID를 별도의 요청으로 확인하면 목록과 관계가 커짐에 따라 속도가 느려지는 N+1 쿼리 패턴이 생성됩니다.
먼저 LOB API의 관계 프로젝션, 조인 또는 표시 값 기능을 사용하여 원래 쿼리와 관련된 이름을 반환합니다. 지원되지 않는 경우 고유한 외래 키를 수집하고 LOB 시스템의 일괄 처리 연결, 일괄 처리 읽기 또는 IN 쿼리 기능을 사용합니다.
대체 흐름은 다음과 같습니다.
retrieve records → collect unique foreign keys → batch-read related names
구조화된 목록을 반환하기 전에 MCP 서버에서 관련 값을 확인합니다. 이 방법은 행당 조회를 적은 수의 요청으로 대체하고 로드 시간과 제한 위험을 줄입니다.
MCP 서버에서 집계 빌드
LOB 엔터티에는 수십만 개 이상의 레코드가 포함될 수 있습니다. 요약 및 대시보드는 범주, 단계, 소유자 또는 기간에 걸쳐 이 데이터를 집계할 수 있습니다. 모든 기본 레코드를 검색하지 말고 Copilot 또는 앱 위젯에 결과를 계산하도록 요청하세요. MCP 서버에서 LOB 집계 API 또는 그룹화된 쿼리를 사용하고 앱 위젯에 필요한 계산된 데이터만 반환합니다. LOB API가 집계를 지원하지 않는 경우 경계가 있는 페이지가 매겨진 데이터 집합에서 MCP 서버의 결과를 계산하고 사용자에게 scope 명확하게 지정합니다.
레코드를 만들기 전에 관계 해결
사용자는 회사, 연락처, 소유자 또는 부모 계정과 같은 이름으로 관련 레코드를 인식하지만 LOB API에는 사용자가 일반적으로 레코드를 만들거나 업데이트할 때 알지 못하거나 제공하지 못하는 레코드 ID가 필요합니다. 관계 입력에 대해 인식 가능한 이름을 수락한 다음 내부적으로 LOB API에 필요한 레코드 ID로 resolve합니다.
필드에 관련 레코드로 레이블을 지정합니다. 다음과 Company: Contoso 🔗 같은 표시기는 서버가 이름을 확인한다는 것을 강화할 수 있습니다.
사용자가 Save를 선택하면 create API를 호출하기 전에 사용자에게 액세스하고 연결할 수 있는 정확히 하나의 일치하는 레코드로 각 관계를 resolve합니다. 이름이 모호할 때는 첫 번째 일치 항목을 선택하지 않습니다.
"Contoso" → company_id="company_123"
이름이 확인되지 않았거나 모호한 경우 양식과 해당 값을 열어 두고 일치할 가능성이 있는 영구 구조화된 경고를 표시합니다. 사용자가 원하는 레코드를 선택한 다음 안정적인 레코드 ID를 다시 제출하도록 합니다.
최상위 수준isError으로 설정하는 대신 이 수정 가능한 조건 structuredContent 을 반환하여 앱 위젯이 도구 호출을 실패로 처리하지 않고 수정을 요청할 수 있도록 합니다.
업데이트 중 관계 변경 보호
관계 변경은 계정 소유자 변경, 서비스 케이스 재할당, 연락처 이동 등 일반적인 필드 편집보다 비즈니스 영향이 클 수 있습니다.
더 간단한 패턴은 일반적인 편집 양식에서 관계 필드를 읽기 전용으로 유지하는 것입니다.
Company: Contoso 🔗 [read-only]
이 접근 방식을 사용하면 결과적 재할당을 일반 텍스트 편집처럼 보이게 만들지 않고도 레코드의 관계를 이해할 수 있습니다.
관계 변경이 지원되는 경우 전용 도구를 통해 일반 업데이트와 분리되어 유지됩니다.
광범위한 효과가 있는 작업에 전용 도구 사용
일부 비즈니스 작업은 필드를 업데이트하고 전용 LOB API를 포함하는 것 이상의 작업을 수행합니다. CRM 시스템에서 잠재 고객을 변환하면 관련 계정, 연락처 및 기회 레코드가 만들어지고 추가 워크플로 규칙이 호출될 수 있습니다.
다음과 같은 전용 도구를 사용하여 이러한 작업을 표현합니다.
convert_lead(lead_id="lead_123", create_opportunity=true)
전용 도구는 유효성 검사, 관련 레코드 만들기, 워크플로 동작 및 감사 기록을 우회할 수 있는 일반 생성 또는 업데이트 호출을 통해 LOB 시스템의 기본 작업을 재구성하는 대신 호출합니다.
ServiceNow의 네이티브 작업을 통해 인시던트를 해결하는 것은 전용 비즈니스 운영의 또 다른 예입니다.
LOB MCP 앱 빌드 시작
다음 옵션 중 하나를 사용하여 이러한 설계 원칙을 적용합니다.
- 작업 앱 사용자 지정:Microsoft Copilot 에이전트 키트의 에이전트 라이브러리에서 MCP 앱 탭을 열어 Salesforce CRM, ServiceNow ITSM 및 HubSpot CRM용 작업 LOB MCP 앱을 다운로드합니다. 이러한 앱을 함께 사용하면 이 문서의 패턴을 보여 주며 organization의 데이터 모델 및 워크플로에 맞게 조정할 수 있습니다.
- 소스 코드를 탐색합니다. 서버, 앱 위젯 및 배포 원본에 대한 MCP 대화형 UI 샘플 을 검토합니다.
앱을 개발 환경에 연결하고, 이 문서에서 설명하는 환경을 시도하고, 사용자 고유의 LOB 워크플로에 적용합니다.