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.
🗂️ Work across tabs: Your AI can access and organize workflows across different tabs, helping you place processes exactly where they belong.
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.” |
Navigate Tabs | View and understand how workflows are organized across different tabs in your canvas. | “What tabs exist in this workspace?” |
Create in Specific Tabs | Insert or update workflows within a specific tab instead of the default canvas view. | “Create this process in the Sales Ops tab.” |
Update Attribute Status | Change the lifecycle status of attributes in your data model — Draft, Active, Deprecated, or Deleted — directly from your AI conversation. | Mark the legacy customer_id attribute as Deprecated. |
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 & Allow Tools Permissions
3️⃣ Step 3: Authenticate & Allow Tools Permissions
You’ll be prompted to log in to Puzzle
At this stage, Puzzle will ask which workspace you want to connect. Select the appropriate workspace for this connector and click Authorize Access.
To connect additional workspaces, repeat the same process by adding another custom connector in Claude. You can use the same MCP URL with a workspace parameter to create a unique connection:
https://app.puzzleapp.io/mcp?workspace=yourworkspacename
🎥 Here’s a quick walkthrough of connecting multiple workspaces.
You’ll also be able to choose when Claude can use Puzzle tools by setting up the Tools Permissions.
Read-only tools (like viewing workflows or data) can be set to Always allow
Write or update tools (like creating or editing) can be set to Needs approval
This gives you control over how much access Claude has when interacting with your workflows.
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!