Connect your AI assistant
Connect Claude, ChatGPT or another AI app to your workspace, step by step.
MCP is a way to let an AI app like Claude or ChatGPT work with your outwrite.ai workspace. Once it's connected, you can ask that app about your articles, results and settings, and let it make the changes you allow. This is a Pro feature.
What MCP means in plain words
MCP (short for Model Context Protocol) is an open standard that AI apps use to connect to other tools. outwrite.ai runs the connection for you, so there's nothing to install or host. You paste one web address into your AI app, sign in to outwrite.ai, and choose what the app is allowed to do.
In this guide, "assistant" means the AI app you connect, such as Claude, ChatGPT, Cursor or Codex.
Why it helps
- You can work where you already work: ask Claude or ChatGPT about your content and results in the same chat as the rest of your work.
- A coding assistant such as Claude Code, Cursor or Codex can add the SEO Agent script to your website and then check that it's installed.
- You stay in control. You choose which websites and permissions each assistant gets, see every connected assistant, and can disconnect any of them at any time.
- No passwords are shared. The assistant never sees your outwrite.ai password or the logins you've saved for your website.
Before you start
- A Pro workspace. MCP connections is in the Pro sidebar, and only websites in Pro can be connected. A trial can use Pro.
- You must be the account owner. Teammates can't connect assistants.
- An active trial or subscription.
- An AI app that supports remote MCP servers with sign-in (OAuth). Some apps only offer this on paid plans, or need a workspace admin to allow it. Check your app's own help if you can't find the setting.
Set it up
- In outwrite.ai, click MCP connections in the sidebar.
- Under Your MCP server URL, click Copy. The address is
https://outwrite.ai/api/mcp. It's the same for every website in your account: you choose the website when you sign in. - Add that address to your AI app. Find your app in Connection steps for each app below. Name the connection
outwrite.ai(oroutwriteif your app doesn't allow dots). - Your app opens an outwrite.ai page called Connect your agent. If you aren't signed in, click Sign in, sign in on the new tab, then come back and click I’m signed in.
- Choose your website and permissions. See Choose what your assistant can do below.
- Click Allow view access (or Allow selected access if you ticked any boxes). Your browser returns to your AI app.
- In your AI app, turn the connection on if it asks, then try it out.
Choose what your assistant can do
The Connect your agent page asks a few questions. Start small. You can always connect again with more permissions later.
- Website: choose the website to connect. Websites in Simple show "(Simple)" and can't be chosen.
- Also allow these websites: if you have several websites in Pro, tick any others the assistant should reach. They get the same permissions.
- What this assistant can do: reading is always included. Tick only the boxes you need.
| Box | What the assistant can do |
|---|---|
| Nothing ticked | Read only: your Brand, articles, campaigns, feeds, results and reports. It can't change anything. |
| Manage feeds, article drafts and schedules… | Create and change feeds, drafts and schedules, AI visibility prompts, SEO audits, article improvements and article style. This can spend credits, up to the monthly credit limit you choose. |
| Allow website changes and publishing… | Create or change campaigns, send articles to your website, apply SEO Agent fixes and update articles already on your website. Needs the box above. |
| Manage account connections and request billing changes | Manage publishing connections and Google Search Console, set credit spending limits and create secure payment links. You still pay and sign in to other services yourself in secure browser pages. |
- If you ticked Manage feeds, article drafts and schedules…, two more choices appear:
- Monthly credit limit for this assistant: the most credits this assistant can commit to paid work in a calendar month (UTC). The default is 100. Choose 0 to allow only free actions. Each paid action counts the most it can use when it starts, and your account's credit balance and spending limits still apply.
- Allow repeating work: lets the assistant turn on work that runs on a schedule, such as feed refreshes, AI tracking, SEO monitoring and Autopilot. It's off by default. Scheduled runs use your account's credits and spending limits, not the assistant's monthly limit.
- Check the app name at the top and the "Return to" address. They should match the app you're connecting. If the page says the app registered itself, continue only if you started the connection in that app.
- Click Allow view access or Allow selected access. Click Not now to cancel.
The assistant also receives your account email so it knows who signed in. Permissions and troubleshooting explains every choice in detail.
Connection steps for each app
Use the address you copied (https://outwrite.ai/api/mcp) wherever these steps say "your URL". Menu names in other apps can change, so each app's own help is linked where we have it.
Connect Claude
For Claude on the web or the Claude desktop app:
- Open Claude's settings and go to Connectors.
- Choose to add a custom connector.
- Name it
outwrite.aiand paste your URL. - Click to add and connect it. Claude opens the outwrite.ai Connect your agent page. Sign in and choose your permissions.
- In a chat, open the tools or connectors menu and make sure outwrite.ai is turned on.
Using Claude in a terminal? See Connect Claude Code.
Connect ChatGPT
Custom connections in ChatGPT depend on your plan, and in business workspaces an admin must allow them. ChatGPT's setup guide shows where to add one today.
- In ChatGPT, open the place where you add a custom MCP server or app (see the guide above).
- Name it
outwrite.aiand paste your URL. - Choose OAuth as the sign-in method.
- Complete the outwrite.ai Connect your agent page.
- Start a new chat, turn on outwrite.ai, and ask it to list your outwrite.ai workspaces.
Connect Claude Code
-
In a terminal, run:
claude mcp add --transport http outwrite https://outwrite.ai/api/mcp -
Start Claude Code and type
/mcp. -
Select outwrite and choose to authenticate. Your browser opens the Connect your agent page.
-
After you allow access, ask Claude to list your outwrite.ai workspaces.
If your browser shows an error after you allow access, Claude Code may have closed the sign-in window. Run /mcp and authenticate again. To always use the same local sign-in address, add --callback-port 8976 to the claude mcp add command.
Claude Code's MCP guide has more options.
Connect Codex
-
In a terminal, run:
codex mcp add outwrite --url https://outwrite.ai/api/mcp codex mcp login outwrite -
Complete the Connect your agent page that opens in your browser.
-
Start a new Codex session so it loads the outwrite.ai tools.
The Codex desktop app's MCP settings can also manage this connection.
Connect Cursor
-
Open Cursor's MCP settings and add a new server.
-
Use this configuration:
{ "mcpServers": { "outwrite": { "url": "https://outwrite.ai/api/mcp" } } } -
Click to sign in when Cursor asks, and complete the Connect your agent page.
-
Make sure the outwrite tools are turned on for your agent.
Cursor's MCP guide explains user-level and project-level settings.
Connect GitHub Copilot
- In VS Code, open the command palette and run MCP: Add Server.
- Choose HTTP, paste your URL and name the server
outwrite. - Start the server and complete the Connect your agent page in your browser.
- Open Copilot's agent chat and turn on the outwrite tools.
VS Code's MCP guide covers workspace settings and tool controls.
Connect more coding agents
Windsurf, Cline, Gemini CLI, Kiro, OpenCode, Goose and Roo Code can connect the same way, as long as their MCP settings support a remote server with OAuth sign-in:
- In the app's MCP settings, add a remote server named
outwrite. - Paste your URL. If it asks for a transport type, choose HTTP or Streamable HTTP.
- Start the server or run its sign-in, and complete the Connect your agent page.
Check the app's own MCP guide for where these settings live.
Connect your agent
Any other AI app or personal agent can connect if it supports remote MCP servers with OAuth sign-in. Add your URL in its MCP or connector settings, then sign in and choose permissions. Apps that only accept local servers or an API key can't connect to outwrite.ai.
Try it out
Start with this request. It proves the connection can read your account, not just that it appears in settings:
"List my authorized outwrite.ai workspaces, then summarize my campaigns, articles and next scheduled work."
Then try requests that match the permissions you gave:
| What you want | What to ask | Permission needed |
|---|---|---|
| See what's coming up | "Which articles are scheduled for the next two weeks, and which are waiting for my review?" | View only |
| Check AI visibility | "Which of my tracked prompts mention a competitor but not us?" | View only |
| Read search performance | "Compare the last 28 days with the period before. Which pages lost clicks, and for which searches?" | View only (Search Console must be connected) |
| Edit an article | "Propose a clearer opening for this draft. Keep its facts, table and sources. Show me before applying." | Manage |
| Add a feed | "Create a keyword feed for these seed keywords and competitors. Tell me the weekly refresh cost before starting." | Manage |
| Track AI visibility | "Suggest buyer questions for my brand. Show the cost, then add the three I choose." | Manage |
| Install the SEO Agent | "Get my SEO Agent script and the WordPress guide. Add it to my website, then check it's installed." | Manage (and an assistant that can edit your website) |
| Start a campaign | "Use my managed feed. Set up a weekly campaign with one article per batch, and wait for my review. Show the destination and recurring cost first." | Website changes and publishing |
| Fix a site issue | "Show the SEO Agent's ready fixes and their costs. Apply only the one I approve." | Website changes and publishing |
| Buy credits | "Create a one-time checkout for 500 credits. I'll pay on the secure page." | Account connections and billing |
How it works
- Your assistant only sees what you allowed. Tools for permissions you didn't grant are hidden from it.
- outwrite.ai checks every request. The same rules apply as in the dashboard: review settings, quality holds, your chosen destination and your credit balance.
- Paid work needs a spending cap. Before paid work, the assistant must tell outwrite.ai the most it may spend. If the real cost is higher, outwrite.ai refuses.
- Each assistant has a monthly credit limit. outwrite.ai refuses paid work that could take the assistant past the limit you chose, before anything starts.
- Repeating work needs two yeses. The connection must have Allow repeating work turned on, and before setting up anything that repeats (feeds, campaigns, AI visibility tracking), the assistant must confirm that you agreed to the schedule and the ongoing cost.
- Your AI app asks you, not outwrite.ai. Unlike Ask outwrite.ai, outwrite.ai shows no review card for a connected assistant. Most AI apps ask before running an action that changes something, depending on your app's settings. Only grant the permissions you're comfortable with.
- Text the assistant reads can't give it more access. Instructions hidden in an article, web page or prompt never count as your permission.
An assistant can never see your saved passwords or website logins, enter or see card details, sign in to Google or WordPress for you the first time, reach websites you didn't choose, or change its own permissions.
Costs
- Connecting is free, and so is reading your account.
- Paid actions cost the same credits as in the dashboard, for example writing an article or running AI visibility checks. See Credits and usage.
- Your AI app may have its own price. That's separate from outwrite.ai.
- Repeating work keeps running on its schedule, and keeps using credits, until you pause it. Disconnecting the assistant doesn't stop it.
How to tell it's working
- Ask your assistant to list your outwrite.ai workspaces. It should name your website.
- In outwrite.ai, open MCP connections. Under Connected assistants you'll see the app's name, the website, when it was last used and a permission label. Assistants that can spend credits also show the credits used this month, their monthly limit, when it resets and whether repeating work is allowed:
| Label | What it means |
|---|---|
| View only | The assistant can read but not change anything. |
| Manage workspace | The assistant can manage Pro work and spend credits. |
| Publishing under your policy | The assistant can also publish and change your website. |
| Not used yet | The connection is set up but the assistant hasn't made a request yet. |
When your assistant says something was "saved" or "queued", outwrite.ai has accepted it. Writing, website scans and publishing then finish in the background. Ask the assistant to check the final status, or look in the dashboard.
Change or remove access
- To change permissions, disconnect and reconnect outwrite.ai in your AI app (or run its sign-in again), then make new choices. The new choices replace that app's old connection.
- To change an assistant's monthly credit limit or Allow repeating work, open MCP connections and click Change limits next to it. No reconnecting needed. Turning repeating work off stops the assistant from starting new repeating work; work it already set up keeps running until you pause it.
- To remove access, open MCP connections and click Disconnect next to the assistant. If it can reach several websites, you'll be asked to confirm disconnecting it from all of them. You can disconnect even after your subscription ends.
- Disconnecting doesn't stop scheduled work. Campaigns, feeds and tracking the assistant set up keep running. Pause them in the dashboard.
- The list shows assistants for the website you're viewing. Switch websites in the sidebar to see the others. Switching websites never changes which websites an assistant can reach.
Common questions
Do I need to install or host anything?
No. outwrite.ai runs the connection. You only add the address to your AI app and sign in.
Is my connection URL private?
No. The address is the same for everyone. Your sign-in is what protects your account. Never share sign-in codes or tokens in a chat or support message.
My assistant says a tool is missing or not allowed. What do I do?
The assistant only sees tools for the permissions you granted. Reconnect and tick the box you need. Creating campaigns, for example, needs Allow website changes and publishing….
My assistant asks for a client ID, or says registration failed.
You don't need a client ID: your AI app registers itself with outwrite.ai when you connect. If it asks for one, leave it empty or choose automatic registration. If registration still fails, contact support and tell us which app you're connecting.
The sign-in page says the request is unavailable or expired.
Start the connection again from your AI app. Sign-in requests expire after a while.
My assistant says I need a subscription or a Pro workspace.
Connected assistants need an active trial or subscription, and the website must be in Pro. Fix this in outwrite.ai. MCP can't get around account access.
Can I connect more than one app?
Yes. Each app gets its own connection, permissions, monthly credit limit and Disconnect button.
My assistant says it reached its credit limit.
The assistant has committed its monthly credit limit, or the next action could go past it. Nothing was started. Raise the limit with Change limits in MCP connections, or wait until the limit resets on the 1st of the month (UTC).
Does giving Claude publishing permission change what Ask outwrite.ai can do?
No. Ask outwrite.ai and connected assistants have separate permissions.