F-revo CRM MCP サーバー アイコン
AI × CRM ツール ・ 無料 / オープンソース

F-revo CRM MCP サーバー

F-revoCRM（vtiger）を、Claude などのAIから自然言語で操作。
「顧客を検索」「商談を登録」を、あなたの権限の範囲で安全に実行できます。

モジュールをダウンロードfrevo-mcp-v1.0.0.zip GitHub でソースを見る
F-revoCRM / vtiger 7MCP 対応OAuth 2.1Vtiger Public Licensev1.0.0料金 0円
OVERVIEW

これは何？

オープンソースCRM「F-revoCRM（vtiger）」を、Model Context Protocol（MCP）という仕組みで AIアシスタント「Claude」につなぐモジュールです。Claude に「先月の商談を一覧して」「サンプル商事に電話メモを追加して」と頼むと、AIがそれをCRMの操作に変換して実行します。

操作は常に ログインユーザーの権限（ロール・プロファイル・共有設定）の範囲内。見えないデータは見えませんし、変更は履歴に残り、削除はゴミ箱（論理削除）です。MCPは、AIが外部ツールを安全に呼び出すための標準規格で、Claude Code ／ Claude Desktop ／ claude.ai（Web） から接続できます。

FEATURES

特徴

8つのCRM操作ツール

モジュール一覧 / 項目定義の取得 / 検索 / 取得 / 作成 / 更新 / 削除（ゴミ箱）/ ユーザー一覧。問い合わせから集計まで自然言語で。

権限の範囲で安全

vtigerのWebサービス層を通すため、ログインユーザーの権限・共有設定をそのまま尊重。AIが越権操作することはありません。

2つの認証方式

固定Bearerトークン（Claude Code / Desktop 向け）と、OAuth 2.1 + PKCE / DCR（claude.ai Web 向け）。併用できます。

変更履歴＆ゴミ箱

作成・更新・削除は変更履歴（modtracker）に自動記録。削除は論理削除で、CRM画面からいつでも復元できます。

管理画面でトークン管理

「設定 > MCPトークン管理」から、トークンの発行・一覧・無効化が可能。誰がどの権限で繋いでいるかを管理できます。

AIへの使い方ガイド内蔵

接続時にAIへ「参照フィールドにはレコードIDを入れて関連付ける」等のヒントを自動提示。AIが正しく操作しやすい設計です。

REQUIREMENTS

動作環境

対応CRMF-revoCRM / vtiger 7.x
サーバーPHP 8.x（mysqli / PDO）
必須HTTPS（OAuth 認証に必須）
対応クライアントClaude Code ／ Claude Desktop ／ claude.ai（Web）
料金無料
ライセンスVtiger Public License 1.2（オープンソース／F-revo・vtiger本体と同一）
SETUP

導入手順

お使いの F-revoCRM サーバーに設置して使う、自己ホスト型のモジュールです。詳細は同梱の README を参照してください。

  1. ファイルを配置

    ダウンロードした frevo-mcp-v1.0.0.zip を展開し、F-revo のルートに同じ相対パスで配置します（include/Mcp/・public/mcp.php・public/mcp-oauth/・トークン管理画面など）。

  2. テーブルを作成

    php public/mcp-oauth/install.php          # OAuth 用テーブル
php modules/Settings/MCPTokens/install.php # トークン表＋設定メニュー

  3. .htaccess を設定（共有ホスティング対策）

    Authorization ヘッダを PHP に渡すため、公開ディレクトリの .htaccess に追記します。

    SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

    OAuth 用の CSP／.well-known 配信は同梱の .htaccess で対応します（環境により設定方法あり。README参照）。

  4. トークンを発行

    管理画面「設定 > MCPトークン管理」からトークンを発行します（発行時のみ平文が表示されます）。

  5. クライアントから接続

    Claude Code

    claude mcp add --transport http frevo-crm \
  https://<あなたのCRM>/mcp.php \
  --header "Authorization: Bearer <発行したトークン>"

    claude.ai（Web） カスタムコネクタに https://<あなたのCRM>/mcp.php を追加 → F-revo にログインして認可（OAuth）。

FAQ

よくある質問

料金はかかりますか？

無料です。Vtiger Public License 1.2（F-revo・vtiger 本体と同一ライセンス）のオープンソースとして公開しています。

どの Claude で使えますか？

Claude Code・Claude Desktop（Bearerトークン）と、claude.ai（Web、OAuth 2.1）に対応しています。

AIに勝手に操作されたり、情報が漏れたりしませんか？

操作はすべて認証ユーザーの権限の範囲内に限られます。削除はゴミ箱（復元可）、変更は履歴に記録。処理はあなたの F-revo サーバー内で完結し、CRMデータが外部に送信されることはありません。

導入を手伝ってもらえますか？

はい。設置や設定のご相談は お問い合わせ からどうぞ。F-revoCRM の導入・カスタマイズも承ります。

DOWNLOAD

導入してみる

無料・オープンソース。お使いの F-revoCRM に設置して、AIからの操作を試せます。

モジュールをダウンロード GitHub でソースを見る