MCP コネクタ

Model Context Protocol（MCP）コネクタを使用すると、Integration Connectors で MCP 接続を作成して構成できます。この接続は、ビジネスアプリケーションで使用して、データを安全に交換し、MCP でオペレーションを実行できます。

サポートされているエンティティとオペレーションのリストについては、エンティティオペレーションの例をご覧ください。サポートされているコネクタ固有のアクションについては、アクションをご覧ください。

MCP コネクタのバージョン

MCP コネクタは次の 2 つのバージョンをサポートしています。

MCP v1: このコネクタバージョンを使用して、MCP v1 API にアクセスします。
MCP v2: このコネクタバージョンを使用して、MCP v2 API にアクセスします。

MCP 接続の作成については、MCP コネクタを作成して構成するをご覧ください。

エンティティ、オペレーション、アクション

すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。

エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベースコネクタでは、テーブルがエンティティであり、ファイルサーバーコネクタでは、フォルダがエンティティです。また、メッセージングシステムコネクタでは、キューがエンティティです。
ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、Entities リストは空になります。
オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
- リスト
- 取得
- 作成
- 更新
- 削除
使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティオペレーションをご覧ください。ただし、コネクタがいずれかのエンティティオペレーションをサポートしていない場合、サポートされていないオペレーションは Operations リストに含まれません。
アクション: コネクタインターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、Actions リストが空になります。

サポートされているエンティティとオペレーション

MCP コネクタはエンティティとオペレーションをサポートしています。利用可能なエンティティとオペレーションは、MCP を介して接続されているツールによって異なります。

エンティティオペレーションの例

このセクションでは、さまざまなツールのエンティティオペレーションの例を示します。

Jira の問題エンティティを一覧表示する

この例では、Jira MCP 接続を使用して、問題エンティティ内のすべての問題を一覧表示します。

[コネクタタスクを設定] ウィンドウで、[エンティティ] をクリックします。
[Entity] リストから [Issues] を選択します。
[List] オペレーションを選択し、[完了] をクリックします。

[コネクタ] タスクの [タスク入力] セクションで、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": ""
    }

すべてのリクエストを一覧表示する

この例では、リクエスト エンティティ内のすべてのリクエストを一覧表示します。

[コネクタタスクを設定] ウィンドウで、[エンティティ] をクリックします。
[Entity] リストから [Requests] を選択します。
[List] オペレーションを選択し、[完了] をクリックします。

ID でユーザーを取得する

この例では、Users エンティティから AccountId が `6035864ce2020c0070b5285b` のユーザーを取得します。`AccountId` は、Users エンティティの主キーです。特定のエンティティを取得するには、主キーに filterClause を指定して List オペレーションを使用します。このエンティティでは Get オペレーションはサポートされていません。

[コネクタタスクを設定] ウィンドウで、[エンティティ] をクリックします。
[Entity] リストから [Users] を選択します。
[List] オペレーションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで [filterClause] をクリックし、[デフォルト値] フィールドに「AccountId=6035864ce2020c0070b5285b」と入力します。

操作

MCP コネクタはさまざまなアクションを提供します。利用可能なアクションは、MCP を介して接続されたツールによって異なります。

アクションの例

このセクションでは、さまざまなツールで MCP コネクタを使用して実行できるアクションの一部について説明します。

Jira アクション: 問題を取得する

この例では、Jira 用に構成された MCP 接続を使用して Jira の問題を一覧表示する方法を示します。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[get_issues] アクションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、[デフォルト値] フィールドに次のような値を入力します。
```
  {
    "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
  }
```

Linear アクション: 問題を一覧表示する

この例では、Linear 用に構成された MCP 接続を使用して Linear の問題を一覧表示する方法を示します。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[list_issues] アクションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、[デフォルト値] フィールドに次のような値を入力します。
```
  {
    "limit": 50
  }
```

Sentry アクション: Whoami

この例では、Sentry 用に構成された MCP 接続を使用して Sentry からユーザー情報を取得する方法を示します。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[whoami] アクションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、[デフォルト値] フィールドに次のような値を入力します。
```
  {
    "name": "example-org"
  }
```

組織を検索する

この例では、Sentry 用に構成された MCP 接続を使用して Sentry で組織を見つける方法を示します。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[find_organizations] アクションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、[デフォルト値] フィールドに次のような値を入力します。
```
  {}
```

Intercom アクション: 会話を検索する

この例では、Intercom 用に構成された MCP 接続を使用して、Intercom で会話の詳細を検索する方法を示します。

[Configure connector task] ダイアログで、[アクション] をクリックします。
[検索] アクションを選択し、[完了] をクリックします。
[コネクタ] タスクの [タスク入力] セクションで、connectorInputPayload をクリックし、[デフォルト値] フィールドに次のような値を入力します。
```
  {
    "query": "object_type:conversations state:open created_at:gt:2024-01-01"
  }
```

システムの上限

MCP コネクタには、接続する特定のツールによって異なるシステム制限があります。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。

Integration Connectors に適用される上限の詳細については、上限をご覧ください。

注: Integration Connectors ノードの数は、使用状況に応じて動的に自動スケーリングされます。ただし、自動スケーリングを待たずに大量の容量を確保する場合は、接続の最小ノード値を調整できます。1 つの接続により多くのトランザクションを処理するには、より多くのノードが必要です。逆に、接続が処理するトランザクションが少ない場合は、必要なノードの数が少なくなります。ノードの値を構成するには、次の手順を行います。

従量課金制をご利用のお客様は、接続の編集ページでノードの最小値と最大値を構成します。
サブスクリプションベースで利用されているお客様は、サポートにお問い合わせください。

ノードが処理できる最大トランザクションは、さまざまな要因によって異なります。そのため、スループットを高めるために最小ノードを調整する前に、バックエンドシステムが必要なトラフィックを処理するために最適に設定されているかどうかを確認することをおすすめします。