SmartAgent CRM

---

これは何ですか？

SmartAgent は、不動産会社向けに特化して構築された CRM です。不動産仲介の日常業務である、問い合わせリード、エージェントのタスク、営業パイプライン、物件情報と不動産ポータルへの掲載、顧客メモ、保存した検索条件、チーム管理を扱います。

対象者についての注意： SmartAgent はロシア語の製品で、ロシアおよびCISの不動産会社にサービスを提供しています。CRM のインターフェース、ツールの説明、返されるデータはロシア語です。MCP カタログとクライアントは国際的なものなので、この README は英語で記載されていますが、SmartAgent をご利用でない場合、このサーバーは役に立ちません。

このリポジトリでは、SmartAgent のMCP（Model Context Protocol）サーバーマニフェストを公開しています。このサーバーを使うと、Claude Desktop、Claude Code、ご自身のエージェントなど、MCP 互換の AI アシスタントがユーザーに代わって CRM データの参照や操作を行えます。リードの検索、タスクの作成、パイプライン内の案件の移動、物件情報の検索、メモの追加などができます。

接続後、アシスタントには次のようなことを依頼できます。

• 「今週入ったリードのうち、まだ誰も電話していないものは？」
• 「この案件について、明日のフォローアップタスクを作成し、電話についてのメモを残して。」
• 「この地区で、価格が1,500万未満の2LDKの物件を見せて。」
• 「『内覧予定』のステージに10日以上とどまっている案件は？」

このリポジトリには、公開マニフェスト、アイコン、ドキュメントのみが含まれています。 CRM と MCP サーバーの実装はクローズドソースであり、ここでは公開されていません。

サーバーの詳細

エンドポイント	https://mcp.smartagent.ru/
トランスポート	Streamable HTTP（MCP リビジョン 2025-06-18）
認証	API キーをヘッダーで送信
利用可能なツール	200+
ホスティング	SmartAgent による完全ホスティング — インストールやセルフホストは不要
アクセス	SmartAgent の法人プランのみ

アクセスと制限

MCP アクセスは SmartAgent の法人プランに含まれています。トライアル、無料、または通常プランで発行されたキーは 403 で拒否されます。

制限	値
リクエスト	1分あたり60件、1時間あたり1,000件、1日あたり5,000件（会社単位）
返される物件レコード	1日あたり50,000件（会社単位）
物件所有者の電話番号	ご利用プランの電話番号開示上限の範囲内

法人プランをご希望の場合は、お問い合わせください（サポートと連絡先を参照）。

API キーの取得

1. SmartAgent アカウントに smartagent.ru からログインします（会社が法人プランを利用している必要があります）。
2. CRM で Menu → API keys を開きます。
3. キーを作成してコピーします。sa_mcp_ の後に64桁の16進数が続く形式です。

キーには、そのキーが属するアカウントの権限が適用され、会社の CRM データにアクセスできます。パスワードと同様に取り扱ってください。リポジトリにコミットしたり、共有チャットに貼り付けたりしないでください。漏えいした場合は、同じ画面でキーを無効にしてください。

MCP クライアントの接続

サーバーはリモートサーバーなので、インストールは不要です。クライアントの接続先に URL を指定し、Authorization ヘッダーにキーを渡します。

Claude Desktop / Claude Code

MCP クライアントの設定に以下を追加してください（Claude Desktop の場合は claude_desktop_config.json）。

{
  "mcpServers": {
    "smartagent": {
      "type": "http",
      "url": "https://mcp.smartagent.ru/",
      "headers": {
        "Authorization": "Bearer sa_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

その後、クライアントを再起動してください。SmartAgent のツールがツール一覧に表示されます。

リモートサーバーにネイティブ対応していないクライアント

クライアントがローカル（stdio）サーバーしか起動できない場合は、mcp-remote を使ってリモートエンドポイントに接続します。

{
  "mcpServers": {
    "smartagent": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.smartagent.ru/",
        "--header", "Authorization: Bearer sa_mcp_YOUR_KEY_HERE"
      ]
    }
  }
}

認証に関する注意事項

API キーは、次のいずれかの形式で受け付けられます。

ヘッダー	値
Authorization	Bearer sa_mcp_...
Authorization	sa_mcp_...（Bearer プレフィックスは省略可能です）
X-Api-Key	sa_mcp_...

クライアントが対応している形式を使用してください。推奨されるデフォルトは Authorization: Bearer ... です。

ツールの対象範囲

200 以上のツールが、操作対象となる CRM エンティティごとに分類されています。

カテゴリ	対象範囲
リード	新規のリードとクライアント — 検索、読み取り、作成、更新、割り当て、ステータスの追跡
タスク	エージェントのタスクとリマインダー — 作成、スケジュール変更、完了、担当者と期限による絞り込み
営業パイプライン	取引とそのステージ — ファネルに沿った取引の移動、ステージ履歴の確認
物件掲載情報	不動産物件とその広告 — データベースの検索、詳細の読み取り、掲載の管理
メモと添付ファイル	リード、取引、掲載情報に紐づくコメント、通話メモ、ファイル
保存済み検索	CRM に保存され、物件データベースと照合されるクライアントの検索リクエスト
タグとラベル	会社独自のラベルを使ったレコードの分類と絞り込み
建物と通話	建物・複合施設の検索、およびリードに紐づく通話記録
広告プラットフォーム	分類ポータル（Avito、CIAN など）に掲載情報を公開・配信するための設定
レポート	集計された CRM レポート（例：掲載情報に関する競合件数）
会社と従業員	会社プロフィール、チームメンバー、役割、割り当て

ツール名とパラメーターは、MCP クライアントが tools/list を通じて自動的に検出するため、覚えておく必要はありません。各ツールの説明は、CRM 独自の用語に合わせてロシア語で記載されています。

セキュリティとプライバシー

• アクセス範囲は API キーを発行したアカウントに限定されます。アシスタントには、お客様の会社のデータのみが表示されます。
• キーは、メニュー → API キーからいつでも取り消せます。
• データの取り扱いについては、当社の**プライバシーポリシー**をご確認ください。
• キーを渡すのは、信頼できる AI クライアントのみにしてください。このキーを持つアシスタントは、CRM レコードを読み取るだけでなく、変更することもできます。

サポートとお問い合わせ

ロシア語と英語で対応しています。

チャネル
🌐 ウェブサイト	smartagent.ru
✉️ メール	[email protected]
☎️ 電話	+7 (495) 988-93-91
💬 WhatsApp	+7 (495) 988-93-91
✈️ Telegram サポートボット	@SmartAgentSupportBot
📣 Telegram チャンネル	@SmartAgent_ru
🅜 MAX サポートボット	max.ru/id7725737972_bot

MCP サーバーのバグを見つけた場合や、まだ存在しないツールをご希望の場合は、このリポジトリで issue を作成するか、[email protected] までご連絡ください。

ライセンス

このリポジトリの内容（マニフェスト、アイコン、ドキュメント）は、MIT ライセンスの下で公開されています。SmartAgent CRM と MCP サーバーの実装自体はプロプライエタリであり、このライセンスの対象ではありません。

---