接続の確立

The CData Code Assist MCP for Apache Phoenix defines each connection to Apache Phoenix as a named configuration that an MCP Client (such as Claude Desktop) can use when sending natural language queries.

You create and manage these configurations using the CData Code Assist MCP Configuration Tool. The tool automatically handles formatting, storage, and registration with MCP clients.

Understanding Connection Configurations

Each connection configuration is stored in a .mcp file. This file includes the details needed to initialize the connector when an MCP Client starts a session.

On Windows, configuration files are stored in "~/AppData/Roaming/CData/Apache Phoenix Data Provider/".
On macOS, configuration files are stored in "~/Library/Application Support/CData/Apache Phoenix Data Provider/".

The .mcp file is a text file that contains a list of connection properties and a timestamp. For example:

#Tue May 20 15:48:40 EDT 2025
AuthScheme=Basic
User=myUser
Password=myPassword
Security Token=myToken

The configuration tool handles these settings automatically. Each saved configuration enables an MCP client to launch a dedicated MCP server instance with the correct connector and options. Manual file editing is not required.

Apache Phoenix への接続

CData Code Assist MCP for Apache Phoenix はPhoenix Query Server 経由でApache Phoenix に接続します。URL 接続プロパティを設定してApache Phoenix に接続します。

URL プロパティは通常、Apache Phoenix をホストしているサーバーのホスト名またはIP アドレスの後にポートを付けたものになります。例：http://localhost:8765。

Apache Phoenix への認証

デフォルトでは、認証は使用されません（PLAIN）。認証がサーバー用に設定されている場合、以下の認証方法の1つを設定できます。

Basic

If your instance of Apache Phoenix has set up the basic authentication layer, set the following to authenticate:

AuthScheme：Basic に設定。
User：Apache Phoenix インスタンスのユーザーに設定。
Password：Apache Phoenix インスタンスのパスワードに設定。

Azure HDInsight

To authenticate to Azure HDInsight, set the following:

AuthScheme：AzureHDInsight に設定。
User：Set this to the cluster username that you specified when creating the cluster on Azure HDInsight.
Password：Set this to the cluster password that you specified when creating the cluster on Azure HDInsight.
ClusterName：Set this to the name of the cluster containing your Azure HDInsight instance.

すべての呼び出しはゲートウェイに送信され、ゲートウェイはリクエストを処理するノードの1つを選びます。クラスタの内部仮想ネットワーク内で実行している場合は、特定のノードにアクセス可能です。

Kerberos

AuthScheme をNegotiate に設定します。Kerberos で認証する方法についての詳細は、Kerberos の使用を参照してください。