connect
Set up the services this kit's skills use — API keys, Google login, MCP servers — step by step, without keys ever passing through the chat. Creates one private keys file, walks the user through gettin
SKILL.mdskills/connect/SKILL.md
GitHubConnect
One keys file, one health check, one command per MCP server. Detailed guides per service live in connections/ at the root of this kit.
KIT="python3 ${CLAUDE_SKILL_DIR}/scripts/kit.py"
$KIT init # create ~/.config/marketing-agent-kit/.env (chmod 600)
$KIT open # open it in a text editor
$KIT doctor --live # tools, keys (tested with free requests), Google login, MCP servers
$KIT mcp list # MCP servers it can register
$KIT mcp add ahrefs # register one (add --dry-run to preview)
The one rule: keys never go through the chat
Everything typed in a chat is saved in session transcripts on disk. So:
- Ask the user to paste keys into the keys file, not into the chat. Run
kit.py openfor them. - Never print a key, never
catthe keys file, never put a key in a URL or a command you show.kit.pyreads the file and masks secrets in everything it prints. - If a user pastes a key into the chat anyway: don't repeat it. Offer to write it into the file for them, and recommend rotating the key later, since it is now in the transcript.
- Prefer OAuth where the service offers it (Stripe, Ahrefs, ElevenLabs, SearchApi, Higgsfield): no key is stored at all.
Order of work
- Find out what the user wants to do, not which services exist. Map it with the table below and set up only those services.
kit.py init, thenkit.py open. Tell the user which lines to fill in.- One service at a time: open its guide in
connections/, walk the user through getting access in plain steps (what to click, what plan is needed, what it costs), wait for them to save the key. kit.py doctor --live— confirm the key is accepted before moving on.- MCP servers:
kit.py mcp add <name>. For OAuth servers, tell the user to run/mcpin Claude Code → pick the server → Authenticate. A new server appears after restarting the session (desktop app: start a new session). - Google services (GA4, Google Ads, BigQuery) use a gcloud login, not a key — follow
connections/ga4-mcp.md. The login opens a browser: run it in the background and tell the user to sign in. Search Console uses a service account and a site config instead —connections/search-console.md. - Video:
python3 ${CLAUDE_SKILL_DIR}/../video-sound/scripts/library.py installdownloads the sound library (~150 MB), thenlibrary.py venvbuilds its analysis environment. HyperFrames:connections/hyperframes-cli.md. - Finish with
kit.py doctor --liveand a short table: what works, what's left, what it costs.
Which skill needs what
| Skill | Needs | Cost to start |
|---|---|---|
| parallel-research | PARALLEL_API_KEY (or the free Parallel Search MCP for search only) |
free credits on signup |
| ads-parser | SEARCHAPI_KEY |
100 free requests |
| ahrefs | Ahrefs MCP (OAuth or AHREFS_MCP_KEY); for scripted keyword research either AHREFS_API_KEY (API v3, any paid plan from Lite) or MCP results imported into kw.py |
paid Ahrefs plan, Lite or higher |
| seo | nothing itself; routes to gsc-insights, seo-tech-audit and ahrefs | — |
| gsc-insights | uv, a Search Console service account with Restricted access, a site config; optional Google Sheet, BigQuery, Slack |
free |
| seo-tech-audit | uv, the same site config; optional CRUX_API_KEY, BING_WMT_API_KEY, Chrome for the render check |
free |
| competitor-research | all three above | — |
| ga4-reports | gcloud login + GA4 MCP | free |
| image-gen | OPENAI_API_KEY |
pay per image (~$0.006–0.21) |
| ads-video-library | FFmpeg; optional Google service account for Drive | free |
| funnel-screenshots | Python 3.10+; its setup.sh installs Playwright + Chromium |
free |
| video-studio, video-sound, video-build, video-moves, video-check | Node 22+, FFmpeg, HyperFrames CLI and skills, ELEVENLABS_API_KEY (paid plan for sound effects), the sound library (video-sound/scripts/library.py install), uv for its analysis venv, a Whisper CLI |
ElevenLabs Starter $6/mo |
| video-3d | the same, plus a GPU-capable Chrome for HyperFrames | free |
| video-generated | ATLAS_API_KEY |
pay per generation |
| plain-copy, copy-critic | nothing | — |
Optional extras with their own guides: Google Ads MCP, Stripe MCP, BigQuery, Playwright MCP, ElevenLabs, HyperFrames, Higgsfield, Slack.
Safety defaults to recommend
- Read-only wherever possible. GA4 and Google Ads MCP are read-only by design. Stripe: grant Read only; BigQuery: allow only
execute_sql_readonly. Add deny rules for write tools (examples in each guide). - Spending caps. Ahrefs (monthly unit cap per key, plus
monthly_unit_capin the SEO site config), ElevenLabs (credit quota per key), Parallel (a separate key for agents), OpenAI (project budget), Atlas Cloud (top up small amounts). - Separate keys for agents. A key that only an agent uses can be revoked without breaking anything else.
When something fails
doctorsays a key is rejected → the key is wrong, expired or rotated. Issue a new one in the service's dashboard.- An MCP server shows "Failed to connect" → see the troubleshooting section of its guide. For GA4 the usual causes are an expired gcloud login or a stale cached install (
pipx run --no-cache analytics-mcp). claudeCLI not found (desktop-app users) → open the app's built-in terminal (Ctrl+) and run the commandkit.py mcp add --dry-run` prints, or add the server via + → Connectors in the desktop app where the service is listed.