前提条件
SuiteCRM V8 API は認証にOAuth を使用するため、OAuthClient およびOAuthPassword の認証方法ではカスタムOAuth アプリケーションが必要です。Basic 認証方法でSuiteCRM V4.1 API に接続する場合は、本セクションをスキップできます。 カスタムOAuth アプリケーションはSuiteCRM の管理者が作成・登録する必要があります。SuiteCRM でカスタムOAuth アプリケーションを作成するには、以下の手順に従います:1
管理者クレデンシャルでSuiteCRM アカウントにログインします。
2
Profile ドロップダウンでAdmin > OAuth2 Clients and Tokens を選択します。
3
OAuthClient メソッドの場合はNew Client Credentials Client、OAuthPassword メソッドの場合はNew Password Client をクリックします。
4
アプリケーションのName とSecret を入力し、Save をクリックします。
5
生成されたクライアントID とクライアントシークレットを取得します。これらの値を以下のセットアップ手順でOAuth Client Id とOAuth Client Secret として入力します。
OAuthClient(クライアントクレデンシャル)グラントタイプで認証するユーザーは、API へのフルアクセスを持ちます。OAuthPassword グラントタイプで認証するユーザーは、アクセスする各モジュールまたはテーブルに対する権限が必要です。
セットアップガイド
以下の手順で、SuiteCRM をConnect AI アカウントに接続します:1
Connect AI のナビゲーションメニューからSources ページを開きます。
2
右上の + Add Connection をクリックします。
3
検索フィールドにSuiteCRM と入力し、データソース名をクリックします。
4
新しいコネクションのBasic Settings タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。
5
SuiteCRM アカウントのURL を入力します(例: http://your-suitecrm-instance.com )。
6
SuiteCRM API バージョンに合ったSchema を選択します:SuiteCRM V4.1 API の場合はsuitecrmv4、SuiteCRM V8 API の場合はsuitecrmv8 です。
7
SuiteCRM への接続時に使用するAuth Scheme を選択し、以下の該当するセクションの手順に従います。
認証
- Basic
- OAuthClient
- OAuthPassword
1
Schema がsuitecrmv4 に設定されていることを確認します。Basic 認証方法はSuiteCRM V4.1 API でのみサポートされています。
2
認証ユーザーのId であるUser を入力します。
3
そのユーザーのPassword を入力します。
4
Connect AI Add SuiteCRM Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
詳細について
Connect AI とSuiteCRM の連携の詳細動作については、こちらのページを参照してください。このソースをAI でご利用ください。 クイックスタートの手順に従い、Claude、ChatGPT、Copilot、またはその他のAI クライアントをMCP 経由でこのソースに接続してください。アプリケーションのモデルリクエストを、ガバナンスされた単一のエンドポイント経由でルーティングするには、LLM Gateway を参照してください。Connect AI を初めてご利用になる場合は、Connect AI の無料アカウントを作成し、わずか数分で最初のコネクション設定を完了できます。