Prerequisites
-
Claude Code installed and signed in:
- A Hyper account — sign up for free
- At least one integration you plan to use (Google Ads, Meta, GA4, Gmail, etc.) — connect anytime at app.hyperfx.ai/apps
Setup
The Hyper Marketing plugin bundles marketing skills and automatically configures the Hyper MCP. One install gets you everything.- Plugin install (recommended)
- Manual MCP setup
The steps below use slash commands — type them directly in Claude Code. Don’t ask the AI to run
/plugin or /mcp for you.Install the plugin
Install the marketing plugin:When prompted, choose an install scope:
- User scope — available in all your projects (recommended)
- Project scope — shared with collaborators on this repo
- Local scope — only this repo, only for you

Reload plugins
After install, reload so skills and the MCP server register:Or quit and reopen Claude Code.

Authenticate with Hyper
The plugin’s MCP server needs a one-time OAuth sign-in. Use either path:From the plugin manager (recommended): type 
Select the plugin, then choose Authenticate on the Hyper MCP server. Your browser opens — sign in to Hyper and authorize access.
From 
Return to Claude Code — you should see authentication succeed.
/plugin, open the Installed tab, and select hyper-marketing if it shows “needs attention.”

/mcp: type /mcp, find the Hyper MCP server in the list, select it, then choose Authenticate.
Verify your setup
Run a quick test in Claude Code:google-ads or meta-ads when relevant.
You’re connected. Claude Code can now use Hyper’s MCP tools and marketing
skills from the terminal.
Connect your integrations
Connect the ad platforms and apps your skills need. You can do this in either place:- app.hyperfx.ai/apps — connect accounts (Google Ads, Meta, Gmail, Shopify, and others)
- app.hyperfx.ai/mcp — add the Hyper toolkit to your MCP server and connect integrations from the same page
google-ads requires Google Ads, and meta-ads requires Meta Business.

Available skills
Skills activate automatically from natural language, or invoke one directly (e.g./hyper-marketing:google-ads).
| Skill | What it does |
|---|---|
google-ads | Plan and launch Search, Display, and Performance Max campaigns |
meta-ads | Plan and launch Facebook and Instagram campaigns |
tiktok-ads | Plan and launch TikTok campaigns across all objectives |
amazon-ads | Plan and launch Amazon Sponsored Products campaigns |
pinterest-ads | Plan and launch Pinterest campaigns |
meta-ads-library | Research competitor ads in the Meta Ads Library |
instagram | Publish posts, Reels, Stories, and carousels |
tiktok | Publish videos, photos, and carousels |
linkedin | Publish posts and carousels to personal profiles and company pages |
seo-research | Keyword research, SERP analysis, AI search visibility, site audits |
competitor-intel | Weekly competitor digests, battle cards, site and social monitoring |
customer-research | VOC research from Reddit, YouTube, TikTok, Twitter, and G2 |
ad-creative-generation | Generate on-brand ad copy and images |
image-generation | Generate and edit images for any placement |
video-generation | AI video generation, captions, voiceover, and editing |
cold-email-outreach | Prospect, enrich, personalize, and send cold email sequences |
email-lifecycle | Build welcome, nurture, and re-engagement email programs |
analytics-insights | GA4, GTM, Search Console, and BigQuery from chat |
youtube-transcript | Turn any YouTube video into blog posts, show notes, or social content |
What you can do
Once connected, Claude Code can run full marketing workflows through Hyper — not just single tools:- Paid campaigns — Set up, launch, and optimize across Meta, Google Ads, TikTok, and Amazon (creatives, targeting, keywords, budgets, tracking, monitoring).
- Market research — Find winning angles via Meta Ads Library, Reddit, Instagram, TikTok, YouTube, and competitor sites (hooks, offers, pain points, creative trends).
- SEO & content — Connect WordPress, Webflow, Wix, or Ghost, then improve SEO and AI search visibility with keyword research, content briefs, automated posts, and performance tracking.
- Organic social — Create and schedule posts across Instagram, TikTok, LinkedIn, Reddit, Pinterest, and X using brand voice, trend research, and generated images or video.
- Ecommerce analytics — Connect Shopify, GA4, Search Console, Meta, Google Ads, and TikTok to analyze store performance, find conversion issues, and recommend campaigns, landing pages, and budget shifts.
Example prompts
Copy these into Claude Code as-is, then swap in your brand, URLs, and numbers. The more context you give, the better the skill routing and output. Each example maps to one of the workflows above.Google Search campaign
Meta competitor creative research
SEO audit with priorities
Organic social content across channels
instagram, tiktok, linkedin, etc.) plus image-generation or video-generation for assets, and research skills for trend discovery.
Ecommerce performance and budget review
analytics-insights plus ad platform skills when those integrations are connected.
Cross-channel marketing agent
Troubleshooting
"Nested session" error when installing
"Nested session" error when installing
You asked Claude to run
/plugin or /mcp instead of typing it yourself. Slash commands must go directly into the Claude Code input — not through a prompt to the model.Skills aren't showing up after install
Skills aren't showing up after install
Run
/reload-plugins, or restart Claude Code. Then type / and look for the hyper-marketing: namespace, or run /help and check the Commands tab.If skills are still missing, confirm the plugin is enabled: /plugin → Installed tab → hyper-marketing.Plugin or MCP shows 'needs authentication'
Plugin or MCP shows 'needs authentication'
Open
/plugin → Installed → hyper-marketing → Authenticate, or use /mcp → select the Hyper server → Authenticate.If the browser flow fails, try a private window or disable ad blockers temporarily. You can also reconnect from app.hyperfx.ai/mcp.A skill says the MCP isn't connected
A skill says the MCP isn't connected
Run
/plugin list to confirm hyper-marketing is enabled. Re-authenticate the Hyper MCP server via /mcp or the Installed tab in /plugin.A skill says an integration isn't connected
A skill says an integration isn't connected
Connect the platform at app.hyperfx.ai/apps, or from app.hyperfx.ai/mcp if you’re managing connections there. Each skill lists required integrations at the top of its instructions.
Manual MCP — server not found
Manual MCP — server not found
Check your MCP config:You should see a
hyperfx entry pointing at https://backend.hyperfx.ai/mcp/. Re-run the claude mcp add command if it’s missing.FAQ
Do I need to know MCP to use this?
Do I need to know MCP to use this?
No. MCP is the connection layer — you talk to Claude in plain language. The plugin configures the Hyper MCP server for you.
What's the difference between this and Connect to Claude (desktop)?
What's the difference between this and Connect to Claude (desktop)?
Connect to Claude covers Claude’s chat app (connectors UI). This page is for Claude Code — the terminal CLI with plugins, slash commands, and project-scoped skills.
Can I use the plugin and manual MCP setup together?
Can I use the plugin and manual MCP setup together?
Pick one path to avoid duplicate MCP entries. The plugin is recommended — it installs skills and keeps the MCP config in sync.
How do I invoke a skill directly?
How do I invoke a skill directly?
Type the skill path in Claude Code, for example
/hyper-marketing:google-ads, then describe what you want. You can also just ask in natural language; Claude routes to the right skill when the task matches.Related resources
- Marketing skills repository — plugin marketplace source, skill definitions, and other install options for manual MCP setup
- Connect to Claude (desktop) — connect Hyper MCP in Claude’s chat app via connectors
- Set up your MCP server — choose toolkits, set per-tool guardrails, and control what Claude Code can access
- Integrations overview — full list of platforms you can connect in Hyper
- Claude Code documentation — official CLI reference, plugins, and slash commands

