LocalTry MCP

从 ChatGPT 和其他 MCP 客户端使用 LocalTry，同时确保每个企业严格隔离。

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

它能做什么

• 搜索客户、公司、联系人、线索、工作、估价和发票。

• 创建和更新经过验证的 CRM 记录。

• 检查完整的租户工作区架构。

• 规划并应用仅限租户的工作区自定义。

• 运行已保存的工作流。

• 让 LocalTry Command 执行多步骤业务操作。

• 查看自定义版本并恢复早期版本。

• 读取租户范围内的活动和审计历史。

Related MCP server: MCP Client Portal

可用工具

租户边界

只有一个共享的 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 不会获得数据库绑定。它只能通过 docs/localtry-bridge-contract.md 中的私有服务契约访问 LocalTry。

远程端点

生产端点已上线：

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 审核流程。

设计原则

• 没有原始 SQL 工具。

• 没有租户 ID 工具参数。

• 没有读取秘密的工具。

• 面向目标的工具，而不是镜像整个 API。

• 对影响重大的工作区更改进行明确批准。

• 支持版本控制、审计事件和恢复。

• 在 MCP Worker 和 CRM 领域层都进行权限检查。

状态

生产环境部署在 mcp.localtry.com。OAuth 授权、刷新令牌、MCP 初始化、工具发现、租户绑定和实时工作区读取已进行端到端验证。公共 Worker 仅通过私有 Cloudflare 服务绑定访问 CRM，并且没有数据库绑定。

许可证

MIT