LocalTry AI CRM

LocalTry MCP

在严格隔离各个企业数据的同时，通过 ChatGPT 和其他 MCP 客户端使用 LocalTry。

LocalTry MCP 是一个远程模型上下文协议服务，可通过自然语言指令操作 LocalTry CRM。它运行在 Cloudflare Workers 上，使用 OAuth 2.1，并将每个连接绑定到一个已验证的 LocalTry 用户、企业、角色和权限集。

可实现的功能

• 搜索客户、公司、联系人、潜在客户、工作、报价和发票。
• 创建和更新经过验证的 CRM 记录。
• 创建由租户拥有的 AI Agent，并在 Flow Studio 中使用。
• 检查完整的租户工作区架构。
• 搜索所有已注册的页面、操作、Agent、集成和租户添加项。
• 通过 LocalTry Builder 提交仅适用于租户的工作区自定义请求。
• 运行已保存的工作流。
• 让 LocalTry Command 执行多步骤业务操作。
• 查看自定义版本并恢复到较早的版本。
• 查看租户范围内的活动和审计历史记录。

可用工具

工具	用途
get_workspace_overview	检查已连接企业的页面、模块、字段、工作流、集成和自定义历史记录。
search_localtry_features	在执行操作前，查找准确注册的 LocalTry 页面、操作、Agent、集成或租户添加项。
search_crm	搜索租户范围内的 CRM 记录，而无需暴露原始 SQL。
create_or_update_crm_record	创建或更新经过验证的 CRM 记录。
create_workflow_agent	描述并保存由租户拥有的 AI Agent，以供 Flow Studio 工作流使用。
request_workspace_customization	提交与“自定义工作区”提示词相同的租户范围内工程请求。
get_workspace_customization_status	查看最新的自定义对话、进度、问题和结果。
list_workspace_versions	查看工作区的自定义历史记录。
restore_workspace_version	为已连接的工作区恢复到较早的已批准版本。
run_workflow	运行企业已保存的工作流之一。
run_social_research	启动一次公开社交媒体或网络研究搜索，并将其保存到已连接的工作区。
run_localtry_command	使用 LocalTry Command 执行经过验证的多步骤 CRM 和业务操作。
get_recent_activity	查看近期的 CRM、工作流和自定义活动。

租户边界

所有租户共用一个 MCP 服务，但每次授权在逻辑上都是私有的。 客户端无法提供或更改租户标识符。

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 并批准一个可见的工作区；无需将 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 仅通过 Cloudflare 私有服务绑定访问 CRM，且未绑定数据库。

许可证

MIT