LocalTry MCP

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

LocalTry MCP — это удалённый сервер Model Context Protocol для управления LocalTry CRM с помощью инструкций на естественном языке. Он работает на Cloudflare Workers, использует OAuth 2.1 и привязывает каждое подключение к одному проверенному пользователю, бизнесу, роли и набору разрешений LocalTry.

Что он позволяет

• Поиск клиентов, компаний, контактов, лидов, работ, смет и счетов.

• Создание и обновление проверенных записей CRM.

• Просмотр полной архитектуры рабочего пространства тенанта.

• Планирование и применение настроек рабочего пространства только для тенанта.

• Запуск сохранённых рабочих процессов.

• Запрос LocalTry Command для выполнения многошаговых бизнес-операций.

• Просмотр версий настроек и восстановление более ранней версии.

• Чтение активности и истории аудита в пределах тенанта.

Related MCP server: MCP Client Portal

Доступные инструменты

Граница тенанта

Существует один общий MCP-сервис, но каждая авторизация логически приватна. Клиент не может указать или изменить идентификатор тенанта.

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

MCP Worker не получает привязку к базе данных. Он может обращаться к LocalTry только через частный сервисный контракт, описанный в docs/localtry-bridge-contract.md.

Удалённая конечная точка

Продакшн-конечная точка доступна:

https://mcp.localtry.com/mcp

Проверка состояния:

https://mcp.localtry.com/health

Клиенты автоматически обнаруживают метаданные OAuth 2.1. Авторизация поддерживает PKCE, динамическую регистрацию клиентов, кратковременные токены доступа и токены обновления. Пользователи входят в LocalTry и подтверждают одно видимое рабочее пространство; никакой API-ключ LocalTry не копируется в MCP-клиент.

Локальная разработка

Требования: Node.js 20 или новее и учётная запись Cloudflare.

npm install
npm run types
npm run check
npm run dev

Создайте пространство имён OAuth KV и замените идентификатор пространства имён-заполнителя в wrangler.jsonc:

npx wrangler kv namespace create OAUTH_KV

Привязка службы LOCALTRY_API должна указывать на именованный LocalTryMcpBridge WorkerEntrypoint, экспортируемый развёртыванием LocalTry CRM.

Подробнее о точной границе доверия см. в контракте моста.

ChatGPT

ChatGPT поддерживает удалённые MCP-приложения через режим разработчика. Информацию о процессе подключения и требованиях текущего плана см. в docs/chatgpt.md. Создание частного пользовательского приложения подключает этот сервер к учётной записи или рабочему пространству ChatGPT; публикация в общедоступном каталоге приложений ChatGPT — это отдельный процесс проверки OpenAI.

Принципы проектирования

• Нет инструмента для необработанного SQL.

• Нет аргумента инструмента с идентификатором тенанта.

• Нет инструмента для чтения секретов.

• Ориентированные на цель инструменты вместо зеркалирования всего API.

• Явное одобрение для существенных изменений рабочего пространства.

• Поддержка версионирования, событий аудита и восстановления.

• Проверки разрешений как в MCP Worker, так и в доменном слое CRM.

Статус

Продакшн развёрнут на mcp.localtry.com. Авторизация OAuth, токены обновления, инициализация MCP, обнаружение инструментов, привязка тенанта и чтение живого рабочего пространства проверены насквозь. Публичный Worker обращается к CRM только через частную привязку службы Cloudflare и не имеет привязки к базе данных.

Лицензия

MIT