Skip to main content
Glama
philly88r

localtry-mcp

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

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

Инструмент

Назначение

get_workspace_overview

Просмотр страниц, модулей, полей, рабочих процессов, интеграций и истории настроек подключённого бизнеса.

search_crm

Поиск записей CRM в пределах тенанта без раскрытия необработанного SQL.

create_or_update_crm_record

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

plan_workspace_change

Создание версионированного плана настроек без его применения.

apply_workspace_change

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

list_workspace_versions

Просмотр истории настроек рабочего пространства.

restore_workspace_version

Восстановление одобренной более ранней версии для подключённого рабочего пространства.

run_workflow

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

run_localtry_command

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

get_recent_activity

Просмотр недавней активности CRM, рабочих процессов и настроек.

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

Существует один общий 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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A remote MCP server that connects Claude to a Twenty CRM workspace, enabling users to interact with CRM objects (People, Companies, Opportunities, and custom objects) through schema-driven tools for querying, creating, updating, and deleting records.
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    A lightweight MCP server for client relationship management, enabling client tracking, notes, and search via natural language.
    MIT