Getting started with the PEAK MCP Connector
Bring PEAK into the AI assistant you already use. The PEAK MCP Connector securely extends your portfolio into Claude, ChatGPT, Microsoft Copilot, and any other AI client that supports the Model Context Protocol (MCP).
Engineering and operations managers can ask questions in plain English and get structured answers drawn directly from live PEAK data. Triage urgent alerts, chase open actions, and check site health from inside the tool you're already working in. No dashboard hopping. No context switching. No exporting CSVs to ask follow-up questions.
MCP is an open standard backed by all major AI clients, and the PEAK MCP Connector works with any of them using the same connection URL. This article walks through the Claude setup flow we have tested end to end. ChatGPT, Copilot, and other clients use the same URL but their setup steps differ.
Claude PEAK MCP Connector screenshot
Who can use it
You will need:
An active PEAK account with access to one or more sites
A Claude account (Pro, Team, or Enterprise)
Permissions are inherited from your existing PEAK login. You will only be able to see and query sites your PEAK user already has access to.
Connection URL
Environment | URL |
Production |
Setup in Claude
Navigate to claude.ai or open the Claude desktop app.
Go to Settings > Connectors > Add custom connector.
Configure the integration:
Name: PEAK
Complete the PEAK OAuth authorization when prompted.
Start asking questions about your portfolio.
What you can do
The PEAK MCP exposes two main capabilities.
Find your portfolio. Look up clients, sites, equipment, and equipment types across your account. This is the starting point for any question that needs to be scoped to a specific building or piece of plant.
Track issues. Search alert tickets (triaged fault detections from the PEAK rules engine) and action tickets (escalated tickets that have been assigned for follow-up). You can filter by client, site, priority, assignee, status, impact, equipment, and date range.
Example queries
Try these in your Claude chat once the connector is set up.
What issues need attention at my sites?
Find me all chiller issues at site: [enter site name]
What actions need following up across my sites?
The assistant will use the PEAK tools to look up your sites, run the relevant ticket searches, and return a structured summary you can act on. From there you can drill in further: ask about a specific assignee, narrow to a single equipment type, or pull the full detail on any alert or action.
Extending with skills
Skills are reusable prompt packs that turn a single PEAK MCP query into a structured workflow. Rather than writing the same prompt every time, you install a skill once and invoke it with a slash command.
Featured skill: peak-ops
The peak-ops skill is a portfolio operations dashboard for the PEAK MCP. It produces structured rollups of priority alert tickets, assignee load, and unresolved issues across your sites, and supports follow-up drilldowns by site, equipment type, or equipment name within the same session.
Install steps:
Visit https://github.com/cim-data-engineering/skill-peak-ops in your browser.
Click the green Code button and select Download ZIP.
In Claude, go to Customize > Skills > Upload skill.
Drag the downloaded zip into the upload area.
In any chat, invoke the skill with /peak-ops.
Example query
/peak-ops what requires attention across my sites?
Once invoked, the skill stays active for the rest of the session, so you can keep asking follow-up questions without re-running the slash command.
Troubleshooting
Token expiry.
If the connector starts failing or returning authentication errors, your PEAK token has likely expired. Go to Settings > Connectors, disconnect and re-reconnect the PEAK connector, then re-authenticate.
Missing sites or data.
You can only see sites your PEAK login already grants access to. If a site is missing, check your PEAK permissions before raising a support ticket.
Security and data access
The PEAK MCP uses OAuth 2.0 for authentication and inherits the permissions of your existing PEAK account. No additional data access is granted through the connector. The AI client (Claude, ChatGPT, or other) processes your queries and responses according to its own privacy and data retention policies, so review your organization's policies for AI tool usage before connecting.