{"slug":"strategy/business-strategy/GTM_FLOW_VISUAL","title":"GTM Flow: Visual Architecture","section":"strategy","sectionLabel":"Strategy","status":"unclassified","type":"document","path":"strategy/business-strategy/GTM_FLOW_VISUAL.mdx","bytes":18094,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n\n> **Tier C — Historical.** This document is a point-in-time snapshot preserved for reference. For current architecture, see [CANONICAL_PLATFORM_ARCHITECTURE.md](../architecture/CANONICAL_PLATFORM_ARCHITECTURE.md).\n\n## Three Simple Pieces\n\n### Piece 1: Marketplace Apps (Multiple)\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ Claude Desktop │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ [Connect IntegrateWise Button] │ │\n│ │ ↓ Click │ │\n│ │ Opens: https://integratewise.com/auth?app=claude │ │\n│ └─────────────────────────────────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n\n┌─────────────────────────────────────────────────────────────┐\n│ ChatGPT │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ [Connect IntegrateWise Action] │ │\n│ │ ↓ Click │ │\n│ │ Opens: https://integratewise.com/auth?app=chatgpt │ │\n│ └─────────────────────────────────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n\n┌─────────────────────────────────────────────────────────────┐\n│ Perplexity │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ [Connect IntegrateWise Plugin] │ │\n│ │ ↓ Click │ │\n│ │ Opens: https://integratewise.com/auth?app=perplexity │ │\n│ └─────────────────────────────────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### Piece 2: OAuth Gateway (One)\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│ IntegrateWise OAuth │\n├──────────────────────────────────────────────────────────────┤\n│ │\n│ GET /oauth?app=claude&redirect_uri=... │\n│ ↓ │\n│ Show form: Email + Organization Name │\n│ ↓ │\n│ POST /oauth/authorize │\n│ ↓ │\n│ Create Tenant (if new) │\n│ Create User │\n│ Issue JWT Token │\n│ ↓ │\n│ Redirect: redirect_uri?token=JWT&app=claude │\n│ │\n└──────────────────────────────────────────────────────────────┘\n```\n\n### Piece 3: Feature Surface (All Connected)\n\n```\n┌──────────────────────────────────────────────────────────────┐\n│ Feature Surface │\n├──────────────────────────────────────────────────────────────┤\n│ │\n│ if (token exists) { │\n│ Show: │\n│ • Spine Query Builder │\n│ • Agent Lee Recommendations │\n│ • Memory Search │\n│ • Decision Log │\n│ • Task Sync │\n│ } │\n│ │\n└──────────────────────────────────────────────────────────────┘\n```\n\n\n## Complete User Journey (2 Minutes)\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ Step 1: User opens Claude Desktop (15 seconds) │\n├─────────────────────────────────────────────────────────────┤\n│ • Sees \"Connect IntegrateWise\" button │\n│ • Clicks button │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Step 2: Redirected to OAuth (Page loads) │\n├─────────────────────────────────────────────────────────────┤\n│ • Shows: Email + Organization Name form │\n│ • User enters: acme@acme.com + \"Acme Corp\" │\n│ • Clicks: \"Authorize\" │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Step 3: Backend Processing (5 seconds) │\n├─────────────────────────────────────────────────────────────┤\n│ • Creates Tenant(id=tenant_001) │\n│ • Creates User(id=user_001, email=acme@acme.com) │\n│ • Issues JWT(userId=user_001, tenantId=tenant_001) │\n│ • Redirects to: claude-extension://callback?token=JWT │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Step 4: Claude Extension Receives Token (1 second) │\n├─────────────────────────────────────────────────────────────┤\n│ • Stores JWT in local storage │\n│ • Recognizes: Connected │\n└─────────────────────────────────────────────────────────────┘\n ↓\n┌─────────────────────────────────────────────────────────────┐\n│ Step 5: Feature Surface Available (Instant) │\n├─────────────────────────────────────────────────────────────┤\n│ • Shows: Spine Query Builder │\n│ • Shows: Agent Lee Panel │\n│ • Shows: Memory Search │\n│ • Shows: Decision Log │\n│ • Shows: Task Sync │\n│ │\n│ User can now ask: │\n│ \"Should we pursue Acme Corp?\" → Claude queries Spine │\n└─────────────────────────────────────────────────────────────┘\n```\n\n\n## Data Flow: One Question\n\n```\nUser: \"Should we pursue Acme Corp?\"\n ↓\nClaude Extension sends to MCP Server:\n GET /mcp/spine?query=account:acme_corp&fields=*\n ↓\nMCP Server (with JWT):\n 1. Validates JWT → Gets tenant_id + user_id\n 2. Queries Spine: SELECT * FROM accounts WHERE org_id = tenant_001\n 3. Returns: { revenue, deal_count, arr, logo_status, ...}\n ↓\nClaude processes response:\n \"Based on Acme's $2M revenue, $500k ARR, and 5 existing deals,\n I recommend pursuing. 92% confidence.\"\n ↓\nUser clicks: \"Log Decision\"\n ↓\nClaude sends to MCP Server:\n POST /mcp/decisions\n { account_id: acme_001, decision: \"pursue\", confidence: 0.92 }\n ↓\nMCP Server (with JWT):\n 1. Validates JWT\n 2. Inserts to decisions table\n 3. Emits event: { type: \"decision_made\", ... }\n 4. Hermes broadcasts to all connected clients\n ↓\nAll clients (ChatGPT, Perplexity, etc.) see:\n \"Acme Corp: Decision to pursue logged by Claude. 92% confidence.\"\n```\n\n\n## Architecture: Three Layers\n\n```\n┌────────────────────────────────────────────────────────────────┐\n│ LAYER 1: MARKETPLACE APPS │\n├────────────────────────────────────────────────────────────────┤\n│ │\n│ Claude Desktop ──┐ │\n│ ChatGPT ├──→ OAuth Redirect │\n│ Perplexity │ │\n│ Replit │ │\n│ Lovable │ │\n│ │\n└────────────────────────────────────────────────────────────────┘\n ↓\n┌────────────────────────────────────────────────────────────────┐\n│ LAYER 2: INTEGRATEWISE GATEWAY │\n├────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OAuth Handler │ │\n│ │ • Email + Organization │ │\n│ │ • Create Tenant │ │\n│ │ • Create User │ │\n│ │ • Issue JWT │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ MCP Server (with JWT validation) │ │\n│ │ • read_spine │ │\n│ │ • write_decision │ │\n│ │ • query_memory │ │\n│ │ • invoke_agent_lee │ │\n│ │ • create_task │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ Spine + Hermes Event Stream │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└────────────────────────────────────────────────────────────────┘\n ↓\n┌────────────────────────────────────────────────────────────────┐\n│ LAYER 3: CONNECTED SYSTEMS │\n├────────────────────────────────────────────────────────────────┤\n│ │\n│ Salesforce ──┐ │\n│ HubSpot ├──→ Read/Write via Connectors │\n│ Stripe │ │\n│ NetSuite │ │\n│ 28 more... │ │\n│ │\n└────────────────────────────────────────────────────────────────┘\n```\n\n\n## Deployment Path\n\n```\nWeek 1:\n • Deploy OAuth handler\n • Deploy MCP server (JWT validation)\n • Test manual flow\n\nWeek 2:\n • Add Claude Desktop extension\n • Publish to Claude marketplace\n • First 10 users\n\nWeek 3:\n • Add ChatGPT action\n • Add Perplexity plugin\n • 100+ users\n\nWeek 4:\n • Add Replit integration\n • Add Lovable integration\n • Scale to 1000+ users\n```\n\n\n## That's It\n\nClick marketplace app → One OAuth → Features available.\n\nNo magic. No complexity. Just three pieces working together.\n\n"}