Fospha MCP - Setup & Onboarding Guide

What is the Fospha MCP?

The Fospha MCP (Model Context Protocol) server lets you interact with your Fospha marketing data through natural language conversation inside AI assistants like Claude and ChatGPT. Instead of navigating dashboards and building reports manually, you can simply ask questions like:

• How is my brand performing this month?
• Which channels are driving the most revenue?
• Show me ROAS trends over the last 90 days.
• Where should I increase spend?

The MCP acts as a secure bridge between your AI assistant and your Fospha account, giving you instant access to performance summaries, channel breakdowns, campaign data, spend optimisation insights, attribution comparisons, and more — all through conversation.

---

 

Before You Get Started

Make sure you have the following in place:

• An active Fospha account — you must be fully onboarded with Fospha and have access to your data in the Fospha platform.
• A supported AI assistant account — Claude Pro, Max, Team, or Enterprise; or any ChatGPT plan (Free, Plus, Pro, Team, or Enterprise).
• Access to Claude.ai (web or mobile), Claude Desktop (macOS / Windows), or ChatGPT (web or app).

 

Which Server URL Should I Use?

Fospha operates two regional MCP servers. Use the one that matches your region. If you're unsure, check with your Fospha CSM before you begin.

Region	Server URL
🌍 EMEA & APAC	https://mcp.uk.fospha.com/mcp
🇺🇸 US	https://mcp.us.fospha.com/mcp

 

 

Setup on Claude.ai (Web & Mobile)

 Follow these steps to add the Fospha MCP as a custom connector in Claude's web interface.

PRO & MAX PLANS — Direct self-serve setup

1. Open claude.ai and sign in.
2. Click your profile icon in the bottom-left corner, then select Settings.
3. In the sidebar, click Connectors.
4. Scroll to the bottom and click the "+" button or "Add custom connector".
5. In the dialog that appears:
   • Name: Enter Fospha
   • URL: Paste your regional server URL. Leave Advanced settings (OAuth Client ID and Secret) empty — auth is handled automatically when you log in.
6. Click Add.
7. Click Connect. A browser window will open — log in with your Fospha credentials (SSO or email + password).
8. Once authorised, the connector status shows as Connected.

TEAM & ENTERPRISE PLANS — Admin-added, team-connected

On Team and Enterprise plans, only an Owner or Primary Owner can add a custom connector to the organisation. Once added, individual members can connect to it.

Owner setup:

1. Navigate to Organisation Settings → Connectors.
2. Click Add.
3. Enter the connector name (Fospha) and the appropriate server URL.
4. Leave Advanced settings empty and click Add.

Team member setup:

1. Go to Settings → Connectors.
2. Find the Fospha connector in the list (it will have a "Custom" label).
3. Click Connect and log in with your Fospha credentials.

---

Setup on Claude Desktop

Claude Desktop supports remote MCP connectors. Add Fospha either through Settings or directly from a chat window.

TEAM & ENTERPRISE PLANS

As with the web, only an Owner or Primary Owner can add the connector first.

Owner setup:

1. Open Claude Desktop and sign in with an Owner account.
2. Go to Settings → Organisation Settings → Connectors.
3. Click Add.
4. Enter the connector name (Fospha) and the regional server URL.
5. Leave Advanced settings empty and click Add.

Team member setup:

1. Open Claude Desktop and sign in.
2. Go to Settings → Connectors.
3. Find the Fospha connector (it will have a "Custom" label).
4. Click Connect and log in with your Fospha credentials (SSO or email + password).

PRO & MAX PLANS

You can add the connector directly yourself using either method.

Option A · Via Settings:

1. Open Claude Desktop and sign in.
2. Click your profile icon and select Settings. In the sidebar, click Connectors.
3. Click Add custom connector.
4. Enter the connector name (Fospha) and paste your regional server URL.
5. Leave Advanced settings empty and click Add.
6. Click Connect and log in with your Fospha credentials.

Option B · Via the chat window:

1. Open a new chat in Claude Desktop.
2. Click the "+" button at the bottom of the chat. Select Connectors → Manage Connectors. Click Add custom connector.
3. Enter the connector name (Fospha) and paste your regional server URL.
4. Leave Advanced settings empty and click Add.
5. Click Connect and log in with your Fospha credentials.

---

Setup on ChatGPT

This section covers Free, Plus, Pro, Team, and Enterprise ChatGPT plans. Follow the section that matches your plan.

Which plan do I have?

1. Open chatgpt.com and sign in.
2. Click your name or profile icon in the bottom-left corner of the sidebar.
3. The label next to your name tells you your plan — e.g. Free, Plus, Pro, or your workspace name on Team/Enterprise.
4. You can also go to Settings → My plan to confirm

FREE PLAN

ChatGPT allows Free users to add custom MCP connectors at no cost. You do not need a paid subscription to connect Fospha. You first need to enable Developer mode, which unlocks the ability to create a custom app.

1. Go to chatgpt.com and sign in.
2. Click your profile icon or name in the bottom-left corner and select Settings.
3. Click the Apps tab, then Advanced settings.
4. Toggle Developer mode on.
5. Go back to the Apps tab. You will now see a Create app button — click it.
6. Enter the connector details:
   • Name: Fospha
   • URL: Paste your regional server URL.
7. Leave any OAuth / Advanced fields blank — authentication is handled automatically when you log in.
8. Click Create.
9. Click Connect. A browser window will open — sign in with your Fospha credentials (SSO or email + password).
10. Once authorised, the connector status will show as Connected.

PLUS & PRO PLANS

The steps for Plus and Pro follow the same Developer mode flow as Free. Individual users add the connector themselves — no admin approval is needed.

1. Go to chatgpt.com and sign in.
2. Click your profile icon or name in the bottom-left corner and select Settings.
3. Click the Apps tab, then Advanced settings.
4. Toggle Developer mode on.
5. Go back to the Apps tab and click Create app.
6. Enter the connector details:
   • Name: Fospha
   • URL: Paste your regional server URL.
7. Leave any OAuth / Advanced fields blank.
8. Click Create.
9. Click Connect and sign in to Fospha when the browser window opens.
10. The connector status will show as Connected once authorised. 

TEAM PLAN

On a Team plan, connectors are managed at the workspace level. An admin must add the Fospha connector to the workspace first before individual members can connect to it.

Admin setup (do this first):

1. Sign in to chatgpt.com as a workspace admin or owner.
2. Open Settings → Workspace settings (or Admin settings).
3. Go to the Apps section and click Create (admins see this button directly without needing Developer mode).
4. Enter the connector details:
   • Name: Fospha
   • URL: Paste the appropriate regional server URL.
5. Leave any OAuth / Advanced fields blank.
6. Click Create, then publish the connector to the workspace so team members can see and use it.

Team member setup:

1. Sign in to chatgpt.com and go to Settings → Apps.
2. Find Fospha in the list and click Connect.
3. Sign in with your Fospha credentials when the browser window opens.
4. Once authorised, the status will show as Connected.

ENTERPRISE PLAN

Enterprise accounts have advanced admin controls. The connector setup is managed centrally by your IT or security administrator.

Admin setup:

1. Sign in to chatgpt.com with an Enterprise admin account.
2. Open the Admin console (profile → Admin settings).
3. Navigate to Apps (or Connectors) and click Create.
4. Enter the connector details:
   • Name: Fospha
   • URL: Paste the appropriate regional server URL.
5. Leave any OAuth / Advanced fields blank.
6. Configure access permissions if required by your organisation's policy.
7. Click Create, then publish the connector to make it available to users in your workspace.

Individual user setup:

1. Sign in to chatgpt.com and go to Settings → Apps.
2. Find Fospha in the list, click Connect, and sign in with your Fospha credentials.
3. The connector status will show as Connected once authorised. 

Enabling Fospha in a Conversation (ChatGPT)

Once connected, you need to turn Fospha on for each conversation where you want to use it.

1. Open a new chat (or an existing one).
2. Click the + button or the tools icon at the bottom of the chat input box.
3. Select Connected apps from the menu.
4. Toggle Fospha on.
5. You're ready to ask questions about your data.

---

Verifying Your Connection

Once connected, start a new conversation with the Fospha connector enabled and try one of these prompts to confirm everything is working:

• What Fospha tools are available?
• How is my brand performing?
• Is my data up to date?

If you have access to multiple brands in Fospha, your AI assistant will ask you to pick one. If you only have one brand, it will be selected automatically.

---

Available Tools 

 The Fospha MCP provides the tools below. You don't need to know tool names to use them — just ask your question in natural language and your AI assistant will use the right tool.

Tool	What it does
Performance Summary	Overall performance totals — revenue, spend, ROAS, conversions, CPP, CAC, AOV — with period-over-period comparison.
Channel Breakdown	Performance split by channel group and source (e.g. Paid Social – Meta, Paid Search – Google).
Market Breakdown	Performance split by geographic market (e.g. UK, US, DE).
Campaign Drill-Down	Granular campaign, adset, or ad-level performance. Filter by campaign name, type, strategy, or objective (e.g. Prospecting vs Retargeting).
Spend Allocation	How your spend is distributed across channels, with share-of-wallet percentages.
Compare Periods	Compare any two time periods side by side — presets like "this month vs same month last year" or custom date ranges. Returns % and absolute changes across all KPIs.
KPI Trends	Time-series data for any KPI at daily, weekly, or monthly granularity — ideal for spotting patterns and inflection points. Viewable at summary, channel, campaign, market, or spend-allocation level.
Attribution Comparison	Side-by-side comparison of three attribution models — Fospha, Last Click (GA), and Ad Platform — showing where they agree and disagree, with discrepancy percentages. Useful for identifying channels you're over- or under-crediting.
Beam — Spend Optimisation	Channel headroom (room to scale before diminishing returns), scaling status (Efficient, Cautious, Inefficient, Exploratory), saturation points, saturation curves, and campaign-level efficiency.
Beam — Spend Forecasting	Predicts what would happen if you changed daily spend on a specific channel. Set a target daily spend and see forecasted ROAS, CPP, or CAC — model "what if" scenarios before committing budget.
Annotations	Log, view, and update business events like sales, product launches, campaign launches, and seasonal peaks. Automatically surfaced alongside performance data to help explain metric movements.
Targets	Returns your ROAS, CAC, or CPP targets by paid or blended media, overall or per market.
Custom Metrics	Lists any custom formula-based metrics your team has configured (e.g. Blended ROAS, Revenue per Visit). Once discovered, they can be included in performance data, trends, and period comparisons.
Filter Options	Shows all available filter values for your account — markets, channels, sources, campaign types, campaign names, and more.
Data Freshness	Checks when your data was last updated and flags any gaps or unmodelled date ranges.
Fospha Intro	Returns a guide to all available tools, parameters, and recommended workflows. Ask "What can Fospha do?" to see it.

---

 Starter Prompts  

Here are some questions you can ask once you're connected. Mix and match — your AI assistant picks the right tool automatically.

Overall Performance

• How is my brand performing this month vs last month?
• What's my overall ROAS for the last 30 days?

Channel Insights

• Which channels are driving the most revenue?
• Show me Paid Social performance for the UK market.

Campaign Deep-Dives

• Show me my top 10 campaigns by spend.
• How are my Prospecting campaigns performing vs Retargeting?

Spend Optimisation

• Which channels have headroom to scale?
• If I increase daily spend on Meta to £5,000, what ROAS can I expect?
• Which channels are saturated?

Attribution

• What does Meta report my ROAS as vs what Fospha says?
• Which channels am I over-crediting because Last Click flatters them?

Trends & Comparisons

• Show me weekly revenue trends for the last 90 days.
• Compare this quarter to the same quarter last year.
• How does my ROAS this week compare to the same week last year?

Data Management

• Is my data up to date?
• What annotations do I have for March?
• Log a new annotation for our Spring Sale (1st–14th April).

---

Tips for Best Results

• Just ask naturally — you don't need to know tool names or parameters. Your AI assistant will figure out the right tool to use.
• Be specific with time periods — saying "last 30 days" or "this month vs last year" helps pull the right comparison.
• Specify markets or channels when relevant — if you want UK-only data or just Paid Social, say so.
• Ask follow-up questions — your AI assistant remembers context within a conversation, so you can drill down from a summary into a specific channel or campaign.
• Amazon sales are excluded by default — if you want to include Amazon, mention it in your question.
• ChatGPT Pro users — stick to GPT-4o when querying Fospha data for the most reliable results. 

---

 Troubleshooting

Claude

Issue	What to do
"Connection failed" when adding the connector	Double-check the server URL matches your region exactly and includes https://.
Login window doesn't appear	Clear your browser cache or use an incognito window. On Desktop, try removing and re-adding the connector.
"No clients found" when asking a question	Your Fospha account may not be fully onboarded yet. Contact your CSM.
Data looks stale or missing	Ask "Is my data up to date?" to check freshness. If there are gaps, contact your CSM.
Claude doesn't use Fospha tools	Make sure the Fospha connector is toggled on for the current conversation (click • → Connectors).

 ChatGPT

Issue	What to do
"Connection failed" when adding the connector	Double-check the server URL matches your region exactly and includes https://.
Login window does not appear	Clear your browser cache, or try an incognito window. On the mobile app, try removing and re-adding the connector.
"No clients found" when asking a question	Your Fospha account may not be fully onboarded yet. Contact your CSM.
Data looks stale or missing	Ask "Is my data up to date?" to check freshness. If there are gaps, contact your CSM.
ChatGPT does not use Fospha tools	Make sure the Fospha app is toggled on for the current conversation (click + → Connected apps → toggle Fospha on).
Can't see the "Create app" button (Free plan)	You need to enable Developer mode first — Settings → Apps → Advanced settings → toggle Developer mode on.
Can't see the Fospha app in Settings (Team plan)	Your workspace admin needs to create and publish the Fospha connector at the workspace level first.
Connection blocked by company policy (Enterprise)	Your IT team may need to whitelist mcp.us.fospha.com or mcp.uk.fospha.com. Contact your Fospha CSM for assistance.
Fospha doesn't appear when I search the connector directory	Fospha won't show up in the Anthropic & Partners directory — that catalogue is for Anthropic-vetted integrations only. Fospha is a custom connector and must be added manually: Settings → Connectors → scroll to bottom → Add custom connector. Do not search the directory.

---

Need Help?

If you run into any issues or have questions about the Fospha MCP, please reach out to your Fospha Customer Success Manager (CSM). They can help with onboarding, access issues, data questions, and anything else you need. 

---

 Data Privacy FAQs

Does the AI model provider (e.g. Anthropic, OpenAI) store or train on my data?

No. The Fospha MCP runs on commercial API tiers which have explicit contractual commitments: your data is not used for model training, and is not retained beyond the conversation session. Once a conversation ends, the data is gone.

What data does the AI model actually see?

Only the specific data returned by a given query — for example, a channel-level performance summary for a date range you request. It does not have access to your full dataset, raw logs, or any data beyond what's needed to answer your question in that moment.

Who controls what data is exposed?

Fospha does. The MCP server is built and managed by Fospha. We define exactly which tools are available and what data each tool can return. Nothing is sent to the AI model unless a query explicitly requests it.

Does using MCP create a new data exposure risk?

No. The MCP does not give an AI model any access your users don't already have. If a user can view a channel performance summary in the Fospha dashboard, they could already copy that data into any AI tool, email, or spreadsheet. The difference is that MCP makes this interaction governed: Fospha controls which data points are available, at what granularity, and with what account scoping. There is no new category of data access — it's the same data, delivered through a controlled API rather than uncontrolled copy-paste.

Is my data shared with other clients?

No. The AI accesses Fospha using your account. It sees your data and nothing else — exactly the same boundary as your dashboard login.

Is data sent in bulk or stored on the AI model provider's infrastructure?

No. Data is fetched on-demand, per query, in real time. There is no bulk upload, no persistent copy, and no data sitting in the provider's systems between sessions.

Can I stop my AI provider from training on my conversations?

Yes. If you're using a consumer plan (e.g. Claude Free/Pro or ChatGPT Free/Plus), your conversations may be used for model training by default — but both providers offer a simple toggle to opt out:

• Claude (Anthropic): Settings → Privacy → turn off "Help improve Claude"
• ChatGPT (OpenAI): Settings → Data Controls → turn off "Improve the model for everyone"

Note: The Fospha MCP connects via commercial API tiers, where training on inputs and outputs is already contractually excluded by default — no toggle needed. This opt-out is only relevant if you're also using these tools outside of the MCP on a personal plan.

Where can I read the data policies?

Fospha doesn't choose your AI provider — you do. The data handling commitments are between you and that provider, under their commercial API terms. You can read those here:

• Anthropic: https://www.anthropic.com/policies
• OpenAI: https://openai.com/policies/
• Google Cloud: https://cloud.google.com/terms