# ViewsMax setup brief: Claude Code

Announce a launch without leaving your editor. Claude Code can read what you just built, write the posts, schedule them through ViewsMax, report back on clicks and sales, and dig up outlier videos for your next idea.

MCP endpoint: https://api.viewsmax.com/api/mcp. Full docs: https://viewsmax.com/ai.md. Human version of this page: https://viewsmax.com/claude-code.

## 1. Link the accounts you publish to

Sign up for ViewsMax, go to Dashboard → Connections, and link each channel. The platform logins happen inside ViewsMax, so your AI only ever holds a ViewsMax permission — and new channels you add later show up for it straight away.

## 2. Plug ViewsMax into Claude Code

Already connected ViewsMax in Claude? Claude Code inherits connectors from the claude.ai account you log in with — run /mcp and look for it before adding anything. (On Team and Enterprise, only admins can add connectors in claude.ai.)

- **Register the server.** Paste this into your terminal. The --scope user flag makes ViewsMax available across all your projects.
  ```
  claude mcp add --transport http --scope user viewsmax https://api.viewsmax.com/api/mcp
  ```
  Claude Code comes with Claude Pro, Max, Team and Enterprise plans, or a Claude Console account with API credits.
- **Log in.** Open Claude Code, type /mcp, choose viewsmax, then approve ViewsMax in the browser window that opens (read-only or full access).
  ```
  /mcp
  ```

- **No browser (CI, servers)?.** Generate an API key in ViewsMax under Settings → AI Assistant Access and pass it as a header instead.
  ```
  claude mcp add --transport http --scope user viewsmax https://api.viewsmax.com/api/mcp --header "Authorization: Bearer vmx_YOUR_KEY"
  ```

## 3. Run a quick test

> Which of my social accounts can you reach through ViewsMax?

Got two accounts on the same platform? Name the one you mean ("my @brand Instagram") so your AI doesn't have to stop and ask.

## 4. Give it a real job

> Summarise what changed in the last three commits as a LinkedIn update and a shorter X version. Keep both as ViewsMax drafts.

What happens next:

- Before it uses a ViewsMax tool that changes something, Claude Code asks for your OK.
- ViewsMax stores the post as a draft, or queues it for the time you gave.
- At publish time ViewsMax sends it to each channel separately and keeps a result per platform, so one failure never blocks the rest.

## Channels

- YouTube: One video. You'll be asked whether it goes out public, unlisted or private.
- TikTok: A video or a photo set. You'll be asked to pick the privacy level.
- Instagram: One photo or one Reel, on an Instagram Business or Creator account.
- X: Text, with up to 4 images. No video yet.
- LinkedIn: Text, with one image. No video yet.
- Threads: Text, with one image or one video.
- Bluesky: Text, with up to 4 images. No video yet.

## Prompts to try

- **Explain a feature:** Look at the changes on this branch and write a short X thread explaining the new feature to non-developers. Save it as a ViewsMax draft.
- **Cross-post a clip:** Take the video at https://example.com/reel.mp4 and make it an Instagram Reel and a TikTok draft. Give TikTok a shorter caption than Instagram.
- **Track a promotion:** I'm promoting my ebook at https://example.com/ebook. Set it up as an offer with sales as the goal, and make separate tracked links for YouTube and Instagram.
- **Find your best earner:** Rank my offers by revenue for the past 30 days and tell me which traffic source is actually converting.
- **Borrow what's working:** Pull YouTube outliers in personal finance from this month and explain the hook behind the top three. Save the best one to my library.
- **Tidy the queue:** What's going out this weekend? Push anything on X back by two hours.

## Fixes

- **Claude Code asks you to authenticate.** Type /mcp, choose viewsmax, and complete the login in the browser window.
- **Reads work, but posting is refused.** The connection was approved as read-only. Reconnect and pick full access on the ViewsMax approval screen, or swap in a full-access API key.
- **Media won't upload.** Uploading a file into the chat window isn't enough — ViewsMax downloads media from a link. Host the file at a public https address that serves the file itself, not a preview page. Accepted: JPEG, PNG, WebP, GIF, MP4, MOV.
- **A channel isn't listed.** Link it under Dashboard → Connections in ViewsMax (your AI can also hand you a connect link), then run the test prompt again.
- **One platform published, another didn't.** Each platform is published separately in the background and keeps its own status. Ask for the status of that post to see the exact error the platform sent back.