Copy as Markdown

Connect Your AI Tools to Brand Kit OS

Brand Kit OS offers three ways to connect your AI tools for live access to your brand context. Choose the method that fits your workflow.

---

🔌 Method 1: Remote Connector (Recommended)

Best for: Claude.ai, Claude Desktop, Claude Mobile

The Remote Connector uses OAuth 2.0 with PKCE — no API key needed. Claude authenticates directly with your Brand Kit OS account.

Setup Steps

1. Open Claude (web, desktop, or mobile)
2. Go to Settings → Connectors → Add Custom Connector
3. Enter the following details:
   • Connector Name: Brand Kit OS (or any name you prefer)
   • Connector URL: https://fupwpcqmyykfiuakjxxc.supabase.co/functions/v1/mcp-server
4. Click Connect — you'll be redirected to Brand Kit OS to log in and authorize
5. A popup will ask if you want to open in Claude — click Yes
6. Claude will refresh and the connector will appear as active

Important Notes

• Authentication required: If you're not logged in to Brand Kit OS, you'll be redirected to the login page first
• No Client Secret needed: The connector uses PKCE (Proof Key for Code Exchange), so no secret is required
• Mobile access: Once connected on desktop, the connector is also available on Claude Mobile automatically
• OAuth Client ID: bk_claude_connector_v1 (auto-configured — you don't need to enter this)

What You Get

• All 12 MCP tools available directly in Claude
• Live access to your brand kits — always up to date
• No API key to manage or rotate
• Works across Claude web, desktop, and mobile

---

🧩 Method 2: Cowork Plugin (Claude Desktop)

Best for: Claude Desktop users who want skills + auto-load

The Cowork Plugin bundles MCP tools with pre-built skills and a hook that loads your brand context automatically at the start of every conversation.

Setup Steps

1. In Brand Kit OS, go to Settings → Integrations
2. Click Download Cowork Plugin (generates a .zip with your API key baked in)
3. Unzip into your Claude Desktop plugins folder:
   • macOS: ~/Library/Application Support/Claude/plugins/
   • Windows: %APPDATA%\Claude\plugins\
4. Restart Claude Desktop
5. Verify: type "What brand kits do I have?" — Claude should respond with your data

What's Included

• plugin.json — Plugin manifest
• hooks.json — Auto-loads brand context on conversation start
• skills/voice-enforcement.md — Enforces your brand voice in all outputs
• skills/brand-context-loader.md — Pulls full brand context into conversations

---

🛠️ Method 3: Other AI Tools (API Key)

Best for: Cursor, Claude Code, or any MCP-compatible client

These tools connect via API key authentication using the MCP remote transport.

Generate an API Key

1. Go to Settings → Integrations in Brand Kit OS
2. Click Create API Key
3. Copy and store the key securely (it won't be shown again)

Cursor Configuration

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "brandkit-os": {
      "command": "npx",
      "args": [
        "-y", "@anthropic-ai/mcp-remote",
        "https://fupwpcqmyykfiuakjxxc.supabase.co/functions/v1/mcp-server",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code Configuration

claude mcp add brandkit-os \
  -- npx -y @anthropic-ai/mcp-remote \
  https://fupwpcqmyykfiuakjxxc.supabase.co/functions/v1/mcp-server \
  --header "Authorization:Bearer YOUR_API_KEY"

Replace YOUR_API_KEY with the key you generated.

---

Troubleshooting

---

Next Steps

• View all available MCP tools
• Export brand context as a file