MCP Connect

Connect Affinity's MCP tools to your preferred AI workspace. You need an Affinity MCP API token and the MCP URL. The downloadable skill is optional, but it helps assistants use Affinity tools with better context and smoother prompts.

Watch It Live

This walkthrough connects Claude Desktop end to end: generating an API key, authorizing the connection, and downloading the matching skill.

A few things worth calling out from the video:

• Agency keys can reach any client under the agency. User and client keys are scoped to just one client. Generate the key from that specific client's dashboard, under the API tab — only admins can do this.
• When generating a key for a team member or business owner, click the Client access button on the key form. It's a one-click shortcut that selects the day-to-day plugin set — GHL, GHL Social, core (SMS and calls), Google Analytics, GitHub, Google Business Profile, Google Ads, Meta Ads, Reddit Ads, website forms, image generation, docs search, and verification — while leaving out agency-only plugins like Twilio account setup, SendGrid, Cloudflare, Vercel, and Website Offers.
• For editing work in Claude, Cowork mode is the recommended starting point. Reach for full code mode only if you're a developer who wants direct access to the underlying code.
• The skill you download depends on the role you picked above — an agency key needs the agency skill, a user or client key needs the other one. Downloading the wrong one won't break anything, but it'll give the assistant guidance written for the wrong kind of access.

What You Need

• Affinity MCP URL: https://api.v2.affinitydesign.ca/mcp/http
• API token: an afk_... key with mcp:access, generated by an agency admin or agency representative
• DOWNLOAD SKILL: pick your role above to get the right skill — Agency MCP Master for agency operators, or Website MCP Editor for users and clients — after the connector works

Token Options

Agency operators can use either an Agency MCP master key for trusted internal work across agency-managed connections, or a per-client key from a client's API Keys tab for scoped access. Clients and users should request a token from their agency representative.

Optional Skill

The skill is not required to connect. The API token connects the tools; the skill gives your assistant Affinity-specific operating guidance, naming conventions, and safer default workflows.

There are two skills, and they are not interchangeable:

• Agency MCP Master — for agency operators working across multiple clients (multi-client navigation, destructive-action confirmation, agency-wide workflows).
• Website MCP Editor — for a single workspace (a team member or a business owner working on their own connected client/website).

The role picker above downloads the correct one automatically — pick Agency for the first, User or Client for the second.

Use the skill when:

• you want better first prompts for website, SEO, CRM, and reporting work
• your assistant supports local skills or reusable instruction files
• you are training a team to use Affinity tools consistently

Safety Notes

• Never paste real API tokens into shared repos, screenshots, or public chats.
• Ask your assistant to list available tools after connecting.
• For write-capable tools, ask the assistant to explain the intended change before it acts.
• If tools are missing, ask the agency admin to check the key's plugin restrictions and mcp:access scope.