Setup

AIエージェント(Claude)をMCPで接続する

ネイティブMCPサーバーを通じて、ClaudeなどのAIエージェントをCRMに接続します。エージェントはあなたのAPIキーを使い、安全にレコード(リード、連絡先、商談)を読み取り・作成します。

MCP(Model Context Protocol)は、AIエージェントが外部システムと会話するための標準規格です。Sellioはネイティブなmcpサーバーを提供しており、エージェント(例えばClaude Desktopで動くClaude、またはMCPを話す任意のMCPクライアント)にサーバーのURLを指定するだけで、あなたのCRM内のレコードを照会・作成できます。リードや連絡先を自動で作成するプロスペクティングエージェントに最適です。すべての操作はAPIキーが属するテナントのコンテキストで実行され、CRMのバリデーションと権限(RBAC)が適用されます。

前提条件

MCPクライアント(Claude Desktop、またはHTTP経由でMCPを話す任意のアプリ/エージェント)。
Sellioにおいて、設定→API・開発者向けでAPIキーを発行できる管理者権限。

1) APIキーを発行する

設定→API・開発者向け(サイドバーのショートカットからもアクセスできます)を開きます。
新しいAPIキーを作成し、値をコピーします(sk_で始まり一度しか表示されないため、パスワードと同様に扱ってください)。
同じキーがREST APIとMCPの両方で利用できます。

2) エージェントをMCPサーバーに接続する

MCPサーバーのURLはhttps://YOUR-CRM/api/mcpで、認証はRESTと同じくAuthorization: Bearer sk_...ヘッダーです。

Claude Desktop(および mcp-remote ブリッジを使うクライアント)では、MCPサーバー設定ファイルに以下を追加してください。

例: { "mcpServers": { "sellio-crm": { "command": "npx", "args": ["-y", "mcp-remote", "https://YOUR-CRM/api/mcp", "--header", "Authorization: Bearer sk_live_..."] } } }

💡 リモートのHTTP MCPサーバーを直接サポートしているクライアントであれば、mcp-remoteブリッジを使わずに、上記URLとAuthorization: Bearerヘッダーをそのまま利用できます。

3) エージェントが利用できるツール

list_objects: 利用可能なオブジェクト(リード、連絡先、企業、商談、カスタムオブジェクト)を検出します。
describe_object: オブジェクトのフィールドを調べます。apiName、ラベル、型、必須かどうか、select が受け付ける選択肢、lookup の対象オブジェクトです。作成や更新の前に呼び出してください。
list_records: オブジェクトのレコードを一覧・検索します(検索、フィールドフィルター、並び替え、ページネーション)。
get_record: id でレコードを取得します。
create_record: レコードを作成します(例:新規の見込み客リード)。
update_record: 既存レコードのフィールドを更新します。
delete_record: レコードをゴミ箱に移動します(元に戻せます)。API キーで削除スコープが有効になっている場合のみ動作し、デフォルトでは無効です。
bulk_create_records: 1回の呼び出しで最大500件のレコードを作成し、項目ごとに成功・失敗を報告します。
bulk_update_records: 1回の呼び出しでidにより最大500件のレコードを更新し、項目ごとに成功・失敗を報告します。
export_records: オブジェクトのレコードを、列が安定したフラットな表形式の行として返します。updated_since と created_since により差分同期に対応します。BIツールや自動化ツール向けです。
list_activities: レコードのアクティビティ(タイムライン)、またはワークスペースの最新のアクティビティを一覧します。
create_activity: これから行うタスク、または既に発生した通話・メール・ミーティング・メモを記録します。
update_activity: アクティビティの完了、再オープン、日程変更、担当変更、結果の記録を行います。
delete_activity: アクティビティを削除します。削除スコープが必要です。
list_attachments: レコードに添付されたファイルを一覧します。
get_attachment: 添付ファイルのメタデータと、5分で失効する署名付きダウンロードリンクを返します。
create_attachment_upload_url: アップロードの手順1です。PUT でファイルのバイトを送信するための署名付きURLを返します(最大25MB)。
register_attachment: アップロードの手順2です。アップロード済みファイルをレコードに登録し、タイムラインに表示させます。
delete_attachment: 添付ファイルとそのファイル本体を削除します。元に戻せないため削除スコープが必要です。
list_inventory: 製品ごとの在庫残高、予約数、利用可能数量です。特定の1製品、または最小在庫を下回る製品のみの取得も可能です。
list_line_items: 商談の商品明細行(数量、価格、割引、税)と再計算後の合計です。
add_line_item: 商談に商品明細行を追加します。合計と商談金額は、画面と同じエンジンで再計算されます。
update_line_item: 商品明細行の数量、価格、割引、税、期間、説明を変更します。
delete_line_item: 商談から商品明細行を削除します。
send_marketing_email: 設定済みのプロバイダーを通じてマーケティングメールを1通送信します(宛先、件名、html)。配信停止フッターは自動的に付加されます。

💡 推奨されるエージェントのフロー: list_objects → describe_object(フィールドと必須項目を把握)→ create_record/update_record。フィールドはREST経由でも検出できます: GET /api/v1/objects/{object}。

💡 削除機能は公開されていますが、鍵がかかっています。delete_record、delete_activity、delete_attachment は、API キーで削除スコープが有効になっている場合のみ動作し、デフォルトでは無効です。その他すべてのツールは、REST API と同様に、キーの読み取り専用フラグとオブジェクトスコープに従います。

REST APIとMCPの完全なリファレンス(エンドポイント、パラメータ、エラー形式、レート制限、フィールド検出)については、ヘルプセンター内の記事「開発者リファレンス: REST APIとMCP」を参照してください。

テスト方法

エージェントを接続し、「CRMのオブジェクト一覧を見せて」のように依頼すると、list_objectsを呼び出して一覧を返すはずです。
「Ana Souza(email: ana@acme.com)という名前のリードを作成して」のように依頼すると、エージェントはcreate_recordを呼び出し、新しいレコードのidを返します。
CRM側で、そのレコードがオブジェクトの一覧に表示されていることを確認します。

トラブルシューティング

401 Unauthorized: APIキーが未設定または間違っています。設定→API・開発者向けで新しいキーを発行し、Authorization: Bearer sk_...でエージェントを再設定してください。
エージェントがサーバーを認識しない: URL https://YOUR-CRM/api/mcp を確認し、Claude Desktopの場合はmcpServersブロックが設定ファイルに存在し、アプリを再起動したかを確認してください。
操作が拒否された: MCPはCRMの権限(RBAC)とバリデーションを尊重しており、エラーメッセージにその理由(必須フィールド、権限なし、プラン上限など)が説明されています。
自分のデータしか見えない: これは正常な動作です。各APIキーは所有テナントに隔離されており、エージェントが他社のデータを見ることはありません。

この記事をシステム内で開く →