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.
• Criar agentes de IA de propriedade do locatário que ficam disponíveis no Flow Studio.
• Inspecionar a arquitetura completa do workspace do locatário.
• Pesquisar cada página, ação, agente, integração e adição de locatário registrados.
• Enviar personalizações de workspace exclusivas do locatário por meio do LocalTry Builder.
• Executar fluxos de trabalho salvos.
• Pedir ao LocalTry Command para realizar operações de negócios 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 locatário.

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_localtry_features	Encontrar a página, ação, agente, integração ou adição de locatário exata registrada no LocalTry antes de agir.
search_crm	Pesquisar registros de CRM com escopo do locatário sem expor SQL bruto.
create_or_update_crm_record	Criar ou atualizar um registro de CRM validado.
create_workflow_agent	Descrever e salvar um agente de IA de propriedade do locatário para uso em fluxos de trabalho do Flow Studio.
request_workspace_customization	Enviar a mesma solicitação de engenharia com escopo do locatário que o prompt Customize Workspace.
get_workspace_customization_status	Ler a conversa, o progresso, as perguntas e o resultado mais recentes da personalização.
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_social_research	Iniciar uma pesquisa pública de redes sociais ou web e salvá-la no workspace conectado.
run_localtry_command	Usar o LocalTry Command para operações verificadas de CRM e negócios em várias etapas.
get_recent_activity	Revisar a atividade recente de CRM, fluxos de trabalho e personalização.

O limite do locatário

Há um único serviço MCP compartilhado, mas cada autorização é logicamente privada. O cliente não pode fornecer ou alterar um identificador de locatário.

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 suporta 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 do 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 WorkerEntrypoint nomeado LocalTryMcpBridge exportado pela implantação do CRM LocalTry.

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

ChatGPT

O ChatGPT suporta 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 não secreta para revisão, prompts iniciais, casos de teste e 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 de ID de locatário.
• Nenhuma ferramenta de leitura de segredos.
• Ferramentas orientadas a objetivos em vez de espelhar toda a API.
• Aprovação explícita para mudanças 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. Autorização OAuth, tokens de atualização, inicialização do MCP, descoberta de ferramentas, vinculação de locatário e uma leitura ao vivo do workspace foram verificados de ponta a ponta. O Worker público alcança o CRM apenas por meio de uma vinculação de serviço privada do Cloudflare e não tem vinculação de banco de dados.

Licença

MIT