Trimble Claude MCP — GitHub + Render + Firebase

Starter production-oriented architecture for a Trimble Connect MCP server and Firebase-hosted extension UI.

Architecture

• GitHub: source control

• Render: Node.js MCP + OAuth backend

• Firebase Hosting: Trimble Connect extension frontend

• Trimble Identity: per-user OAuth

• Trimble Connect API: user-authorized data

• Anthropic API: optional Claude orchestration

Related MCP server: Remote MCP Server on Cloudflare

Important production notes

1. The included session store is intentionally in-memory for development. Replace it with Firestore, Redis, or PostgreSQL before multi-instance production.

2. Verify the exact Trimble OAuth endpoints/scopes for your registered Trimble application before deployment.

3. Do not commit .env or secrets.

4. The MCP HTTP implementation is a minimal starter transport. For Claude remote MCP compatibility, align it with the current MCP Streamable HTTP/auth requirements and SDK version you deploy.

5. The Firebase UI is a starter shell. Replace YOUR-RENDER-NAME and wire the chat orchestration to your desired Claude/MCP flow.

Local run

cp .env.example .env
npm install
npm start

Open http://localhost:3000/health.

GitHub

git init
git add .
git commit -m "Initial Trimble Claude MCP"
git branch -M main
git remote add origin https://github.com/YOUR-USERNAME/trimble-claude-mcp.git
git push -u origin main

Render

Connect the GitHub repository as a Web Service or use render.yaml as a Blueprint. Build: npm install; Start: npm start. Set all variables from .env.example in Render. After deployment set TRIMBLE_REDIRECT_URI to: https://YOUR-RENDER-NAME.onrender.com/oauth/callback

Firebase

firebase login
firebase init hosting
firebase deploy

Use public as the hosting directory. Replace the Render URL in public/index.html.

Suggested next production work

• Firestore token/session persistence with encryption at rest

• OAuth PKCE/state and robust callback validation

• Exact MCP Streamable HTTP implementation using the current official SDK

• MCP authorization metadata/discovery as required by the Claude client

• Trimble API pagination/error handling

• Project/model/object/issue/file tools

• Claude tool orchestration endpoint

• Trimble Connect extension SDK context and selected-object integration

• Rate limiting, CSRF protection, audit logging, and structured logging "# trimble-claude-mcp"