# Connect Scout7 to Claude or ChatGPT (MCP) > Scout7 is a remote MCP server with OAuth 2.0. One connection works on one brand workspace. Ready-made prompts come with the connection. They are also published as Agent Skills at https://scout7.ai/.well-known/agent-skills. - **MCP server URL**: https://mcp.scout7.ai/mcp - **Guide (HTML)**: https://scout7.ai/mcp - **Scout7 for Claude**: https://scout7.ai/claude - **Scout7 for ChatGPT**: https://scout7.ai/chatgpt - **Support**: hello@scout7.ai ## In Scout7 (all clients) 1. **Onboard on the website first** — Sign up free at scout7.ai with your website. Scout7 reads it and learns your brand. 2. **Copy the URL from MCP Server** — Open MCP Server in the sidebar and copy https://mcp.scout7.ai/mcp. Paste it into your agent. 3. **Approve on the consent page** — Pick the brand workspace, check the permissions, click Connect. One connection works on one workspace. ## Connect ### Claude (claude.ai · Claude Desktop · Cowork) Add Scout7 once as a custom connector. claude.ai, Claude Desktop and Cowork share it. Plans: Free (one custom connector), Pro, Max, Team and Enterprise. 1. **Open Customize › Connectors** — In Claude, open Settings › Customize › Connectors. 2. **Add a custom connector** — Click + and choose Add custom connector. 3. **Name it Scout7 and paste the URL** — Name: Scout7. Remote MCP server URL: https://mcp.scout7.ai/mcp. Leave Advanced settings empty. 4. **Add, then Connect** — Click Add, then Connect. On the Scout7 page, pick the workspace and click Connect. 5. **Check the tools** — Scout7 now shows as connected in Claude. Paste the first ask below to check. First ask: "Which brand is this, and what can Scout7 do from here?" _Team and Enterprise: an Owner adds it under Organization settings › Connectors › Add › Custom › Web. Members then open Customize › Connectors, click Connect and pick their workspace._ ### Claude Code (Terminal · IDE) One command adds the server. /mcp signs you in. Plans: Any Claude plan with Claude Code. 1. **Add the server** — Add --scope user to use it in every project. `claude mcp add --transport http scout7 https://mcp.scout7.ai/mcp` 2. **Sign in** — Run /mcp, pick scout7 and sign in. The Scout7 page opens in your browser. `/mcp` 3. **Check** — You should see “✔ Connected”. If it says “! Needs authentication”, run /mcp again. `claude mcp list` First ask: "Which brand is this, and what can Scout7 do from here?" ### Codex (Codex CLI · Codex IDE extension · ChatGPT desktop app) Add one block to config.toml, then log in once. The CLI, IDE extension and ChatGPT desktop app share it. Plans: Any ChatGPT plan with Codex. 1. **Add it to config.toml** — Add this to ~/.codex/config.toml. A trusted project can use .codex/config.toml instead. `[mcp_servers.scout7] url = "https://mcp.scout7.ai/mcp"` 2. **Log in** — Codex opens the Scout7 page. Pick the workspace and click Connect. `codex mcp login scout7` 3. **Check** — Scout7 is listed with its tools. Then paste the first ask below. `codex mcp list` First ask: "Which brand is this, and what can Scout7 do from here?" ### Cursor (Cursor IDE · Cursor agents) Add Scout7 to Cursor’s MCP config. Cursor asks you to approve it the first time it uses a tool. Plans: Any Cursor plan. 1. **Add it to ~/.cursor/mcp.json** — Or to .cursor/mcp.json inside the project. Settings › MCP shows it. `{ "mcpServers": { "scout7": { "url": "https://mcp.scout7.ai/mcp" } } }` 2. **Approve the connection** — Cursor opens the Scout7 page. Pick the workspace and click Connect. 3. **Check** — Settings › MCP lists Scout7 with its tools. Then paste the first ask below. First ask: "Which brand is this, and what can Scout7 do from here?" ### ChatGPT (chatgpt.com · ChatGPT desktop) Custom connectors need Developer mode. ChatGPT also asks you to confirm each write. Plans: Plus, Pro, Business, Enterprise and Edu. Not Free. 1. **Turn on Developer mode** — Open Settings › Apps › Advanced settings. Switch Developer mode on. 2. **Create the connector** — On the Apps/Plugins page, click +. Name: Scout7. MCP server URL: https://mcp.scout7.ai/mcp. Authentication: OAuth. Click Create. 3. **Approve on the consent page** — Pick the brand workspace and click Connect. 4. **Select Scout7 in a chat** — In a new chat, open + › Developer mode and pick Scout7. Start prompts with “Using Scout7, …”. First ask: "Using Scout7, which brand is this, and what can Scout7 do from here?" _Business, Enterprise and Edu: an admin must allow Developer mode. The admin can also share the connector with the whole workspace._ ## Permissions (scopes) - `posts:read` — See your posts and calendar - `posts:write` — Make and edit post drafts - `posts:publish` — Post now or schedule posts (asks first: Yes, every time) - `conversations:read` — See mentions Scout7 found for you - `conversations:write` — Draft replies. You post them, not your agent - `content:read` — Read articles, your blog and carousels - `content:write` — Make article drafts, carousels and video briefs - `content:publish` — Post articles to your blog, X or Reddit (asks first: Yes, every time) - `seo:read` — Read site checks and AI mentions - `seo:write` — Run new site checks. Uses credits (asks first: Yes, shows the cost first) - `topics:read` — See your brand topics - `topics:write` — Add or change topics ## What your agent can never do - Switch to another workspace - Post replies. You post those in the app - Run ad campaigns. Google, Meta, LinkedIn and Reddit campaigns are built, run and monitored in the app, not over MCP yet - Post, schedule or spend without your OK - Buy credits or change your plan - Connect or remove social accounts - Record your face or voice - Read other workspaces or your passwords ## Security and data - OAuth 2.0, per the MCP spec. Your agent gets a short-lived token for one workspace. - Scout7 never sees your agent login. Your agent never sees your Scout7 password. - Read tools run on their own. Posting and spending always wait for your OK. ChatGPT asks again on every write. - You see the cost before credits are spent. Articles never go live on their own. - Scout7 logs each tool call for security, support and billing. It does not store your chat. - Your chat runs under Anthropic’s or OpenAI’s terms. Scout7 does not use your content or chats to train AI models. Its model providers may not either. - Disconnect any time in your agent or in Scout7 under MCP Server. It takes effect on the next call. Posts already live stay live. ## Troubleshooting - **The consent page keeps coming back** — Finish the Scout7 sign-in in the tab your agent opened. Allow pop-ups for claude.ai or chatgpt.com. Signed in elsewhere? Click Connect again. Claude Code: /mcp › scout7 › Clear authentication, then reconnect. - **I connected the wrong workspace** — One connection is one brand. Remove the connector, add it again and pick the right workspace. For a second brand in Claude (Pro and up), add a second connector named “Scout7 – Brand B”. Claude Free allows one. - **The tools don’t show up** — Claude: click Connect, finish the Scout7 page, check the tool toggles. Claude Code: “! Needs authentication” in `claude mcp list` means run /mcp. ChatGPT: Developer mode on, Scout7 picked in this chat via + › Developer mode. After a server update, refresh the connector. - **“This will use N credits”** — Your agent shows the cost before it spends. Out of credits? The tool stops and tells you. Top up inside Scout7, not in the chat. - **A step needs a paid plan or more credits** — Every paid plan does everything. Plans differ by credits: 300 a month on Starter, 3,000 on Growth. Free covers onboarding, connecting and the Growth Scorecard. AI video, the deep site check and carousels need a paid plan. Nothing is bought in the chat. - **Team or company accounts** — Claude Team and Enterprise: an Owner adds the connector. ChatGPT Business, Enterprise and Edu: an admin allows Developer mode. Each member still picks their own workspace. ## FAQ ### I already have Claude Code. Why Scout7? Your agent thinks. Scout7 knows your brand, makes carousels and videos, posts to six platforms on a schedule, and checks if you get found. One connection, and your agent runs marketing like it runs code. ### Which agents work? Claude Code, Codex and Cursor over MCP. claude.ai, Claude Desktop, Cowork and ChatGPT as a custom connector. Any MCP client that supports remote servers with OAuth. Onboard with your website first, then connect. One connection works on one brand workspace. ### Does it post without me? Never. It reads and drafts on its own. Posting, scheduling and spending credits wait for your OK in the chat. ### Do I need to know marketing? No. You know your product and customers. Scout7 knows the method. It asks you a few questions and does the rest. ### Anything I can’t do from ChatGPT? You cannot upload your own files or photos from ChatGPT. Use the Scout7 app for uploads. Everything else works. ### Is it safe to connect? Yes. It uses OAuth 2.0, works on one brand workspace, and you can revoke it any time. Your agent reads and drafts on its own. Posting, scheduling and spending need your OK in the chat. ChatGPT asks again on every write. ### What can it do without my OK? Read your brand, topics, calendar and site checks. Research, draft, plan and estimate credits. It cannot post, schedule or spend credits without your OK in the chat. ### What happens if I never approve? Drafts stay drafts. Nothing is posted. Credits for work you asked for are still used. Your agent shows the cost first, so say no before, not after. ### Which Claude plans work? Free (one custom connector), Pro, Max, Team and Enterprise. Works on claude.ai, Claude Desktop and Cowork. Claude Code: claude mcp add --transport http scout7 https://mcp.scout7.ai/mcp. On Team and Enterprise, an Owner adds the connector. ### Which ChatGPT plans work? Plus, Pro, Business, Enterprise and Edu, with Developer mode on. Not Free. On Business, Enterprise and Edu, an admin turns it on. ### Do I still need the Scout7 app? For four things. Onboard with your website first. Record your face and voice. Upload your own photos and files. See the calendar. Everything else runs from your agent. ### What does it cost? Credits. Each article, carousel, video or batch of posts has a price. Your agent shows it first. Connecting is included on every plan. Paid plans differ only by credits. Buy extra credits anytime. ### What needs a paid plan? AI video, the deep site check and LinkedIn carousels. Free covers onboarding, connecting and the Growth Scorecard. Every paid plan does everything. Plans differ by credits: 300 a month on Starter, 3,000 on Growth. ### Is my data used to train models? No. Scout7 does not use your content or chats to train AI models. Its model providers may not either. Claude and ChatGPT follow Anthropic’s or OpenAI’s terms and your settings there. ### How do I disconnect? In Claude: Customize › Connectors › Scout7 › Remove. In ChatGPT: Apps/Plugins › Scout7 › Remove. In Claude Code: claude mcp remove scout7. In Scout7: MCP Server › revoke. It takes effect on the next call. ### Does it work in Claude Code, Claude Desktop and Cowork? Yes. Desktop and Cowork share the claude.ai connector. Claude Code adds it with one command. Ready-made prompts come with it, also published as Agent Skills at https://scout7.ai/.well-known/agent-skills. ### What is ChatGPT Developer mode? A setting that lets ChatGPT use connectors OpenAI has not reviewed. Turn it on under Settings › Apps › Advanced settings. ChatGPT then asks you to confirm each write. ### Can it post to TikTok or YouTube? Not yet. Scout7 posts to LinkedIn, X, Instagram, Facebook, Threads and Reddit. Videos are 9:16, so you can post them elsewhere yourself. ### Why can’t articles be scheduled? Articles go live on your blog the moment you say post. Then X (Premium) and Reddit. LinkedIn needs your browser. Your agent reminds you and asks first. ## Policies - [Privacy Policy](https://scout7.ai/privacy-policy) - [Terms and Conditions](https://scout7.ai/terms-and-conditions)