프리뷰

이 제품이나 기능에는 서비스별 약관이 적용됩니다. GA 이전 제품과 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참고하세요.

MCP 커넥터

모델 컨텍스트 프로토콜 (MCP) 커넥터를 사용하면 Integration Connectors에서 MCP 연결을 만들고 구성할 수 있습니다. 비즈니스 애플리케이션에서 이 연결을 사용하여 MCP와 데이터를 안전하게 교환하고 작업을 실행할 수 있습니다.

지원되는 항목 및 작업 목록은 항목 작업 예시를 참고하세요. 지원되는 커넥터별 작업에 대한 자세한 내용은 작업을 참고하세요.

Integration Connectors의 모든 연결은 기본 서비스 객체에 대한 추상화 레이어를 제공합니다. 이러한 객체는 관리 가능한 엔티티로 노출되므로 표준 작업을 실행하거나 커넥터별 작업을 사용할 수 있습니다.

MCP 커넥터 버전

MCP 커넥터는 다음 두 가지 버전을 지원합니다.

• MCP v1: 이 커넥터 버전을 사용하여 MCP v1 API에 액세스합니다.
• MCP v2: 이 커넥터 버전을 사용하여 MCP v2 API에 액세스합니다.

MCP 연결을 만드는 방법은 MCP 커넥터 만들기 및 구성을 참고하세요.

항목, 작업, 조치

모든 Integration Connectors는 연결된 애플리케이션의 객체에 대한 추상화 레이어를 제공합니다. 이 추상화를 통해서만 애플리케이션의 객체에 액세스할 수 있습니다. 추상화는 항목, 작업, 조치로 노출됩니다.

참고: 커넥터 태스크에서 커넥터의 항목, 작업, 조치를 볼 수 있습니다.

• 항목: 연결된 애플리케이션 또는 서비스에서 항목은 객체 또는 속성 모음으로 간주될 수 있습니다. 항목의 정의는 커넥터마다 다릅니다. 예를 들어 데이터베이스 커넥터에서는 테이블이 항목이고, 파일 서버 커넥터에서는 폴더가 항목이며 메시징 시스템 커넥터에서는 큐가 항목입니다.

  그러나 커넥터가 항목을 지원하지 않거나 항목을 포함하지 않을 수 있으며, 이 경우 Entities 목록이 비어 있습니다.

• 작업: 작업은 항목에 대해 수행할 수 있는 활동입니다. 항목에서 다음 작업을 수행할 수 있습니다.
  • 목록
  • 가져오기
  • 만들기
  • 업데이트
  • 삭제

  사용 가능한 목록에서 항목을 선택하면 항목에 사용 가능한 작업 목록이 생성됩니다. 작업에 대한 자세한 설명은 커넥터 태스크의 항목 작업을 참조하세요. 그러나 커넥터가 항목 작업을 지원하지 않으면 이렇게 지원되지 않는 작업은 Operations 목록에 나열되지 않습니다.

• 조치: 커넥터 인터페이스를 통해 통합에 제공되는 첫 번째 클래스 함수입니다. 조치를 사용하면 항목을 변경할 수 있습니다. 조치는 커넥터마다 다릅니다. 일반적으로 조치에는 입력 매개변수와 출력 매개변수가 있습니다. 하지만 커넥터가 조치를 지원하지 않을 수 있으며 이 경우 Actions 목록이 비어 있습니다.

참고: 모든 항목 및 조치에는 연결된 스키마가 있습니다. 예를 들어 조치 스키마에는 매개변수 이름 및 해당 데이터 유형과 같은 매개변수 세부정보가 있습니다. 항목 및 조치의 스키마(메타데이터)는 백엔드에서 런타임 시 연결을 통해 가져옵니다. 스키마에 대한 업데이트가 있다면 이러한 업데이트는 기존 연결에 자동으로 반영되지 않습니다. 스키마를 수동으로 새로고침해야 합니다. 연결의 스키마를 새로고침하려면 연결의 연결 세부정보 페이지를 연 다음 연결 스키마 새로고침을 클릭합니다.

지원되는 항목 및 작업

MCP 커넥터는 항목과 작업을 지원하며, MCP를 통해 연결된 도구에 따라 사용 가능한 항목과 작업이 달라집니다.

항목 작업 예시

이 섹션에서는 다양한 도구의 항목 작업 예를 제공합니다.

Jira 문제 항목 나열

이 예시에서는 Jira MCP 연결을 사용하여 문제 항목의 모든 문제를 나열합니다.

1. 커넥터 태스크 구성 창에서 항목을 클릭합니다.
2. 항목 목록에서 문제를 선택합니다.
3. 목록 작업을 선택한 후 완료를 클릭합니다.
4. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

모든 요청 나열

이 예시에서는 Requests 항목의 모든 Requests를 나열합니다.

1. 커넥터 태스크 구성 창에서 항목을 클릭합니다.
2. 엔티티 목록에서 요청을 선택합니다.
3. 목록 작업을 선택한 후 완료를 클릭합니다.

ID로 사용자 가져오기

이 예시에서는 Users 항목에서 AccountId가 `6035864ce2020c0070b5285b` 인 사용자를 가져옵니다. AccountId는 Users 항목의 기본 키입니다. 특정 항목을 가져오려면 기본 키에 filterClause를 사용하여 나열 작업을 사용하세요. 이 항목에는 가져오기 작업이 지원되지 않습니다.

1. 커넥터 태스크 구성 창에서 항목을 클릭합니다.
2. 항목 목록에서 사용자를 선택합니다.
3. 목록 작업을 선택한 후 완료를 클릭합니다.
4. 커넥터 태스크의 태스크 입력 섹션에서 filterClause를 클릭한 다음 기본값 필드에 `AccountId`=6035864ce2020c0070b5285b를 입력합니다.

작업

MCP 커넥터는 다양한 작업을 제공하며, 사용 가능한 작업은 MCP를 통해 연결된 도구에 따라 다릅니다.

작업 예시

이 섹션에서는 다양한 도구의 MCP 커넥터를 통해 사용할 수 있는 일부 작업을 수행하는 방법을 설명합니다.

Jira 작업: 문제 가져오기

이 예시에서는 Jira용으로 구성된 MCP 연결을 사용하여 Jira 문제를 나열하는 방법을 보여줍니다.

1. 커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
2. get_issues 작업을 선택한 다음 완료를 클릭합니다.
3. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Linear 작업: 문제 목록

이 예시에서는 Linear용으로 구성된 MCP 연결을 사용하여 Linear의 문제를 나열하는 방법을 보여줍니다.

1. 커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
2. list_issues 작업을 선택한 후 완료를 클릭합니다.
3. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

     {
       "limit": 50
     }

Sentry Actions: Whoami

이 예시에서는 Sentry용으로 구성된 MCP 연결을 사용하여 Sentry에서 사용자 정보를 가져오는 방법을 보여줍니다.

1. 커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
2. whoami 작업을 선택한 다음 완료를 클릭합니다.
3. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

     {
       "name": "example-org"
     }

조직 찾기

이 예시에서는 Sentry용으로 구성된 MCP 연결을 사용하여 Sentry에서 조직을 찾는 방법을 보여줍니다.

1. 커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
2. find_organizations 작업을 선택한 후 완료를 클릭합니다.
3. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

     {}

인터콤 작업: 대화 검색

이 예에서는 Intercom용으로 구성된 MCP 연결을 사용하여 Intercom에서 대화 세부정보를 검색하는 방법을 보여줍니다.

1. 커넥터 태스크 구성 대화상자에서 작업을 클릭합니다.
2. 검색 작업을 선택한 다음 완료를 클릭합니다.
3. 커넥터 태스크의 태스크 입력 섹션에서 connectorInputPayload를 클릭한 후 기본값 필드에 다음과 유사한 값을 입력합니다.

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

시스템 제한사항

MCP 커넥터에는 연결되는 특정 도구에 따라 달라질 수 있는 시스템 제한사항이 있습니다. 기본적으로 Integration Connectors는 가용성을 높이기 위해 연결에 2개의 노드를 할당합니다.

Integration Connectors에 적용되는 한도에 대한 자세한 내용은 한도를 참조하세요.

참고: Integration Connectors 노드 수는 사용량에 따라 동적으로 자동 확장됩니다. 하지만 자동 확장을 기다리지 않고 대용량을 예약하려면 연결의 최소 노드 값을 조정하면 됩니다. 연결에 대해 더 많은 트랜잭션을 처리하려면 더 많은 노드가 필요합니다. 이와 반대로 더 적은 트랜잭션을 처리하려면 더 적은 노드가 필요합니다. 노드 값을 구성하려면 다음 안내를 따르세요.

• 사용한 만큼만 지불 고객인 경우 연결 수정 페이지에서 최소 및 최대 노드 값을 구성합니다.
• 정기 결제 기반 고객인 경우 지원팀에 문의하세요.

노드에서 처리할 수 있는 최대 트랜잭션은 다양한 요소에 따라 달라집니다. 따라서 처리량을 늘리기 위해 최소 노드를 조정하기 전에 백엔드 시스템이 필요한 트래픽을 처리하도록 최적으로 설정되었는지 확인하는 것이 좋습니다.