LocalTry AI CRM

LocalTry MCP

Use o LocalTry a partir do ChatGPT e de outros clientes MCP mantendo cada negócio estritamente isolado.

O LocalTry MCP é um servidor remoto do Model Context Protocol para operar um CRM LocalTry com instruções em linguagem natural. Ele roda em Cloudflare Workers, usa OAuth 2.1 e vincula cada conexão a um usuário, negócio, função e conjunto de permissões verificados do LocalTry.

O que ele permite

• Pesquisar clientes, empresas, contatos, leads, trabalhos, orçamentos e faturas.
• Criar e atualizar registros de CRM validados.
• Inspecionar a arquitetura completa do workspace do tenant.
• Planejar e aplicar personalizações de workspace exclusivas do tenant.
• Executar fluxos de trabalho salvos.
• Pedir ao LocalTry Command que execute operações de negócio em várias etapas.
• Revisar versões de personalização e restaurar uma versão anterior.
• Ler um histórico de atividades e auditoria com escopo do tenant.

Ferramentas disponíveis

Ferramenta	Finalidade
get_workspace_overview	Inspecionar as páginas, módulos, campos, fluxos de trabalho, integrações e histórico de personalização do negócio conectado.
search_crm	Pesquisar registros de CRM com escopo do tenant sem expor SQL bruto.
create_or_update_crm_record	Criar ou atualizar um registro de CRM validado.
plan_workspace_change	Criar um plano de personalização versionado sem aplicá-lo.
apply_workspace_change	Aplicar um plano explicitamente aprovado somente ao workspace conectado.
list_workspace_versions	Revisar o histórico de personalização do workspace.
restore_workspace_version	Restaurar uma versão anterior aprovada para o workspace conectado.
run_workflow	Executar um dos fluxos de trabalho salvos do negócio.
run_localtry_command	Usar o LocalTry Command para operações de CRM e negócio verificadas em várias etapas.
get_recent_activity	Revisar atividades recentes de CRM, fluxos de trabalho e personalização.

O limite do tenant

Há um único serviço MCP compartilhado, mas cada autorização é logicamente privada. O cliente não pode fornecer ou alterar um 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

O MCP Worker não recebe uma vinculação de banco de dados. Ele só pode acessar o LocalTry por meio do contrato de serviço privado em docs/localtry-bridge-contract.md.

Endpoint remoto

O endpoint de produção está ativo:

https://mcp.localtry.com/mcp

Verificação de integridade:

https://mcp.localtry.com/health

Os clientes descobrem os metadados do OAuth 2.1 automaticamente. A autorização oferece suporte a PKCE, registro dinâmico de clientes, tokens de acesso de curta duração e tokens de atualização. Os usuários entram no LocalTry e aprovam um workspace visível; nenhuma chave de API do LocalTry é copiada para o cliente MCP.

Desenvolvimento local

Requisitos: Node.js 20 ou mais recente e uma conta Cloudflare.

npm install
npm run types
npm run check
npm run dev

Crie um namespace KV do OAuth e substitua o ID de namespace de espaço reservado em wrangler.jsonc:

npx wrangler kv namespace create OAUTH_KV

A vinculação de serviço LOCALTRY_API deve apontar para o LocalTryMcpBridge WorkerEntrypoint nomeado exportado pela implantação do CRM LocalTry.

Consulte o contrato de ponte para conhecer o limite exato de confiança.

ChatGPT

O ChatGPT oferece suporte a aplicativos MCP remotos por meio do modo de desenvolvedor. Consulte docs/chatgpt.md para o fluxo de conexão e os requisitos atuais do plano. Criar um aplicativo personalizado privado conecta este servidor a uma conta ou workspace do ChatGPT; publicar no diretório público de aplicativos do ChatGPT é um processo de revisão separado da OpenAI.

A listagem pública de revisão sem segredos, os prompts iniciais, os casos de teste e as notas de versão são mantidos em docs/openai-submission.md.

Princípios de design

• Nenhuma ferramenta de SQL bruto.
• Nenhum argumento de ferramenta com ID de tenant.
• Nenhuma ferramenta de leitura de segredos.
• Ferramentas orientadas a objetivos em vez de espelhar toda a API.
• Aprovação explícita para alterações relevantes no workspace.
• Versionamento, eventos de auditoria e suporte a restauração.
• Verificações de permissão tanto no MCP Worker quanto na camada de domínio do CRM.

Status

A produção está implantada em mcp.localtry.com. A autorização OAuth, os tokens de atualização, a inicialização do MCP, a descoberta de ferramentas, a vinculação de tenant e uma leitura ao vivo do workspace foram verificados de ponta a ponta. O Worker público acessa o CRM somente por meio de uma vinculação de serviço privada do Cloudflare e não possui vinculação de banco de dados.

Licença

MIT