LocalTry AI CRM

LocalTry MCP

Usa LocalTry desde ChatGPT y otros clientes MCP manteniendo cada negocio estrictamente aislado.

LocalTry MCP es un servidor remoto de Protocolo de Contexto de Modelos para operar un CRM de LocalTry con instrucciones en lenguaje natural. Se ejecuta en Cloudflare Workers, utiliza OAuth 2.1 y vincula cada conexión a un usuario, negocio, rol y conjunto de permisos verificado de LocalTry.

Lo que 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 inquilino.
• Planificar y aplicar personalizaciones del espacio de trabajo solo para el inquilino.
• Ejecutar flujos de trabajo guardados.
• Pedir a LocalTry Command que realice operaciones comerciales de varios pasos.
• Revisar versiones de personalización y restaurar una versión anterior.
• Leer un historial de actividad y auditoría limitado al inquilino.

Herramientas disponibles

Herramienta	Propósito
get_workspace_overview	Inspeccionar las páginas, módulos, campos, flujos de trabajo, integraciones e historial de personalización del negocio conectado.
search_crm	Buscar registros de CRM limitados al inquilino sin exponer SQL sin procesar.
create_or_update_crm_record	Crear o actualizar un registro de CRM validado.
plan_workspace_change	Crear un plan de personalización versionado sin aplicarlo.
apply_workspace_change	Aplicar un plan explícitamente aprobado solo al espacio de trabajo conectado.
list_workspace_versions	Revisar el historial de personalización del espacio de trabajo.
restore_workspace_version	Restaurar una versión anterior aprobada para el espacio de trabajo conectado.
run_workflow	Ejecutar uno de los flujos de trabajo guardados del negocio.
run_localtry_command	Usar LocalTry Command para operaciones de CRM y negocio verificadas de varios pasos.
get_recent_activity	Revisar la actividad reciente de CRM, flujos de trabajo y personalización.

El límite del inquilino

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

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 enlace 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

Verificació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 más reciente y una cuenta de Cloudflare.

npm install
npm run types
npm run check
npm run dev

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

npx wrangler kv namespace create OAUTH_KV

El enlace de servicio LOCALTRY_API debe apuntar al WorkerEntrypoint LocalTryMcpBridge nombrado exportado por la implementación del CRM de LocalTry.

Consulta el contrato de 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 de plan actuales. Crear una aplicación personalizada privada conecta este servidor a una cuenta o espacio de trabajo de ChatGPT; publicar en el directorio público de aplicaciones de ChatGPT es un proceso de revisión separado de OpenAI.

La lista de revisión pública no secreta, los avisos iniciales, los casos de prueba y las notas de versión se mantienen en docs/openai-submission.md.

Principios de diseño

• Sin herramienta de SQL sin procesar.
• Sin argumento de herramienta de ID de inquilino.
• Sin herramienta de lectura de secretos.
• Herramientas orientadas a objetivos en lugar de reflejar toda la API.
• Aprobación explícita para cambios consecuentes en el espacio de trabajo.
• Soporte de versionado, eventos de auditoría y restauración.
• Verificaciones de permisos tanto en el Worker de MCP como en la capa de dominio del CRM.

Estado

La producción está implementada en mcp.localtry.com. La autorización OAuth, los tokens de actualización, la inicialización de MCP, el descubrimiento de herramientas, el enlace de inquilino 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 enlace de servicio privado de Cloudflare y no tiene enlace de base de datos.

Licencia

MIT