LocalTry MCP

Use LocalTry from ChatGPT and other MCP clients while keeping every business strictly isolated.

LocalTry MCP es un servidor remoto del Model Context Protocol para operar un CRM de LocalTry con instrucciones en lenguaje sencillo. Se ejecuta en Cloudflare Workers, utiliza OAuth 2.1 y vincula cada conexión a un usuario, negocio, rol y conjunto de permisos de LocalTry verificados.

Qué permite

• Buscar clientes, empresas, contactos, prospectos, trabajos, presupuestos y facturas.

• Crear y actualizar registros de CRM validados.

• Inspeccionar la arquitectura completa del espacio de trabajo del tenant.

• Planificar y aplicar personalizaciones del espacio de trabajo exclusivas del tenant.

• Ejecutar flujos de trabajo guardados.

• Pedir a LocalTry Command que realice operaciones de negocio de varios pasos.

• Revisar versiones de personalización y restaurar una versión anterior.

• Leer un historial de actividad y auditoría delimitado al tenant.

Related MCP server: MCP Client Portal

Herramientas disponibles

El límite del tenant

Hay un único servicio MCP compartido, pero cada autorización es lógicamente privada. El cliente no puede proporcionar ni cambiar un identificador de tenant.

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

El Worker de MCP no recibe un binding de base de datos. Solo puede acceder a LocalTry a través del contrato de servicio privado en docs/localtry-bridge-contract.md.

Endpoint remoto

El endpoint de producción está activo:

https://mcp.localtry.com/mcp

Comprobación de estado:

https://mcp.localtry.com/health

Los clientes descubren los metadatos de OAuth 2.1 automáticamente. La autorización admite PKCE, registro dinámico de clientes, tokens de acceso de corta duración y tokens de actualización. Los usuarios inician sesión en LocalTry y aprueban un espacio de trabajo visible; no se copia ninguna clave de API de LocalTry en el cliente MCP.

Desarrollo local

Requisitos: Node.js 20 o superior y una cuenta de Cloudflare.

npm install
npm run types
npm run check
npm run dev

Crea un namespace KV de OAuth y reemplaza el ID de namespace de marcador de posición en wrangler.jsonc:

npx wrangler kv namespace create OAUTH_KV

El service binding LOCALTRY_API debe apuntar al WorkerEntrypoint llamado LocalTryMcpBridge exportado por el despliegue del CRM de LocalTry.

Consulta el contrato del puente para conocer el límite de confianza exacto.

ChatGPT

ChatGPT admite aplicaciones MCP remotas a través del modo de desarrollador. Consulta docs/chatgpt.md para conocer el flujo de conexión y los requisitos del plan actual. Crear una aplicación personalizada privada conecta este servidor a una cuenta o espacio de trabajo de ChatGPT; publicarla en el directorio público de aplicaciones de ChatGPT es un proceso de revisión aparte de OpenAI.

Principios de diseño

• Sin herramientas de SQL sin procesar.

• Sin argumento de herramienta de ID de tenant.

• Sin herramientas de lectura de secretos.

• Herramientas orientadas a objetivos en lugar de replicar toda la API.

• Aprobación explícita para cambios importantes en el espacio de trabajo.

• Versionado, eventos de auditoría y soporte de restauración.

• Comprobaciones de permisos tanto en el Worker de MCP como en la capa de dominio del CRM.

Estado

La producción está desplegada en mcp.localtry.com. La autorización OAuth, los tokens de actualización, la inicialización de MCP, el descubrimiento de herramientas, la vinculación de tenant y una lectura en vivo del espacio de trabajo se han verificado de extremo a extremo. El Worker público solo accede al CRM a través de un service binding privado de Cloudflare y no tiene binding de base de datos.

Licencia

MIT