Salesforce - API Context

Salesforce 공식 Hosted MCP 서버의 API Context 서버와 연결하여 Salesforce Metadata API 및 Tooling API 사용에 필요한 컨텍스트 정보를 조회할 수 있습니다.

주요 기능

• Data API 및 Tooling API 컨텍스트 조회
• 메타데이터 타입, 섹션, 필드 정보 조회
• 메타데이터 타입 검색
• API 작업에 필요한 구조 정보 탐색

기본 정보

인증 방식

Salesforce OAuth 인증을 사용합니다.

입력 파라미터

• consumerKey (필수): Salesforce External Client App(ECA)의 Consumer Key
• consumerSecret (필수): Salesforce External Client App(ECA)의 Consumer Secret
• useSandbox (선택): Salesforce Sandbox 환경에 연결할지 여부

Salesforce 설정 방법

이 Integration을 사용하려면 Salesforce External Client App(ECA) 설정과 Hosted MCP 서버 활성화가 필요합니다.

1. Salesforce 공식 가이드 에 따라 External Client App을 생성합니다.
2. AIP OAuth 설정 화면에 표시되는 Callback URL을 External Client App의 Callback URL로 등록합니다.
3. 생성한 External Client App의 Consumer Key와 Consumer Secret을 AIP의 consumerKey, consumerSecret 필드에 입력합니다.
4. Salesforce Setup → API Catalog → MCP Servers에서 salesforce-api-context 서버를 Activate합니다. 자세한 내용은 Salesforce MCP 서버 활성화 가이드 를 참고하세요.

지원하는 MCP 도구

API Context 도구

search_metadata_types

메타데이터 타입을 검색합니다.

get_metadata_type_sections

특정 메타데이터 타입에서 사용할 수 있는 섹션 정보를 조회합니다.

get_metadata_type_fields_properties

특정 메타데이터 타입 필드의 속성 정보를 조회합니다.

get_metadata_type_fields

특정 메타데이터 타입의 필드 목록을 조회합니다.

get_metadata_type_context

특정 메타데이터 타입의 컨텍스트 정보를 조회합니다.

get_data_and_tooling_api_context

Salesforce Data API 및 Tooling API 사용을 위한 컨텍스트 정보를 조회합니다.

사용 예시

예를 들어,

• Prompt로 “Flow 메타데이터 타입에서 사용할 수 있는 필드를 알려줘”라고 입력하면,
• LLM은 MCP를 통해 get_metadata_type_fields 도구를 호출합니다.
• Tool 호출 결과를 기반으로 채팅에서 응답합니다.

그 외 사용 예시:

• “Tooling API 컨텍스트를 확인해줘”
• “사용 가능한 메타데이터 타입을 검색해줘”
• “특정 메타데이터 필드의 속성을 알려줘”

주의사항

• 조회 가능한 메타데이터 정보는 Salesforce 권한에 따라 달라집니다.
• 이 서버는 API 작업을 위한 컨텍스트 조회에 초점을 둡니다.