AI is only as powerful as the context it has access to. Without it, even the most advanced models fall back on assumptions instead of understanding how your business actually operates.
Puzzle MCP (Model Context Protocol) brings real operational context into every AI interaction.
By connecting Puzzle to tools like Claude, your full operational blueprint becomes available to your AI. This includes your processes, teams, tools, and data models. Instead of working in isolation, your AI can now understand how work flows across your organization, who owns each step, what systems are involved, and how everything connects.
This shifts AI from a generic assistant to an operational partner. One that can answer questions, trace workflows, and support decisions based on how your business truly runs.
What is Puzzle MCP?
Puzzle MCP (Model Context Protocol) connects your operational blueprint in Puzzle to AI tools like Claude.
Once connected, your AI can read and understand how your business operates across processes, teams, tools, and data models. Instead of working from generic knowledge, your AI works from the same system your team uses to design and manage operations.
This allows your AI to answer detailed questions, trace workflows across systems, and support improvements based on how your organization is actually structured.
🔑 Key advantage: Your operational blueprint becomes a shared source of truth between humans and AI.
How Puzzle MCP Works
Puzzle MCP connects your operational blueprint to AI tools so your agents can read, understand, and interact with your operations.
Here’s how it works:
🔗 Connect Puzzle to your AI tool: Add Puzzle as a connector using a secure MCP URL and authorize your account.
📖 Your AI reads your blueprint: Processes, teams, tools, and data models become accessible inside your AI conversations.
💬 Ask questions and analyze workflows: Your AI can explain how processes work, trace dependencies, and understand how everything connects.
✍️ Propose and document changes: Your AI can suggest updates and write changes back to Puzzle, keeping your blueprint current.
Puzzle MCP Architecture
Your operational blueprint acts as the shared system between humans and AI. Humans design and refine workflows in Puzzle, while AI agents read that context, support execution, and help improve processes over time.
What Your AI Can Do with Puzzle MCP
Capability | Description | Example Prompt |
Understand Processes | Explain how workflows operate, including steps, roles, tools, and structure. | “How does our onboarding process work?” |
Trace Dependencies | Analyze upstream and downstream relationships across workflows. | “What happens after a lead is qualified?” |
Identify Ownership | Surface which roles or teams are responsible for each step. | “Who owns this step?” |
Map Tools & Systems | Show which tools are used and how systems connect. | “Which tools are used in this process?” |
Analyze Data Models | Understand entities, attributes, and how data flows across systems. | “What data is used in this workflow?” |
Propose Improvements | Suggest ways to simplify or optimize workflows. | “How can we improve this process?” |
Document Changes | Capture updates, reasoning, and impacted steps. | “Summarize what changed in this workflow.” |
Examples & Usage
Common Use Cases
Use Case | Example |
Process Understanding | “Explain our onboarding flow.” |
Workflow Navigation | “What happens before and after this step?” |
Team Visibility | “Who is responsible for each stage?” |
System Awareness | “Which tools are used across this workflow?” |
Advanced Use Cases
Use Case | Example |
Process Optimization | “Where are the bottlenecks in this workflow?” |
Automation Opportunities | “Which steps can be automated?” |
Cross-Functional Analysis | “How does Sales hand off to Customer Success?” |
Impact Analysis | “If this step changes, what else is affected?” |
Operational Audits | “Show workflows that use HubSpot and Stripe.” |
Continuous Improvement | “Suggest ways to simplify this process.” |
🔌 How to Connect Puzzle MCP to Claude
You can connect Puzzle to Claude using a custom MCP connector.
1️⃣ Step 1: Get your Puzzle MCP URL
1️⃣ Step 1: Get your Puzzle MCP URL
Copy your custom MCP connector URL below:
https://app.puzzleapp.io/mcp
2️⃣ Step 2: Add Puzzle to Claude
2️⃣ Step 2: Add Puzzle to Claude
Open Claude
Go to Customize → Connectors
Click Add Custom Connector
Paste your Puzzle MCP URL
Name it “Puzzle”
3️⃣ Step 3: Authenticate
3️⃣ Step 3: Authenticate
You’ll be prompted to log in to Puzzle
Authorize access
Allow access to Tool permissions
Once connected, your AI can begin reading and writing to your operational blueprint.
Frequently Asked Questions
Do I need a complete blueprint before using MCP?
Do I need a complete blueprint before using MCP?
No, but the more complete your blueprint is, the more valuable your AI responses will be. Also you can add information from Claude into Puzzle, so it works in both directions.
Which AI tools are supported?
Which AI tools are supported?
Puzzle MCP currently supports Claude, with plans to support additional AI tools that follow the MCP standard.
Can AI update my workflows?
Can AI update my workflows?
AI can propose changes and document updates, helping keep your blueprint accurate over time.
Conclusion
Puzzle MCP turns your operational blueprint into a shared system between humans and AI. Your team designs and evolves processes. Your AI understands, analyzes, and supports them in real time. Every interaction becomes grounded in your actual workflows, not assumptions or disconnected data.
This is a new way of working. One where your processes are not just documented, but actively powering how decisions are made and how work gets done.
Start building your blueprint, connect it to your AI, and experience what it looks like when your entire operation becomes instantly accessible, understandable, and actionable!