LocalTry MCP

LocalTry を ChatGPT やその他の MCP クライアントから利用し、すべてのビジネスを厳密に分離したままにします。

LocalTry MCP は、平易な言葉の指示で LocalTry CRM を操作するためのリモート Model Context Protocol サーバーです。Cloudflare Workers 上で動作し、OAuth 2.1 を使用し、各接続を検証済みの 1 つの LocalTry ユーザー、ビジネス、ロール、権限セットにバインドします。

できること

• 顧客、会社、連絡先、リード、ジョブ、見積もり、請求書を検索します。

• 検証済みの CRM レコードを作成および更新します。

• テナント全体のワークスペースアーキテクチャを検査します。

• テナント専用のワークスペースカスタマイズを計画および適用します。

• 保存済みワークフローを実行します。

• LocalTry Command にマルチステップのビジネスオペレーションを実行させます。

• カスタマイズバージョンをレビューし、以前のバージョンを復元します。

• テナントスコープのアクティビティと監査履歴を読み取ります。

Related MCP server: MCP Client Portal

利用可能なツール

テナント境界

共有された MCP サービスは 1 つですが、すべての認可は論理的にプライベートです。クライアントはテナント識別子を提供または変更できません。

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 レビュープロセスです。

設計原則

• 生の SQL ツールはありません。

• テナント ID ツール引数はありません。

• 秘密情報を読み取るツールはありません。

• API 全体をミラーリングするのではなく、目標指向のツール。

• 重大なワークスペース変更には明示的な承認が必要。

• バージョン管理、監査イベント、復元サポート。

• MCP Worker と CRM ドメインレイヤーの両方で権限チェックを実施。

ステータス

本番環境は mcp.localtry.com にデプロイされています。OAuth 認可、リフレッシュトークン、MCP 初期化、ツールディスカバリ、テナントバインディング、ライブワークスペース読み取りがエンドツーエンドで検証されています。パブリック Worker は、プライベート Cloudflare サービスバインディングを通じてのみ CRM に到達し、データベースバインディングはありません。

ライセンス

MIT