LocalTry AI CRM

LocalTry MCP

各事業者を厳密に分離したまま、ChatGPT やその他の MCP クライアントから LocalTry を利用できます。

LocalTry MCP は、平易な指示で LocalTry CRM を操作するためのリモート Model Context Protocol サーバーです。Cloudflare Workers 上で動作し、OAuth 2.1 を使用します。すべての接続は、検証済みの 1 人の LocalTry ユーザー、事業者、役割、権限セットに紐づけられます。

できること

• 顧客、企業、連絡先、リード、案件、見積もり、請求書を検索します。
• 検証済みの CRM レコードを作成、更新します。
• テナント所有の AI エージェントを作成し、Flow Studio で利用できるようにします。
• テナントのワークスペースアーキテクチャ全体を確認します。
• 登録済みのすべてのページ、アクション、エージェント、連携、テナント追加項目を検索します。
• LocalTry Builder を通じて、テナント専用のワークスペースカスタマイズを申請します。
• 保存済みのワークフローを実行します。
• LocalTry Command に複数ステップの業務操作を依頼します。
• カスタマイズのバージョンを確認し、以前のバージョンに戻します。
• テナントに限定されたアクティビティと監査履歴を確認します。

利用可能なツール

ツール	用途
get_workspace_overview	接続中の事業者のページ、モジュール、フィールド、ワークフロー、連携、カスタマイズ履歴を確認します。
search_localtry_features	操作を実行する前に、登録済みの LocalTry のページ、アクション、エージェント、連携、テナント追加項目を正確に検索します。
search_crm	生の SQL を公開せずに、テナントに限定された CRM レコードを検索します。
create_or_update_crm_record	検証済みの CRM レコードを作成または更新します。
create_workflow_agent	Flow Studio のワークフローで使うテナント所有の AI エージェントを記述して保存します。
request_workspace_customization	［ワークスペースをカスタマイズ］プロンプトと同じ、テナントに限定されたエンジニアリング依頼を送信します。
get_workspace_customization_status	最新のカスタマイズに関する会話、進捗、質問、結果を確認します。
list_workspace_versions	ワークスペースのカスタマイズ履歴を確認します。
restore_workspace_version	接続中のワークスペースを、承認済みの以前のバージョンに戻します。
run_workflow	事業者の保存済みワークフローのいずれかを実行します。
run_social_research	公開ソーシャルメディアまたはウェブの調査検索を 1 件開始し、接続中のワークスペースに保存します。
run_localtry_command	LocalTry Command を使用して、検証済みの複数ステップにわたる CRM および業務操作を実行します。
get_recent_activity	最近の CRM、ワークフロー、カスタマイズのアクティビティを確認します。

テナントの境界

共有 MCP サービスは 1 つですが、すべての認証は論理的に分離されています。 クライアントがテナント ID を指定または変更することはできません。

MCP client
  -> LocalTry OAuth consent
  -> token bound to user + business + role + scopes
  -> LocalTry MCP Worker
  -> private Cloudflare service binding
  -> LocalTry domain services
  -> business-scoped data and workspace runtime

MCP Worker はデータベースバインディングを受け取りません。LocalTry へのアクセスは、 docs/localtry-bridge-contract.md に記載された非公開のサービスコントラクトを通じてのみ可能です。

リモートエンドポイント

本番環境のエンドポイントは稼働中です。

https://mcp.localtry.com/mcp

ヘルスチェック：

https://mcp.localtry.com/health

クライアントは OAuth 2.1 メタデータを自動的に検出します。認証では、PKCE、動的クライアント登録、有効期間の短いアクセストークン、リフレッシュトークンがサポートされています。ユーザーは LocalTry にサインインして、画面に表示された 1 つのワークスペースを承認します。LocalTry API キーを MCP クライアントにコピーする必要はありません。

ローカル開発

必要なもの：Node.js 20 以降、および Cloudflare アカウント。

npm install
npm run types
npm run check
npm run dev

OAuth KV 名前空間を作成し、wrangler.jsonc のプレースホルダーの名前空間 ID を置き換えます。

npx wrangler kv namespace create OAUTH_KV

LOCALTRY_API サービスバインディングは、LocalTry CRM のデプロイでエクスポートされる、名前付きの LocalTryMcpBridge WorkerEntrypoint を参照する必要があります。

信頼境界の詳細については、ブリッジコントラクトを参照してください。

ChatGPT

ChatGPT は、開発者モードを通じてリモート MCP アプリをサポートしています。接続フローと現在のプラン要件については、docs/chatgpt.md をご覧ください。プライベートなカスタムアプリを作成すると、このサーバーが ChatGPT アカウントまたはワークスペースに接続されます。ChatGPT の公開アプリディレクトリへの掲載には、別途 OpenAI による審査が必要です。

非公開情報を含まない公開審査用の掲載情報、開始用プロンプト、テストケース、リリースノートは、docs/openai-submission.md で管理されています。

設計原則

• 生の SQL ツールは用意しません。
• テナント ID をツールの引数にしません。
• シークレットを読み取るツールは用意しません。
• API 全体をそのまま反映するのではなく、目標指向のツールを用意します。
• ワークスペースに重大な変更を加える場合は、明示的な承認を必要とします。
• バージョン管理、監査イベント、復元をサポートします。
• MCP Worker と CRM ドメインレイヤーの両方で権限を確認します。

ステータス

本番環境は mcp.localtry.com にデプロイされています。OAuth 認可、リフレッシュトークン、MCP の初期化、ツールの検出、テナントの紐付け、実際のワークスペースの読み取りをエンドツーエンドで検証済みです。公開 Worker が CRM にアクセスするのは、プライベートな Cloudflare サービスバインディングを介した場合のみで、データベースバインディングはありません。

ライセンス

MIT