接続の確立

The CData Code Assist MCP for Microsoft Active Directory defines each connection to Microsoft Active Directory 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/Microsoft Active Directory Data Provider/".
On macOS, configuration files are stored in "~/Library/Application Support/CData/Microsoft Active Directory 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.

Microsoft Active Directory への接続

基本接続には、Server およびPort を設定します。さらに、次のように接続を微調整できます。

FollowReferrals：設定すると、本製品は参照サーバーのデータのみをビューとして表示します。参照サーバー上のデータを変更するには、このサーバーをServer およびPort で指定する必要があります。
LDAPVersion：サーバーが実装するプロトコルのバージョンに設定します。デフォルトでは、本製品はversion 2 を使用します。

Microsoft Active Directory への認証

リクエストを認証するには、 User およびPassword プロパティを有効なMicrosoft Active Directory クレデンシャル（例：User をDomain\\BobF またはcn=Bob F,ou=Employees,dc=Domain）に設定します。

本製品は、デフォルトでプレーンテキスト認証を使用します。これは、本製品がサーバーとTLS/SSL のネゴシエーションを試みるためです。 AuthMechanism を使って別の認証方法を指定できます。

TLS/SSL コンフィギュレーションについて詳しくは、SSL の設定を参照してください。

データアクセスのファインチューニング

次のプロパティは、返されるデータのスコープを制御します。

BaseDN は、LDAP 検索の範囲を指定された識別名の高さに限定します。 Note：BaseDN の範囲を絞ることはパフォーマンスを劇的に向上させます。例えば、cn=users,dc=domain の値は、cn=users およびその子に含まれる結果のみを返します。
Scope：このプロパティを使用すると、サブツリーから返されるデータをより細かく制御できます。

テーブルのカスタマイズ

本製品は、Microsoft Active Directory エンティティから最も頻繁に必要とされるカラムを表示します。ただし、その他のデータを使用する必要がある場合は、テーブルを簡単に変更できます。テーブルは、シンプルな形式のスキーマファイルで定義されます。

デフォルトのスキーマを拡張する方法や独自のスキーマを記述する方法については、Active Directory テーブルとの連携を参照してください。カスタムスキーマを使用するには、Location プロパティをスキーマファイルを有するフォルダに設定します。