LocalTry MCP

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

LocalTry MCP는 일반 언어 지침으로 LocalTry CRM을 운영하기 위한 원격 Model Context Protocol 서버입니다. 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는 데이터베이스 바인딩을 받지 않습니다. docs/localtry-bridge-contract.md의 비공개 서비스 계약을 통해서만 LocalTry에 도달할 수 있습니다.

원격 엔드포인트

프로덕션 엔드포인트가 운영 중입니다:

https://mcp.localtry.com/mcp

상태 확인:

https://mcp.localtry.com/health

클라이언트는 OAuth 2.1 메타데이터를 자동으로 검색합니다. 권한 부여는 PKCE, 동적 클라이언트 등록, 수명이 짧은 액세스 토큰 및 리프레시 토큰을 지원합니다. 사용자는 LocalTry에 로그인하여 표시되는 하나의 워크스페이스를 승인합니다. LocalTry API 키는 MCP 클라이언트에 복사되지 않습니다.

로컬 개발

요구 사항: Node.js 20 이상 및 Cloudflare 계정.

npm install
npm run types
npm run check
npm run dev

OAuth KV 네임스페이스를 만들고 wrangler.jsonc의 자리 표시자 네임스페이스 ID를 교체합니다:

npx wrangler kv namespace create OAUTH_KV

LOCALTRY_API 서비스 바인딩은 LocalTry CRM 배포에서 내보낸 LocalTryMcpBridge WorkerEntrypoint를 가리켜야 합니다.

정확한 신뢰 경계는 브리지 계약을 참조하세요.

ChatGPT

ChatGPT는 개발자 모드를 통해 원격 MCP 앱을 지원합니다. 연결 흐름과 현재 플랜 요구 사항은 docs/chatgpt.md를 참조하세요. 비공개 사용자 지정 앱을 만들면 이 서버가 ChatGPT 계정 또는 워크스페이스에 연결됩니다. 공개 ChatGPT 앱 디렉터리에 게시하는 것은 별도의 OpenAI 검토 프로세스입니다.

설계 원칙

• 원시 SQL 도구 없음.

• 테넌트 ID 도구 인수 없음.

• 비밀 정보를 읽는 도구 없음.

• 전체 API를 미러링하는 대신 목표 지향적인 도구.

• 결과가 큰 워크스페이스 변경에 대한 명시적 승인.

• 버전 관리, 감사 이벤트 및 복원 지원.

• MCP Worker와 CRM 도메인 계층 모두에서 권한 검사.

상태

프로덕션은 mcp.localtry.com에 배포되어 있습니다. OAuth 권한 부여, 리프레시 토큰, MCP 초기화, 도구 검색, 테넌트 바인딩 및 실시간 워크스페이스 읽기가 엔드투엔드로 검증되었습니다. 공개 Worker는 비공개 Cloudflare 서비스 바인딩을 통해서만 CRM에 도달하며 데이터베이스 바인딩이 없습니다.

라이선스

MIT