LocalTry AI CRM

LocalTry MCP

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

LocalTry MCP es un servidor remoto del Protocolo de Contexto de Modelos (MCP) 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 verificados de LocalTry.

Lo que permite

• Buscar clientes, empresas, contactos, clientes potenciales, trabajos, presupuestos y facturas.
• Crear y actualizar registros CRM validados.
• Crear agentes de IA propiedad del inquilino que estén disponibles en Flow Studio.
• Inspeccionar la arquitectura completa del espacio de trabajo del inquilino.
• Buscar cada página, acción, agente, integración y adición de inquilino registrada.
• Enviar personalizaciones del espacio de trabajo exclusivas del inquilino a través de LocalTry Builder.
• 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_localtry_features	Encontrar la página, acción, agente, integración o adición de inquilino registrada exacta de LocalTry antes de actuar.
search_crm	Buscar registros CRM limitados al inquilino sin exponer SQL sin procesar.
create_or_update_crm_record	Crear o actualizar un registro CRM validado.
create_workflow_agent	Describir y guardar un agente de IA propiedad del inquilino para usarlo en flujos de trabajo de Flow Studio.
request_workspace_customization	Enviar la misma solicitud de ingeniería limitada al inquilino que el mensaje Personalizar Espacio de Trabajo.
get_workspace_customization_status	Leer la conversación, el progreso, las preguntas y el resultado más recientes de la personalización.
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_social_research	Iniciar una búsqueda pública de redes sociales o investigación web y guardarla en el espacio de trabajo conectado.
run_localtry_command	Usar LocalTry Command para operaciones CRM y comerciales 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 mensajes iniciales, los casos de prueba y las notas de la 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