The complete guide to ViralWave Studio: put your social media content on autopilot. Setup walkthrough, features, brand voice, review workflow, AI agent integrations, plans, and FAQ.
Guide for ViralWave Studio: guides/06-ai-agents-mcp.md
Chris Porter96dc6ea7aeab
diff --git a/guides/06-ai-agents-mcp.md b/guides/06-ai-agents-mcp.mdnew file mode 100644index 0000000..fd2aa60--- /dev/null+++ b/guides/06-ai-agents-mcp.md@@ -0,0 +1,114 @@+# AI Agents & MCP: Plug ChatGPT, Claude, or Codex Into ViralWave++ViralWave Studio exposes a secure MCP (Model Context Protocol) server. Connect your favorite AI assistant once, and you can manage your content from inside a chat: check your brand voice, review drafts, generate posts, even schedule — without opening the dashboard.++## The one URL++```+https://viralwavestudio.com/mcp+```++That's it. No API keys to create, copy, or store. Compatible assistants discover ViralWave's OAuth server, open a consent page in your browser, and securely handle tokens from there. You approve exactly what the assistant can access.++You can revoke access anytime from **Workspace → AI Agents** in your ViralWave dashboard.++## Connect Codex++In Codex, go to **Settings → MCP servers → Add custom MCP**:++| Field | Value |+|---|---|+| Name | `ViralWave` |+| Type | `Streamable HTTP` |+| URL | `https://viralwavestudio.com/mcp` |++Save, select **Authenticate**, sign in to ViralWave, and approve the connection.++In Codex CLI, add to your config:++```toml+[mcp_servers.viralwave]+url = "https://viralwavestudio.com/mcp"+default_tools_approval_mode = "writes"+tool_timeout_sec = 60+```++Then:++```text+codex mcp login viralwave+```++Start with a read-only check:++```text+Use ViralWave to read my account context and summarize my brand voice+and connected platforms. Do not create or schedule anything.+```++## Connect ChatGPT++On ChatGPT web:++1. Enable **Developer mode** under **Settings → Apps → Advanced Settings**+2. Choose **Create app** and provide `https://viralwavestudio.com/mcp`+3. Select OAuth authentication, scan tools, sign in to ViralWave, approve access++Note: full create and scheduling actions through ChatGPT currently depend on an eligible ChatGPT Business, Enterprise, or Edu workspace and its administrator settings.++## Connect Claude++1. Open **Customize → Connectors**+2. Choose **Add custom connector**, name it `ViralWave`+3. Paste `https://viralwavestudio.com/mcp`, select **Connect**+4. Sign in to ViralWave and approve access++## What your assistant can do++| Tool | Permission | What it does |+|---|---|---|+| `get_account_context` | read | Your brand voice, connected platforms, balances |+| `list_posts` | read | Drafts, scheduled posts, history, failures |+| `get_post` | read | Read one post by ID |+| `get_content_summary` | read | Delivery and content-mix metrics |+| `create_drafts` | drafts | Save your own draft text (no token cost) |+| `generate_campaign_drafts` | drafts | Generate new AI drafts (one token per post) |+| `update_draft` | drafts | Edit private drafts |+| `schedule_post` | schedule | Queue a post (asks for your confirmation first) |+| `cancel_scheduled_post` | schedule | Pull a scheduled post back to draft |+| `generate_video` | video | Generate AI video (uses one video credit) |+| `check_video_status` | video | Check on a video job |++Read-only access grants the read tools. Approving creator access adds drafts, scheduling, and video. **Scheduling always asks for explicit confirmation inside the chat** — your assistant can't post without you saying so.++Two platform notes: X/Twitter isn't available for agent scheduling yet, and TikTok is excluded until its commercial-content disclosures can be handled safely in the agent flow.++## Example prompts to try++```text+Summarize my ViralWave brand voice and tell me which platforms I'm+publishing to this month.+```++```text+Show me my scheduled posts for next week. Flag any that look off-brand.+```++```text+Generate 5 draft posts for my upcoming sale. Save them as drafts —+don't schedule anything.+```++```text+Which of my posts performed best last month, and what pattern do you see?+```++## Manual key fallback++If your client can't do browser-based OAuth, the **AI Agents** page in your dashboard can generate a revocable `vws_mcp_...` key. Treat it like a password: store it as an operating-system environment variable and reference the variable name in your client config — never paste the key itself.++---++**[→ Connect your assistant at viralwavestudio.com](https://viralwavestudio.com)**++Next: [07 — Plans & pricing](07-plans-and-pricing.md).